Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt

Use this file to discover all available pages before exploring further.

The Session Detail screen is the ambient review page for a single AI-generated ambient session, accessed at /cl/ambient-review/:sessionId.

​
Overview

The page loads session data via useAmbientSessionDetail, transcript via useAmbientTranscript, and audit events via useAmbientSessionEvents, all scoped to the current organization. The breadcrumb label is set to Session <first 8 chars of ID>. When a transcript is present, parseSOAPSections extracts Subjective, Objective, Assessment, and Plan sections displayed in a SOAP Draft card. A Raw Transcript card shows the raw text, confidence score, and word count. For sessions in draft_ready status, users with cl.ambient.approve see Approve & Generate Note and Reject action buttons. Approving calls useApproveAmbientSession; rejecting calls useCancelAmbientSession. A Session Timeline card renders an ordered event list from cl_ambient_session_events when events are present.

​
Who it’s for

Requires permission cl.ambient.view (enforced by both the route and PermissionGate). The Approve & Generate Note and Reject action buttons additionally require cl.ambient.approve.

​
Before you start

  • You must have cl.ambient.view.
  • The session must exist in cl_ambient_sessions and be accessible to your organization.
  • To take approve/reject actions, you must additionally have cl.ambient.approve and the session must be in draft_ready status.

​
Steps

1

Open the session

Navigate to /cl/ambient-review, then click a session in the review queue. The detail page loads session metadata, SOAP draft, transcript, and audit timeline.
2

Review the SOAP draft

If a transcript exists, the SOAP Draft card shows AI-generated Subjective, Objective, Assessment, and Plan sections from parseSOAPSections.
3

Review the raw transcript

The Raw Transcript card shows raw text alongside the confidence_score (as a percentage) and word_count from the transcript record.
4

Approve the session (approver only)

If the session is draft_ready and you have cl.ambient.approve, click Approve & Generate Note. A success toast confirms “Session approved and note generated.”
5

Reject the session (approver only)

If the session is draft_ready and you have cl.ambient.approve, click Reject to cancel the session. A success toast confirms “Session rejected.”
6

Review the audit timeline

If session events exist in cl_ambient_session_events, the Session Timeline card shows each event type, optional reason, and timestamp.

​
Key concepts

Sessions progress through: recording → processing → draft_ready → approved (or cancelled/failed). Approve and reject actions are only available in draft_ready status. The current status is shown as a badge using AMBIENT_STATUS_LABELS.
The SOAP Draft card shows Subjective, Objective, Assessment, and Plan extracted by parseSOAPSections from the transcript record. Empty sections display as ”—”.
confidence_score is stored on cl_ambient_transcripts as a decimal (0–1) and displayed as a percentage. word_count is also shown.
  • Session not found or access denied: card with centered “Session not found or access denied.”
  • No SOAP sections: the SOAP Draft card is not rendered.
  • No transcript: the Raw Transcript card is not rendered.
  • No audit events: the Session Timeline card is not rendered.
  • Loading: DetailSkeleton with header and two grid skeletons.

Clinical

Overview of the Clinical core.

Governance & parity

Documentation coverage and governance.
This page documents shipped product behavior. It is not medical, legal, or billing advice. Verify against your organization’s policies and applicable regulations before using it for clinical, compliance, or billing decisions. Protected health information (PHI) shown in the product is governed by your tenant’s access controls and is never exposed in this documentation.
  • src/routes/cl.tsx
  • src/cores/cl/pages/AmbientReviewDetailPage.tsx
  • src/cores/cl/ai-documentation/hooks/useAmbientSession.ts
  • src/cores/cl/ai-documentation/hooks/useAmbientTranscript.ts
  • src/cores/cl/ai-documentation/types/ambient.ts