Skip to content

πŸ™Œ OpenHands: AI-Driven Development

2.2 KB
Raw Blame
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]);
}