fix(desktop,db): unbreak chat in local-first workspaces and clean up no-credential UX

apps/desktop/src/renderer/routes/_authenticated/_dashboard/v2-workspace/$workspaceId/hooks/usePaneRegistry/components/ChatPane/components/WorkspaceChatInterface/components/ChatInputFooter/ChatInputFooter.tsx

@@ -6,7 +6,9 @@ import {
 	usePromptInputController,
 } from "@superset/ui/ai-elements/prompt-input";
 import type { ThinkingLevel } from "@superset/ui/ai-elements/thinking-toggle";
+import { Button } from "@superset/ui/button";
 import { workspaceTrpc } from "@superset/workspace-client";
+import { useNavigate } from "@tanstack/react-router";
 import type { ChatStatus, FileUIPart } from "ai";
 import type React from "react";
 import type { ReactNode } from "react";
@@ -27,7 +29,10 @@ import { FileDropOverlay } from "./components/FileDropOverlay";
 import { LinkedIssues } from "./components/LinkedIssues";
 import { SlashCommandPreview } from "./components/SlashCommandPreview";
 import type { LinkedIssue } from "./types";
-import { getErrorMessage } from "./utils/getErrorMessage";
+import {
+	getErrorMessage,
+	isMissingModelProviderError,
+} from "./utils/getErrorMessage";
 
 interface ChatInputFooterProps {
 	workspaceId: string;
@@ -106,7 +111,9 @@ export function ChatInputFooter({
 
 	const [linkedIssues, setLinkedIssues] = useState<LinkedIssue[]>([]);
 	const inputRootRef = useRef<HTMLDivElement>(null);
+	const navigate = useNavigate();
 	const errorMessage = getErrorMessage(error);
+	const showModelProviderSetup = isMissingModelProviderError(errorMessage);
 	const focusShortcutText = useHotkeyDisplay("FOCUS_CHAT_INPUT").text;
 	const showFocusHint = focusShortcutText !== "Unassigned";
 
@@ -153,13 +160,33 @@ export function ChatInputFooter({
 		<ChatInputDropZone className="bg-background px-4 py-3">
 			{(dragType) => (
 				<div className="mx-auto w-full max-w-[680px]">
-					{errorMessage && (
-						<p
+					{showModelProviderSetup ? (
+						<div
 							role="alert"
-							className="mb-3 select-text rounded-md border border-destructive/20 bg-destructive/10 px-4 py-2 text-sm text-destructive"
+							className="mb-3 flex items-center justify-between gap-3 rounded-md border border-border bg-muted/50 px-4 py-2 text-sm"
 						>
-							{errorMessage}
-						</p>
+							<span className="select-text text-muted-foreground">
+								Chat needs a model provider. Connect Claude or add an API key to
+								get started.
+							</span>
+							<Button
+								size="sm"
+								variant="outline"
+								className="shrink-0"
+								onClick={() => void navigate({ to: "/settings/models" })}
+							>
+								Open Model Settings
+							</Button>
+						</div>
+					) : (
+						errorMessage && (
+							<p
+								role="alert"
+								className="mb-3 select-text rounded-md border border-destructive/20 bg-destructive/10 px-4 py-2 text-sm text-destructive"
+							>
+								{errorMessage}
+							</p>
+						)
 					)}
 					{pendingQuestion && onQuestionRespond && onQuestionCancel ? (
 						<QuestionInputOverlay

apps/desktop/src/renderer/routes/_authenticated/_dashboard/v2-workspace/$workspaceId/hooks/usePaneRegistry/components/ChatPane/components/WorkspaceChatInterface/components/ChatInputFooter/utils/getErrorMessage.ts

@@ -4,3 +4,12 @@ export function getErrorMessage(error: unknown): string | null {
 	if (error) return "Unexpected chat error";
 	return null;
 }
+
+// Host-service throws this when the chat runtime can't find Anthropic/OpenAI
+// credentials (packages/host-service/src/runtime/chat/chat.ts).
+export function isMissingModelProviderError(
+	errorMessage: string | null,
+): boolean {
+	if (!errorMessage) return false;
+	return /no model provider credentials/i.test(errorMessage);
+}

apps/desktop/src/renderer/routes/_authenticated/_dashboard/v2-workspace/$workspaceId/hooks/usePaneRegistry/components/ChatPane/hooks/useWorkspaceChatDisplay/useWorkspaceChatDisplay.ts

@@ -16,6 +16,11 @@ interface UseChatDisplayOptions {
 // are freed shortly after their pane unmounts instead of accumulating on the heap.
 const CHAT_QUERY_GC_TIME_MS = 60_000;
 
+// While getSnapshot is failing (e.g. runtime can't start without model
+// provider credentials), the 4fps poll would retry runtime creation — and
+// hit the macOS keychain — four times a second. Back off until it recovers.
+const ERROR_REFETCH_INTERVAL_MS = 5_000;
+
 function toRefetchIntervalMs(fps: number): number {
 	if (!Number.isFinite(fps) || fps <= 0) return Math.floor(1000 / 60);
 	return Math.max(16, Math.floor(1000 / fps));
@@ -125,7 +130,10 @@ export function useChatDisplay(options: UseChatDisplayOptions) {
 	const refetchIntervalMs = toRefetchIntervalMs(fps);
 	const queryOptions = {
 		enabled: isQueryEnabled && queryInput !== undefined,
-		refetchInterval: refetchIntervalMs,
+		refetchInterval: (query: { state: { status: string } }) =>
+			query.state.status === "error"
+				? ERROR_REFETCH_INTERVAL_MS
+				: refetchIntervalMs,
 		refetchIntervalInBackground: true,
 		refetchOnWindowFocus: false,
 		gcTime: CHAT_QUERY_GC_TIME_MS,
@@ -153,10 +161,10 @@ export function useChatDisplay(options: UseChatDisplayOptions) {
 			: null;
 	const currentMessage = displayState?.currentMessage ?? null;
 	const isRunning = displayState?.isRunning ?? false;
-	const isConversationLoading =
-		isQueryEnabled &&
-		snapshotQuery.data === undefined &&
-		(snapshotQuery.isLoading || snapshotQuery.isFetching);
+	// isPending only (not isFetching): once the query errors, background
+	// retries must not flip the pane back to the loading spinner — that
+	// spinner/error alternation reads as the chat constantly reloading.
+	const isConversationLoading = isQueryEnabled && snapshotQuery.isPending;
 	const historicalMessages = snapshot?.messages ?? [];
 	const latestAssistantErrorMessage = isRunning
 		? null

packages/db/drizzle/0064_drop_chat_sessions_v2_workspace_fk.sql

@@ -0,0 +1 @@
+ALTER TABLE "chat_sessions" DROP CONSTRAINT "chat_sessions_v2_workspace_id_v2_workspaces_id_fk";