refactor: consolidate LLM provider hooks into hooks/useLLMProviders

Move useLLMProviders from lib/hooks/ and useWellKnownLLMProviders from
hooks/ into a single hooks/useLLMProviders.ts file. Update all imports.

Author: raunakab

web/src/app/craft/hooks/useBuildSessionController.ts

@@ -7,7 +7,7 @@ import { usePreProvisionPolling } from "@/app/craft/hooks/usePreProvisionPolling
 import { CRAFT_SEARCH_PARAM_NAMES } from "@/app/craft/services/searchParams";
 import { CRAFT_PATH } from "@/app/craft/v1/constants";
 import { getBuildUserPersona } from "@/app/craft/onboarding/constants";
-import { useLLMProviders } from "@/lib/hooks/useLLMProviders";
+import { useLLMProviders } from "@/hooks/useLLMProviders";
 import { checkPreProvisionedSession } from "@/app/craft/services/apiServices";
 
 interface UseBuildSessionControllerProps {

web/src/app/craft/onboarding/hooks/useOnboardingModal.ts

@@ -2,7 +2,7 @@
 
 import { useCallback, useState, useMemo, useEffect } from "react";
 import { useUser } from "@/providers/UserProvider";
-import { useLLMProviders } from "@/lib/hooks/useLLMProviders";
+import { useLLMProviders } from "@/hooks/useLLMProviders";
 import { LLMProviderName } from "@/app/admin/configuration/llm/interfaces";
 import {
   OnboardingModalMode,

web/src/app/craft/v1/configure/page.tsx

@@ -41,7 +41,7 @@ import Switch from "@/refresh-components/inputs/Switch";
 import SimpleTooltip from "@/refresh-components/SimpleTooltip";
 import NotAllowedModal from "@/app/craft/onboarding/components/NotAllowedModal";
 import { useOnboarding } from "@/app/craft/onboarding/BuildOnboardingProvider";
-import { useLLMProviders } from "@/lib/hooks/useLLMProviders";
+import { useLLMProviders } from "@/hooks/useLLMProviders";
 import { useUser } from "@/providers/UserProvider";
 import { getProviderIcon } from "@/app/admin/configuration/llm/utils";
 import {

web/src/hooks/useLLMProviders.ts

@@ -0,0 +1,63 @@
+"use client";
+
+import useSWR from "swr";
+import { errorHandlingFetcher } from "@/lib/fetcher";
+import {
+  LLMProviderDescriptor,
+  WellKnownLLMProviderDescriptor,
+} from "@/app/admin/configuration/llm/interfaces";
+
+/**
+ * Fetches configured LLM providers accessible to the current user.
+ *
+ * @param personaId - Optional persona ID for RBAC-scoped providers.
+ *   - `undefined`: public providers only (`/api/llm/provider`)
+ *   - `number`: persona-specific providers with RBAC enforcement
+ */
+export function useLLMProviders(personaId?: number) {
+  const url =
+    typeof personaId === "number"
+      ? `/api/llm/persona/${personaId}/providers`
+      : "/api/llm/provider";
+
+  const { data, error, mutate } = useSWR<LLMProviderDescriptor[] | undefined>(
+    url,
+    errorHandlingFetcher,
+    {
+      revalidateOnFocus: false, // Cache aggressively for performance
+      dedupingInterval: 60000, // Dedupe requests within 1 minute
+    }
+  );
+
+  return {
+    llmProviders: data,
+    isLoading: !error && !data,
+    error,
+    refetch: mutate,
+  };
+}
+
+/**
+ * Fetches the list of well-known (built-in) LLM providers and their models.
+ *
+ * Returns provider descriptors including known models and recommended defaults
+ * for each supported provider (OpenAI, Anthropic, Vertex AI, Bedrock, etc.).
+ */
+export function useWellKnownLLMProviders() {
+  const {
+    data: wellKnownLLMProviders,
+    error,
+    isLoading,
+    mutate,
+  } = useSWR<WellKnownLLMProviderDescriptor[]>(
+    "/api/admin/llm/built-in/options",
+    errorHandlingFetcher
+  );
+
+  return {
+    wellKnownLLMProviders: wellKnownLLMProviders ?? null,
+    isLoading,
+    error,
+    mutate,
+  };
+}

web/src/hooks/useWellKnownLLMProviders.ts

@@ -39,7 +39,7 @@ import { AuthType, NEXT_PUBLIC_CLOUD_ENABLED } from "./constants";
 import { useUser } from "@/providers/UserProvider";
 import { SEARCH_TOOL_ID } from "@/app/app/components/tools/constants";
 import { updateTemperatureOverrideForChatSession } from "@/app/app/services/lib";
-import { useLLMProviders } from "./hooks/useLLMProviders";
+import { useLLMProviders } from "@/hooks/useLLMProviders";
 
 const CREDENTIAL_URL = "/api/manage/admin/credential";
 

web/src/lib/hooks.ts

@@ -11,7 +11,7 @@ import { WellKnownLLMProviderDescriptor } from "@/app/admin/configuration/llm/in
 import { updateUserPersonalization } from "@/lib/userSettings";
 import { useUser } from "@/providers/UserProvider";
 import { MinimalPersonaSnapshot } from "@/app/admin/assistants/interfaces";
-import { useLLMProviders } from "@/lib/hooks/useLLMProviders";
+import { useLLMProviders } from "@/hooks/useLLMProviders";
 
 export function useOnboardingState(liveAssistant?: MinimalPersonaSnapshot): {
   state: OnboardingState;

web/src/lib/hooks/useLLMProviders.ts

@@ -18,7 +18,7 @@ import * as InputLayouts from "@/layouts/input-layouts";
 import { useFormikContext } from "formik";
 import LLMSelector from "@/components/llm/LLMSelector";
 import { parseLlmDescriptor, structureValue } from "@/lib/llmConfig/utils";
-import { useLLMProviders } from "@/lib/hooks/useLLMProviders";
+import { useLLMProviders } from "@/hooks/useLLMProviders";
 import {
   STARTER_MESSAGES_EXAMPLES,
   MAX_CHARACTERS_STARTER_MESSAGE,

web/src/refresh-components/onboarding/useOnboardingState.ts

@@ -4,7 +4,7 @@ import { useRef } from "react";
 import useSWR, { useSWRConfig } from "swr";
 import { toast } from "@/hooks/useToast";
 import { errorHandlingFetcher } from "@/lib/fetcher";
-import useWellKnownLLMProviders from "@/hooks/useWellKnownLLMProviders";
+import { useWellKnownLLMProviders } from "@/hooks/useLLMProviders";
 import { ThreeDotsLoader } from "@/components/Loading";
 import { Content, ContentAction } from "@opal/layouts";
 import { Button } from "@opal/components";