diff --git a/src/components/ai-edition/ChatWelcome.test.tsx b/src/components/ai-edition/ChatWelcome.test.tsx
new file mode 100644
index 000000000..28ccb4248
--- /dev/null
+++ b/src/components/ai-edition/ChatWelcome.test.tsx
@@ -0,0 +1,61 @@
+// ChatWelcome guards the "no provider connected" empty state: the copy reaches
+// the DOM, the CTA fires, and a non-English locale is really translated rather
+// than falling back to English. localeParity.test.ts covers key presence for
+// the other locales; only the fallback check needs a rendered card.
+
+import "@testing-library/jest-dom";
+import { cleanup, fireEvent, render, screen } from "@testing-library/react";
+import type { ReactElement } from "react";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { I18nProvider } from "@/contexts/I18nContext";
+import { LOCALE_STORAGE_KEY } from "@/i18n/config";
+import { ChatWelcome } from "./ChatWelcome";
+
+function renderIn(locale: string, ui: ReactElement) {
+ localStorage.setItem(LOCALE_STORAGE_KEY, locale);
+ return render({ui});
+}
+
+beforeEach(() => {
+ localStorage.clear();
+});
+
+afterEach(() => {
+ cleanup();
+ localStorage.clear();
+});
+
+describe("ChatWelcome", () => {
+ it("renders the English welcome card with the CTA and disclaimer", () => {
+ const onOpen = vi.fn();
+ renderIn("en", );
+
+ expect(screen.getByRole("heading", { name: /bring your own ai/i })).toBeInTheDocument();
+ expect(screen.getByText(/talk.*language model/i)).toBeInTheDocument();
+ // The 3 feature lines are inside a
; query them by text so we know
+ // they actually reach the DOM, not just an unused i18n key.
+ expect(screen.getByText(/cut silences/i)).toBeInTheDocument();
+ expect(screen.getByText(/add captions/i)).toBeInTheDocument();
+ expect(screen.getByText(/rewrite a section/i)).toBeInTheDocument();
+ expect(screen.getByText(/transcript will be sent/i)).toBeInTheDocument();
+ });
+
+ it("invokes the onOpenProviderSettings callback when the CTA is clicked", () => {
+ const onOpen = vi.fn();
+ renderIn("en", );
+
+ fireEvent.click(screen.getByRole("button", { name: /set up a provider/i }));
+
+ expect(onOpen).toHaveBeenCalledTimes(1);
+ });
+
+ it("renders the French welcome card with translated copy", () => {
+ renderIn("fr", );
+
+ expect(screen.getByRole("heading", { name: /apportez votre ia/i })).toBeInTheDocument();
+ expect(screen.getByText(/configurer un fournisseur/i)).toBeInTheDocument();
+ // Disclaimer must NOT be the English fallback
+ expect(screen.queryByText(/transcript will be sent/i)).not.toBeInTheDocument();
+ expect(screen.getByText(/transcription de votre vidéo/i)).toBeInTheDocument();
+ });
+});
diff --git a/src/components/ai-edition/ChatWelcome.tsx b/src/components/ai-edition/ChatWelcome.tsx
new file mode 100644
index 000000000..c88911183
--- /dev/null
+++ b/src/components/ai-edition/ChatWelcome.tsx
@@ -0,0 +1,47 @@
+// Welcome view for the LM chat panel.
+//
+// Shown in the chat body when the chat has nothing it can talk to — see
+// canSendChat() in chatAvailability.ts. It replaces the `chat.emptyState` hint
+// (a dead end with no provider) only while the conversation is empty, so a user
+// who disconnects mid-project keeps their history with the composer disabled.
+
+import { ArrowRight, Info, Sparkles } from "lucide-react";
+import { useScopedT } from "@/contexts/I18nContext";
+import styles from "./NewEditorShell.module.css";
+
+const FEATURE_KEYS = ["feature1", "feature2", "feature3"] as const;
+
+interface ChatWelcomeProps {
+ /** Open the provider settings modal so the user can pick + connect one. */
+ onOpenProviderSettings: () => void;
+}
+
+export function ChatWelcome({ onOpenProviderSettings }: ChatWelcomeProps) {
+ const t = useScopedT("editor");
+
+ return (
+
+
+
+
{t("chat.welcome.title")}
+
{t("chat.welcome.subtitle")}
+
+
+
+ {FEATURE_KEYS.map((key) => (
+
{t(`chat.welcome.${key}`)}
+ ))}
+
+
+
+
+
+
+ {t("chat.welcome.disclaimer")}
+
+
+ );
+}
diff --git a/src/components/ai-edition/LeftPanel.tsx b/src/components/ai-edition/LeftPanel.tsx
index 4812c3968..3bb5024a1 100644
--- a/src/components/ai-edition/LeftPanel.tsx
+++ b/src/components/ai-edition/LeftPanel.tsx
@@ -21,6 +21,8 @@ import {
PROVIDER_DEFINITIONS,
type ReasoningEffort,
} from "../../../electron/ai-edition/provider-registry";
+import { ChatWelcome } from "./ChatWelcome";
+import { canSendChat } from "./chatAvailability";
import { computeBudget } from "./chatBudget";
import { ChatHistoryModal, SourceTranscriptModal } from "./Modals";
import styles from "./NewEditorShell.module.css";
@@ -645,6 +647,9 @@ function ModelQuickPopover({
function ChatStripPanel() {
const t = useScopedT("editor");
const tc = useScopedT("common");
+ // The Auto-enhance confirmation is timeline-owned copy, fired from here —
+ // see the prompt-bus effect below.
+ const tTimeline = useScopedT("timeline");
const projectId = useProjectStore((s) => s.projectId);
const [messages, setMessages] = useState([]);
const [input, setInput] = useState("");
@@ -672,7 +677,10 @@ function ChatStripPanel() {
bottom: number;
} | null>(null);
const [reasoningBusy, setReasoningBusy] = useState(false);
- const [connectedProviders, setConnectedProviders] = useState([]);
+ // null until the first llmGetSnapshot() lands: "unknown", not "none".
+ const [connectedProviders, setConnectedProviders] = useState(null);
+ // unknown ≠ none; see chatAvailability.ts.
+ const canChat = canSendChat(llmConfig, connectedProviders);
const [modelPopoverOpen, setModelPopoverOpen] = useState(false);
const modelButtonRef = useRef(null);
const [modelPopoverRect, setModelPopoverRect] = useState<{
@@ -770,6 +778,14 @@ function ChatStripPanel() {
const send = async (overrideText?: string) => {
const text = (overrideText ?? input).trim();
if (!projectId || !text || busy) return;
+ // ponytail: nothing to talk to. Bounce to the settings modal instead of
+ // firing a doomed request. The composer is disabled in this state too,
+ // but Auto-enhance calls send() directly and Enter can slip through.
+ if (!canChat) {
+ toast.error(t("chat.composerDisabledNoProvider"));
+ setSettingsOpen(true);
+ return;
+ }
setInput("");
setBusy(true);
// ponytail: pre-seed the user message so the rewind ↩ button is
@@ -843,14 +859,19 @@ function ChatStripPanel() {
// timeline's Auto-enhance → "Smart zooms + cuts with AI"). Routes through
// the normal send() so sessions/checkpoints/rewind all keep working; the
// message shows in the composer's history exactly as if typed.
+ // The confirmation toast lives here because only this side knows the prompt
+ // was taken — send() bounces it to the settings modal with no provider.
+ // ponytail: one producer today, so the toast copy is assumed to be its own.
+ // A second producer needs the bus to carry its confirmation string.
const pendingPrompt = useChatPromptBus((s) => s.pending);
const consumePrompt = useChatPromptBus((s) => s.consume);
// biome-ignore lint/correctness/useExhaustiveDependencies: send() is intentionally not a dep (recreated each render); consume() clears `pending` so this fires once per queued prompt.
useEffect(() => {
if (!pendingPrompt || !projectId || busy) return;
consumePrompt();
+ if (canChat) toast.success(tTimeline("toolbar.aiEnhanceRequested"));
void send(pendingPrompt);
- }, [pendingPrompt, projectId, busy, consumePrompt]);
+ }, [pendingPrompt, projectId, busy, consumePrompt, canChat, tTimeline]);
// ponytail: per-user-message rewind. Pops a confirmation popover, then
// asks the main process to roll the session + document back to the
@@ -1405,7 +1426,9 @@ function ChatStripPanel() {