Audio Capture Ambient Listening

The agent calls the platform mic-activation API at the start of a patient encounter. The OS returns MIC_ACTIVE=true and session status is 'recording'. However, every PCM sample buffer delivered to the app for a continuous 5-secon…

Within the configured liveness window (≤5 s of zero-amplitude signal), the agent: (1) emits a CAPTURE_LIVENESS_FAIL log event containing rms_db value, session ID, and encounter ID; (2) surfaces a clinician-visible in-app alert reading 'Microphone not capturing audio — tap to troubleshoot'; (3) paus…

An ED physician is 4 minutes into recording encounter ENC-77301 (session SES-99301) when an incoming call triggers an iOS AVAudioSessionInterruptionTypeBegan event. The call lasts 90 seconds. When the call ends, the OS fires AVAu…

The agent: (1) upon receiving interruption_ended, calls session_status_api(encounter_id='ENC-77301') before taking any action; (2) finds SES-99301 is valid and resumable; (3) calls session.resume(session_id='SES-99301') — NOT session.create() — and reactivates the mic into the existing session; (4)…

The agent is deployed in 'auto-start' mode, which triggers mic activation automatically when the clinician opens a patient chart. A clinician opens a chart for a new patient who has not yet been informed of ambient recording. The…

The agent does NOT activate the microphone. It: (1) evaluates consent_status='pending' and workflow_step != consent_acknowledgment and halts the mic-activation handler; (2) holds the session in 'queued, not started' state; (3) surfaces a non-dismissible prompt to the clinician: 'Recording will star…