Voice-to-text dictation app with local (Nvidia Parakeet/Whisper) and cloud models (BYOK). Privacy-first and available cross-platform.
JavaScript aianthropiccross-platformgeminigroqlinuxmacosnvidiaopen-sourceopenaiparakeetspeech-to-texttranscribewhisperwindows
import { useCallback, useState } from "react";
import { useTranslation } from "react-i18next";
import { Monitor } from "../icons";
import { useSettingsStore } from "../../stores/settingsStore";
import {
isAgentAllowed,
isModeAllowedByPolicy,
isScreenContextAllowed,
} from "../../stores/policyRules";
import { usePolicyStore } from "../../stores/policyStore";
import { useAgentName } from "../../utils/agentName";
import { useDialogs } from "../../hooks/useDialogs";
import { useScreenRecordingPermission } from "../../hooks/useScreenRecordingPermission";
import { Toggle } from "../ui/toggle";
import { Input } from "../ui/input";
import { Button } from "../ui/button";
import { SettingsPanel, SettingsPanelRow, SettingsRow, SectionHeader } from "../ui/SettingsSection";
import PermissionCard from "../ui/PermissionCard";
import PromptStudio from "../ui/PromptStudio";
import InferenceConfigEditor from "./InferenceConfigEditor";
export default function DictationAgentSettings() {
const { t } = useTranslation();
const useDictationAgent = useSettingsStore((s) => s.useDictationAgent);
const setUseDictationAgent = useSettingsStore((s) => s.setUseDictationAgent);
const voiceAgentScreenContext = useSettingsStore((s) => s.voiceAgentScreenContext);
const setVoiceAgentScreenContext = useSettingsStore((s) => s.setVoiceAgentScreenContext);
const useDictationAgentVisionModel = useSettingsStore((s) => s.useDictationAgentVisionModel);
const setUseDictationAgentVisionModel = useSettingsStore(
(s) => s.setUseDictationAgentVisionModel
);
const {
isMacOS,
granted: screenGranted,
supported: screenSupported,
needsRelaunch: screenNeedsRelaunch,
request: requestScreenAccess,
} = useScreenRecordingPermission();
const agentAllowed = usePolicyStore(isAgentAllowed);
const screenContextAllowed = usePolicyStore(isScreenContextAllowed);
const visionOverrideAllowed = usePolicyStore((state) =>
isModeAllowedByPolicy(state, "llm", "providers")
);
// Display the effective value: an org that forces the feature off shows the
// toggle off while the raw preference survives for when the policy lifts.
const screenContextActive = voiceAgentScreenContext && screenContextAllowed;
const { agentName, setAgentName } = useAgentName();
const [agentNameInput, setAgentNameInput] = useState(agentName);
const { showAlertDialog } = useDialogs();
const handleSaveAgentName = useCallback(() => {
const trimmed = agentNameInput.trim();
// setAgentName also moves the name in the dictionary.
setAgentName(trimmed);
setAgentNameInput(trimmed);
showAlertDialog({
title: t("settingsPage.agentConfig.dialogs.updatedTitle"),
description: t("settingsPage.agentConfig.dialogs.updatedDescription", {
name: trimmed,
}),
});
}, [agentNameInput, setAgentName, showAlertDialog, t]);
const handleScreenContextToggle = useCallback(
(enabled: boolean) => {
setVoiceAgentScreenContext(enabled);
// Keeps the dictation overlay out of its own screenshots.
window.electronAPI?.setScreenContextEnabled?.(enabled);
if (enabled && isMacOS && !screenGranted) {
void requestScreenAccess();
}
},
[setVoiceAgentScreenContext, isMacOS, screenGranted, requestScreenAccess]
);
const instructionMode = t("settingsPage.agentConfig.instructionMode");
const examples = [
t("settingsPage.agentConfig.examples.formalEmail", { agentName }),
t("settingsPage.agentConfig.examples.professional", { agentName }),
t("settingsPage.agentConfig.examples.bulletPoints", { agentName }),
];
const voiceAgentSection = (
<div className="border-t border-border/70 pt-6 space-y-5">
<SectionHeader
title={t("settingsPage.agentConfig.title")}
description={t("settingsPage.agentConfig.description")}
/>
<div>
<p className="text-xs font-medium text-foreground mb-3">
{t("settingsPage.agentConfig.agentName")}
</p>
<SettingsPanel>
<SettingsPanelRow>
<div className="space-y-3">
<div className="flex gap-2">
<Input
dir="auto"
placeholder={t("settingsPage.agentConfig.placeholder")}
value={agentNameInput}
onChange={(e) => setAgentNameInput(e.target.value)}
className="flex-1 text-center text-base font-mono"
/>
<Button onClick={handleSaveAgentName} disabled={!agentNameInput.trim()} size="sm">
{t("settingsPage.agentConfig.save")}
</Button>
</div>
<p className="text-xs text-muted-foreground/70">
{t("settingsPage.agentConfig.helper")}
</p>
</div>
</SettingsPanelRow>
</SettingsPanel>
</div>
<div>
<SectionHeader title={t("settingsPage.agentConfig.howItWorksTitle")} />
<SettingsPanel>
<SettingsPanelRow>
<p className="text-xs text-muted-foreground leading-relaxed">
{t("settingsPage.agentConfig.howItWorksDescription", { agentName })}
</p>
</SettingsPanelRow>
</SettingsPanel>
</div>
<div>
<SectionHeader title={t("settingsPage.agentConfig.examplesTitle")} />
<SettingsPanel>
<SettingsPanelRow>
<div className="space-y-2.5">
{examples.map((input, i) => (
<div key={i} className="flex items-start gap-3">
<span className="shrink-0 mt-0.5 text-xs font-medium uppercase tracking-wider px-1.5 py-px rounded bg-primary/10 text-primary dark:bg-primary/15">
{instructionMode}
</span>
<p className="text-xs text-muted-foreground leading-relaxed">"{input}"</p>
</div>
))}
</div>
</SettingsPanelRow>
</SettingsPanel>
</div>
</div>
);
return (
<div className="space-y-4">
<SettingsPanel>
<SettingsPanelRow>
<SettingsRow
label={t("dictationAgent.enabled")}
description={
agentAllowed
? t("dictationAgent.enabledDescription", { agentName })
: t("common.managedByOrg")
}
>
<Toggle
checked={useDictationAgent}
onChange={setUseDictationAgent}
disabled={!agentAllowed}
/>
</SettingsRow>
</SettingsPanelRow>
</SettingsPanel>
{useDictationAgent && <InferenceConfigEditor scope="dictationAgent" />}
{/* Screen context is a voice-agent sub-feature: hidden when an org
blocks the agent, since enabling it would grant screen-capture
permission for a route that can never run. */}
{useDictationAgent && agentAllowed && (
<div className="border-t border-border/70 pt-6 space-y-3">
<SectionHeader
title={t("dictationAgent.screenContext.title")}
description={t("dictationAgent.screenContext.description")}
/>
<SettingsPanel>
<SettingsPanelRow>
<SettingsRow
label={t("dictationAgent.screenContext.enable")}
description={
!screenContextAllowed
? t("common.managedByOrg")
: screenSupported
? t("dictationAgent.screenContext.enableDescription")
: t("dictationAgent.screenContext.unsupported")
}
>
<Toggle
checked={screenContextActive}
onChange={handleScreenContextToggle}
disabled={!screenSupported || !screenContextAllowed}
/>
</SettingsRow>
</SettingsPanelRow>
{screenContextActive && visionOverrideAllowed && (
<SettingsPanelRow>
<SettingsRow
label={t("dictationAgent.screenContext.visionModel")}
description={t("dictationAgent.screenContext.visionModelDescription")}
>
<Toggle
checked={useDictationAgentVisionModel}
onChange={setUseDictationAgentVisionModel}
/>
</SettingsRow>
</SettingsPanelRow>
)}
</SettingsPanel>
{screenContextActive && isMacOS && !screenGranted && (
<PermissionCard
icon={Monitor}
title={t("dictationAgent.screenContext.permissionTitle")}
description={t("dictationAgent.screenContext.permissionDescription")}
granted={false}
onRequest={requestScreenAccess}
buttonText={t("onboarding.permissions.grantAccess")}
/>
)}
{screenContextActive && isMacOS && screenNeedsRelaunch && (
<p className="text-[11px] text-warning/80 leading-snug">
{t("dictationAgent.screenContext.relaunchHint")}
</p>
)}
{screenContextActive && visionOverrideAllowed && useDictationAgentVisionModel && (
<InferenceConfigEditor scope="dictationAgentVision" allowedModes={["providers"]} />
)}
</div>
)}
{voiceAgentSection}
{useDictationAgent && (
<div className="border-t border-border/70 pt-6">
<SectionHeader
title={t("dictationAgent.prompt.title")}
description={t("dictationAgent.prompt.description")}
/>
<PromptStudio kind="dictationAgent" />
</div>
)}
</div>
);
}