EnrichedSessionOutput

Session enriched with waste metrics and insights summary

  • applicationId
    Type: string Format: uuid
    required

    Application ID associated with this session

  • durationInSeconds
    Type: integer
    required

    Total duration of the session in seconds

  • endedAtTime
    Type: string Format: date-time
    required

    Timestamp when the session ended

  • id
    Type: string
    required

    Session identifier (caliper session ID)

  • insightsSummary
    Type: object · InsightsSummary
    required

    Summary of insights present in a session

    • insightCountsByType
      Type: array object[] · InsightCountByType[]
      required

      Per-insight-type breakdown of visible insight counts

      Count of visible insights for a single insight type

    • insightTypes
      Type: array string[] · InsightType[]
      required

      Distinct insight types present in the session

    • totalCount
      Type: integer
      required

      Total number of visible insights in the session

  • isProctored
    Type: boolean
    required

    Whether this session is proctored

  • recordingEndedAtTime
    Type: string | null Format: date-time
    required

    Timestamp when the recording ended

  • recordingS3Key
    Type: string | null
    required

    S3 key for the associated proctoring recording

  • recordingStartedAtTime
    Type: string | null Format: date-time
    required

    Timestamp when the recording started

  • startedAtTime
    Type: string Format: date-time
    required

    Timestamp when the session started

  • subject
    Type: string | null · SessionSubjectenum
    required

    Academic subject attributed to this learning session. Null means not yet decided (no vision-end upsert). Unknown is an explicit value meaning looked and could not say. Values: Reading, Language, Vocabulary, Social Studies, Writing, Science, FastMath, Math, Unknown.

    values
    • Reading
    • Language
    • Vocabulary
    • Social Studies
    • Writing
    • Science
    • FastMath
    • Math
    • Unknown
  • subjectSource
    Type: string | null · SessionSubjectSourceenum
    required

    How subject was decided: app (single-subject LTI application shortcut), journal (vision journal classification), or none (fallback Unknown). Null when subject is null.

    values
    • app
    • journal
    • none
  • userId
    Type: string Format: uuid
    required

    User ID associated with this session

  • wasteDurationInSeconds
    Type: integer
    required

    Total waste duration of the session in seconds

  • wastePercentage
    Type: integer
    required

    Percentage of session time that was waste (0-100)

  • webcamEnabled
    Type: boolean
    required

    Whether the webcam was enabled for this session

  • enforcementSummary
    Type: object

    Popup and enforcement summary for the session. Present for proctored sessions and for any session with popup history (presentation ledger rows); omitted otherwise. Counts cover popups shown to the student — an offer superseded before display is not counted.

    • autoStopped
      Type: boolean
      required

      Whether the session was automatically stopped (a forced-end enforcement event exists)

    • notificationCount
      Type: integer
      required

      Number of NOTIFY popups shown during the session. Zero for pre-cutover sessions with no presentation ledger.

    • warningCount
      Type: integer
      required

      Number of ENFORCE warning popups shown during the session, excluding terminal suspensions. For sessions with no presentation ledger, falls back to the legacy distinct-warning-event count (a warning that both accrued a strike and was confirmed as displayed counts once).

  • metadata
    Type: object | null · InsightsSessionMetadata

    Opaque session metadata object

    • propertyName
      Type: anything