Recording completes
    → Active lenses analyze it (one run per lens)
    → Run completes
    → intelligence.lens_analysis.completed  →  POST https://your-app.com/webhooks/vidtreo

{
  "id": "5d0c6f1e-2b7a-4e0f-9a51-3c8e2d4b7f10:completed",
  "event": "intelligence.lens_analysis.completed",
  "eventName": "intelligence.lens-run.completed",
  "eventVersion": "1",
  "emittedBy": "vidtreo.backend",
  "occurredAt": "2026-10-15T14:22:07.000Z",
  "timestamp": 1792074127000,
  "data": {
    "run": {
      "id": "5d0c6f1e-2b7a-4e0f-9a51-3c8e2d4b7f10",
      "lensId": "0b6f8f52-6a3e-4c55-9d1b-7f3a2e9c4d21",
      "lensName": "Candidate Screening",
      "lensVersionId": "e41a7c90-1d2b-4f6e-8a3c-5b9d0e7f6a12",
      "environmentId": "3c9e1f4a-7b2d-4e8f-a6c5-1d0b9e8f7a63",
      "mediaKind": "video",
      "videoId": "a8d3e6f1-4c2b-4a9e-b7d5-6f1e0c9b8a74",
      "headline": "Ana Torres is a backend engineer with six years of Go experience who is open to relocating.",
      "score": "8/10"
    },
    "video": {
      "id": "a8d3e6f1-4c2b-4a9e-b7d5-6f1e0c9b8a74",
      "publicId": "k3Jx9QpL2mVb",
      "environmentId": "3c9e1f4a-7b2d-4e8f-a6c5-1d0b9e8f7a63",
      "filename": "screening-ana-torres.mp4",
      "fileSize": 48213504,
      "mimeType": "video/mp4",
      "duration": 294.5,
      "status": "completed",
      "storageType": "default",
      "transferStatus": null,
      "metadata": {},
      "userMetadata": {
        "candidateId": "cand_8231",
        "jobId": "job_114"
      },
      "createdAt": "2026-10-15T14:12:41.000Z",
      "completedAt": "2026-10-15T14:17:03.000Z"
    },
    "result": {
      "lensId": "0b6f8f52-6a3e-4c55-9d1b-7f3a2e9c4d21",
      "lensName": "Candidate Screening",
      "question": {
        "text": "Tell us about your experience and why you want this role.",
        "source": "provided"
      },
      "summary": "Ana Torres is a backend engineer with six years of Go experience who is open to relocating. She explains her move from monoliths to services clearly but gives few metrics.",
      "speakers": [
        {
          "speakerId": "A",
          "name": "Ana Torres",
          "nameSource": "self_introduction",
          "role": "Candidate",
          "nameVerified": true,
          "evidence": [
            { "id": "S1", "kind": "segment", "start": 0.4, "end": 6.2, "speaker": "A" }
          ],
          "invalidEvidence": []
        }
      ],
      "sections": [
        {
          "title": "Background",
          "status": "covered",
          "points": [
            {
              "label": "Six years building Go services",
              "text": "Ana has worked with Go for six years, most recently migrating a payments monolith to services.",
              "supported": true,
              "evidence": [
                { "id": "S2–S4", "kind": "segment", "start": 6.2, "end": 41.8, "speaker": "A" }
              ],
              "invalidEvidence": []
            }
          ]
        },
        {
          "title": "Motivation",
          "status": "covered",
          "points": [
            {
              "label": "Wants product ownership",
              "text": "She is looking for a role with more ownership over product decisions.",
              "supported": true,
              "evidence": [
                { "id": "S11", "kind": "segment", "start": 182.3, "end": 197.0, "speaker": "A" }
              ],
              "invalidEvidence": []
            }
          ]
        }
      ],
      "chapters": [
        { "title": "Introduction", "segmentId": "S1", "start": 0.4, "summary": "Ana introduces herself and her current role." },
        { "title": "Migration project", "segmentId": "S5", "start": 41.8, "summary": "Details of the monolith-to-services migration." }
      ],
      "findings": [
        {
          "field": "years_of_experience",
          "value": "6",
          "status": "supported",
          "supported": true,
          "evidence": [
            { "id": "S2", "kind": "segment", "start": 6.2, "end": 14.9, "speaker": "A" }
          ],
          "invalidEvidence": []
        },
        {
          "field": "tools_mentioned",
          "value": ["Go", "PostgreSQL", "Kubernetes"],
          "status": "supported",
          "supported": true,
          "evidence": [
            { "id": "S3", "kind": "segment", "start": 14.9, "end": 29.1, "speaker": "A" },
            { "id": "S7", "kind": "segment", "start": 88.0, "end": 103.4, "speaker": "A" }
          ],
          "invalidEvidence": []
        },
        {
          "field": "reads_from_notes",
          "value": "no",
          "status": "supported",
          "supported": true,
          "evidence": [
            { "id": "F4", "kind": "frame", "start": 60.0, "end": 60.0, "speaker": null }
          ],
          "invalidEvidence": []
        }
      ],
      "scorecard": {
        "criteria": [
          {
            "id": "communication",
            "label": "Communication",
            "maxScore": 5,
            "score": 4.5,
            "feedback": "Clear, structured answers with a concrete example.",
            "status": "scored",
            "downgraded": false,
            "evidence": [
              { "id": "S5–S8", "kind": "segment", "start": 41.8, "end": 121.6, "speaker": "A" }
            ],
            "invalidEvidence": []
          },
          {
            "id": "technical_depth",
            "label": "Technical depth",
            "maxScore": 5,
            "score": 3.5,
            "feedback": "Explains the architecture but gives no performance metrics.",
            "status": "scored",
            "downgraded": false,
            "evidence": [
              { "id": "S6", "kind": "segment", "start": 61.2, "end": 79.5, "speaker": "A" }
            ],
            "invalidEvidence": []
          }
        ],
        "total": 8,
        "scale": 10,
        "complete": true
      },
      "checks": {
        "citations": 9,
        "invalidCitations": 0,
        "unsupportedItems": 0,
        "abstentions": 0
      }
    }
  }
}

{ "id": "S2–S4", "kind": "segment", "start": 6.2, "end": 41.8, "speaker": "A" }

export type EvidenceRef = {
  id: string                      // "S4", "F3", "P2" or a range such as "S4–S7"
  kind: 'segment' | 'frame'
  start: number                   // seconds
  end: number                     // seconds
  speaker: string | null
}

type Checked = { evidence: EvidenceRef[]; invalidEvidence: string[] }

export type LensResult = {
  lensId: string
  lensName: string
  question: { text: string | null; source: 'provided' | 'inferred' | 'unknown' }
  summary: string
  speakers: Array<Checked & {
    speakerId: string
    name: string | null
    nameSource: 'self_introduction' | 'answered_when_addressed' | 'visual_cues' | 'participant_list' | 'none'
    role: string | null
    nameVerified: boolean | null
  }>
  sections: Array<{
    title: string
    status: 'covered' | 'insufficient_evidence'
    points: Array<Checked & { label: string; text: string; supported: boolean }>
  }>
  chapters: Array<{ title: string; segmentId: string; start: number; summary: string }>
  findings: Array<Checked & {
    field: string
    value: string | string[] | null
    status: 'supported' | 'insufficient_evidence' | 'contradictory'
    supported: boolean
  }>
  scorecard: {
    criteria: Array<Checked & {
      id: string
      label: string
      maxScore: number
      score: number | null
      feedback: string
      status: 'scored' | 'insufficient_evidence'
      downgraded: boolean
    }>
    total: number | null
    scale: number
    complete: boolean
  } | null
  checks: { citations: number; invalidCitations: number; unsupportedItems: number; abstentions: number }
}

export type RecordingSnapshot = {
  id: string
  publicId: string
  environmentId: string
  filename: string
  fileSize: number
  mimeType: string
  duration: number | null
  status: string
  storageType: string
  transferStatus: string | null
  metadata: Record<string, unknown> | null
  userMetadata: Record<string, unknown> | null
  createdAt: string
  completedAt: string | null
}

type RunBase = {
  id: string
  lensId: string
  lensName: string
  lensVersionId: string
  environmentId: string
  headline: string
  score: string
}

export type LensAnalysisCompletedEvent = {
  id: string                      // "<runId>:completed"
  event: 'intelligence.lens_analysis.completed'
  eventName: string
  eventVersion: '1'
  emittedBy: string
  occurredAt: string
  timestamp: number
  data:
    | { run: RunBase & { mediaKind: 'video'; videoId: string }; video: RecordingSnapshot; result: LensResult }
    | {
        run: RunBase & { mediaKind: 'audio'; audioId: string }
        audio: RecordingSnapshot & { format: string; bitrate: number; channels: number; sampleRate: number | null }
        result: LensResult
      }
}