feat(voice): realtime ElevenLabs voice agent alongside classic path

app/.env.example

@@ -91,6 +91,16 @@ VITE_DEV_FORCE_ONBOARDING=false
 # Set to false to hide the toggle for a build (kill-switch).
 # VITE_VOICE_MODE=false
 
+# [optional] Human tab voice entry point (#5399). Enabled by default: the chat
+# card shows the realtime "Start voice chat" control in the slot the classic
+# push-to-talk mic used to occupy. Set to false to fall back to tap-and-speak.
+# VITE_HUMAN_VOICE_REALTIME=false
+
+# [optional] Show BOTH Human-tab voice controls (realtime + tap-and-speak),
+# stacked. Off by default — for comparing the two paths, not for shipping.
+# Takes precedence over VITE_HUMAN_VOICE_REALTIME.
+# VITE_HUMAN_VOICE_SHOW_BOTH=true
+
 # [optional] Client-side timeout for skill callTool/triggerSync (seconds; default 120, max 3600).
 # Should match OPENHUMAN_TOOL_TIMEOUT_SECS on the core when set.
 # VITE_TOOL_TIMEOUT_SECS=

app/src/components/settings/panels/VoicePanel.tsx

@@ -17,9 +17,6 @@ import {
   type VoiceProviderView,
   type VoiceSettings,
 } from '../../../services/api/voiceSettingsApi';
-import { useAppDispatch, useAppSelector } from '../../../store/hooks';
-import { selectVoiceMode, setVoiceMode } from '../../../store/mascotSlice';
-import { VOICE_MODE_FLAG_ENABLED } from '../../../utils/config';
 import {
   openhumanGetVoiceServerSettings,
   openhumanUpdateVoiceServerSettings,
@@ -102,8 +99,6 @@ interface VoicePanelProps {
 
 const VoicePanel = ({ embedded = false }: VoicePanelProps = {}) => {
   const { t } = useT();
-  const dispatch = useAppDispatch();
-  const voiceMode = useAppSelector(selectVoiceMode);
   const { navigateBack, navigateToSettings } = useSettingsNavigation();
   const [settings, setSettings] = useState<VoiceServerSettings | null>(null);
   const [savedSettings, setSavedSettings] = useState<VoiceServerSettings | null>(null);
@@ -582,25 +577,8 @@ const VoicePanel = ({ embedded = false }: VoicePanelProps = {}) => {
           />
         </SettingsSection>
 
-        {/* ─── Realtime voice mode (beta, flag-gated) ──────────────────── */}
-        {VOICE_MODE_FLAG_ENABLED && (
-          <SettingsSection title={t('voice.mode.title')} description={t('voice.mode.desc')}>
-            <SettingsRow
-              htmlFor="voice-mode-realtime"
-              label={t('voice.mode.realtime')}
-              description={t('voice.mode.realtimeDesc')}
-              control={
-                <SettingsSwitch
-                  id="voice-mode-realtime"
-                  data-testid="voice-mode-realtime-toggle"
-                  checked={voiceMode === 'realtime'}
-                  onCheckedChange={next => dispatch(setVoiceMode(next ? 'realtime' : 'classic'))}
-                  aria-label={t('voice.mode.realtime')}
-                />
-              }
-            />
-          </SettingsSection>
-        )}
+        {/* Realtime voice is always on now — its controls live on the Human tab,
+            so the former flag-gated toggle here was removed. */}
 
         {/* ─── Section 1: Voice Provider Chips ─────────────────────────── */}
         {/* Provider chips are intentional bespoke UI — kept as-is. */}

app/src/features/conversations/Conversations.tsx

@@ -1,6 +1,6 @@
 import { convertFileSrc } from '@tauri-apps/api/core';
 import debugFactory from 'debug';
-import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { type ReactNode, useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { useLocation, useNavigate, useParams } from 'react-router-dom';
 
 import { type ChatSendError, chatSendError } from '../../chat/chatSendError';
@@ -150,6 +150,19 @@ interface ConversationsProps {
    * Used by the mascot tab so the only interaction is voice.
    */
   composer?: 'text' | 'mic-cloud';
+  /**
+   * Voice-chat control rendered in the `mic-cloud` composer slot, above the mic
+   * button. Passed in as a node rather than imported here so this component
+   * keeps no dependency on the realtime voice stack (and the ElevenLabs SDK
+   * stays out of every consumer's module graph). Ignored outside `mic-cloud`.
+   */
+  voiceChatControl?: ReactNode;
+  /**
+   * Whether the `mic-cloud` slot renders the push-to-talk mic composer. Default
+   * `true` — set `false` alongside {@link ConversationsProps.voiceChatControl}
+   * to replace tap-and-speak with the realtime control rather than stack them.
+   */
+  showMicComposer?: boolean;
   /**
    * Project the thread list into the root sidebar's dynamic region even in the
    * `sidebar` variant. Page variant always projects it; this lets an embedded
@@ -248,6 +261,8 @@ export function deriveChatErrorBanner(
 const Conversations = ({
   variant = 'page',
   composer: composerProp = 'text',
+  voiceChatControl = null,
+  showMicComposer = true,
   projectThreadList = false,
 }: ConversationsProps = {}) => {
   const [composerOverride, setComposerOverride] = useState<'mic-cloud' | 'text' | null>(null);
@@ -2314,16 +2329,19 @@ const Conversations = ({
           // — this branch renders no ChatComposer to hang it off.
           <div className="relative flex flex-col items-center gap-3 py-1">
             {mascotDock}
-            <MicComposer
-              // Without `!selectedThreadId`, a mic submit before a thread is
-              // ready hits `handleSendMessage`'s early return and the
-              // transcript is silently dropped — the user spoke into the void.
-              disabled={composerInteractionBlocked || isSending || !selectedThreadId}
-              onSubmit={text => handleSendMessage(text)}
-              onError={message => setSendError(chatSendError('voice_transcription', message))}
-              showDeviceSelector
-              onSwitchToText={() => setComposerOverride('text')}
-            />
+            {voiceChatControl}
+            {showMicComposer && (
+              <MicComposer
+                // Without `!selectedThreadId`, a mic submit before a thread is
+                // ready hits `handleSendMessage`'s early return and the
+                // transcript is silently dropped — the user spoke into the void.
+                disabled={composerInteractionBlocked || isSending || !selectedThreadId}
+                onSubmit={text => handleSendMessage(text)}
+                onError={message => setSendError(chatSendError('voice_transcription', message))}
+                showDeviceSelector
+                onSwitchToText={() => setComposerOverride('text')}
+              />
+            )}
           </div>
         ) : inputMode === 'text' ? (
           <>