Studio · Yemaya · Voice/Video Communication

Purpose#

Admin lane console wired to the @yemaya/av-sync timing/DSP primitives: diagnose a session's audio/video alignment — clock drift, audio frame duration, signal level (dB), and jitter-buffer depth — from the session's timing parameters.

Entry points#

• Studio index quick-actions.
• No breadcrumb panel on this page.
• This page links out to /studio/yemaya/cursor-and-selection-sharing.
• Embedded as a lane inside /studio/yemaya/studio-desktop.
• Direct URL / bookmark (signed-in + studio entitlement).

Layout regions#

page.tsx renders ShellLayout active="studio" and:

• Workspace panel (StudioYemayaVoiceVideoCommunicationWorkspace, data-yemaya-voice-video-communication-workspace):
  • <h1> "Yemaya Voice/Video Communication Workspace".
  • Summary <p data-yemaya-voice-video-communication-summary> (diagnose A/V alignment with the real av-sync timing engine).
  • Diagnose lane — loading / unauthorized / error / ready-form / result.
• Route Map panel (data-yemaya-voice-video-communication-route-map): <h2> "Route Map" with five entries.
• Quick-action panel: two quickAction links.

States#

• Loading — data-yemaya-vvc-loading ("Loading diagnostics…").
• Unauthorized — 401/403 → data-yemaya-vvc-unauthorized with reason "Yemaya workspace scope required to view voice/video communication.".
• Error — non-OK / malformed catalog → data-yemaya-vvc-error.
• Ready-form — catalog (metrics) loaded; the diagnose form renders.
• Result — 200 → data-yemaya-vvc-result with data-yemaya-vvc-drift, data-yemaya-vvc-frame, data-yemaya-vvc-db, data-yemaya-vvc-buffer.
• Validation error — non-finite timing fields or non-numeric frame times, or a non-200 POST → data-yemaya-vvc-diagnose-error.

Interactions#

Diagnose lane#

<form data-yemaya-vvc-diagnose-form> — each <input data-yemaya-vvc-field={key}> (aria-label = field label):

• Audio time (s) — audioTime.
• Video time (s) — videoTime.
• Sample rate (Hz) — sampleRate.
• Samples / frame — samplesPerFrame.
• Amplitude (0–1) — amplitude.
• Buffered frame presentation times — frames (comma/space separated).
• "Run diagnostics" submit (data-yemaya-vvc-diagnose-submit) — POSTs { audioTime, videoTime, sampleRate, samplesPerFrame, amplitude, frames? }.

Route map#

data-yemaya-voice-video-communication-route-map — five entries:

• /studio/yemaya/voice-video-communication
• /studio/yemaya/voice-video-communication/scenes/[sceneId]
• /studio/yemaya/voice-video-communication/exports/[exportId]
• /studio/yemaya/voice-video-communication/revisions/[revisionId]
• /studio/yemaya/voice-video-communication/governance/[policyId]

Quick actions#

• "Open Yemaya Cursor and Selection Sharing workspace" → /studio/yemaya/cursor-and-selection-sharing.
• "Back to Studio workspace index" → /studio.

Data & contracts#

• Reads: GET /v1/admin/yemaya/voice-video-communication (catalog; metrics) on mount with buildBffAuthHeaders(), cache: 'no-store'.
• Writes: POST /v1/admin/yemaya/voice-video-communication/diagnose → { diagnostics: { driftSeconds, frameDurationSeconds, amplitudeDb, bufferDurationSeconds } }.
• Realtime: None.
• Caching: client fetch on mount, no-store; aborted on unmount.
• Auth/role check: admin-scoped, fail-closed; route additionally signed-in + studio via the proxy gate.

Cross-references#

• Workspace source: apps/oshun/web/src/components/studio/StudioYemayaVoiceVideoCommunicationWorkspace.tsx
• Route map source: apps/oshun/web/src/components/studio/StudioYemayaVoiceVideoCommunicationRouteMap.ts
• Page source: apps/oshun/web/src/app/studio/yemaya/voice-video-communication/page.tsx
• Embedded in: studio-yemaya-studio-desktop.md
• Studio overview: studio-overview.md
• Feature spec: V1/features.md

Open questions / known gaps#

• The lane diagnoses from manually-entered timing values; confirm whether a live-session capture path (reading real av-sync telemetry) is planned.
• Route-map children (scenes/exports/revisions/governance) are a sitemap contract; confirm which dynamic pages exist.