π OpenHands: AI-Driven Development
import { useEffect, useRef } from "react";
import { useActiveBackend } from "#/contexts/active-backend-context";
import { useLlmProfiles } from "#/hooks/query/use-llm-profiles";
import { useActivateLlmProfile } from "#/hooks/mutation/use-activate-llm-profile";
/**
* Local-mode UX policy: keep an LLM profile active whenever at least one
* exists, so the agent always has a usable LLM without a manual "activate"
* step. This lives in the client on purpose β the agent-server is a neutral
* API that returns `active_profile` as stored (possibly pointing at a deleted
* profile); other consumers (e.g. SaaS) own the LLM differently.
*
* When profiles exist but none is the active one β never activated, or the
* active profile was deleted β it activates the first profile that has an API
* key (falling back to the first profile). With zero profiles it does nothing:
* that genuine "no LLM" state is surfaced by the gate/banner.
*/
export function useEnsureActiveProfile(): void {
const { backend } = useActiveBackend();
const isLocal = backend.kind === "local";
const { data: profilesData } = useLlmProfiles();
const { mutate: activate, isPending } = useActivateLlmProfile();
// Remember the last profile we tried to activate so we don't re-fire while
// the mutation + refetch settle, or hammer a profile whose activation fails.
const attemptedRef = useRef<string | null>(null);
// A backend switch is a clean slate for the above guard.
useEffect(() => {
attemptedRef.current = null;
}, [backend.id]);
useEffect(() => {
if (!isLocal || isPending || !profilesData) return;
const { profiles, active_profile: activeProfile } = profilesData;
const activeValid =
activeProfile != null && profiles.some((p) => p.name === activeProfile);
if (profiles.length === 0 || activeValid) {
attemptedRef.current = null;
return;
}
// Prefer a profile with a key so the result is immediately usable.
const target = profiles.find((p) => p.api_key_set) ?? profiles[0];
if (attemptedRef.current === target.name) return;
attemptedRef.current = target.name;
activate(target.name);
}, [isLocal, profilesData, isPending, activate]);
}