OpenRAG is a comprehensive, single package Retrieval-Augmented Generation platform built on Langflow, Docling, and Opensearch.
Python
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
import { apiClient } from "@/lib/api-client";
import { getApiError } from "@/lib/status-utils";
import type {
ComponentState,
ComponentStatus,
ConsoleStatusResponse,
} from "./useConsoleStatusQuery";
// ─── shared types ──────────────────────────────────────────────────────────
export interface ComponentActionResponse {
component: string;
ok: boolean;
message: string;
status: ComponentStatus;
}
export interface DiagnosisResponse {
component: string;
state: ComponentState;
summary: string;
likely_cause?: string | null;
remediation: string[];
last_error?: string | null;
target?: string | null;
}
const SEVERITY: Record<ComponentState, number> = {
healthy: 0,
degraded: 1,
unknown: 2,
unhealthy: 3,
};
const worstOf = (states: ComponentState[]): ComponentState =>
states.reduce<ComponentState>(
(worst, s) => (SEVERITY[s] > SEVERITY[worst] ? s : worst),
"healthy",
);
// ─── sync mutation ───────────────────────────────────────────────────────────
/** Re-checks one component and patches the ["console-status"] cache with the
* returned fresh status. */
export function useComponentSyncMutation() {
const queryClient = useQueryClient();
return useMutation({
mutationFn: async (component: string): Promise<ComponentActionResponse> => {
const res = await apiClient.post<ComponentActionResponse>(
`/status/${encodeURIComponent(component)}/sync`,
);
const body = res.data ?? {};
if (res.status < 200 || res.status >= 300) {
throw new Error(getApiError(body, res.status));
}
return body as ComponentActionResponse;
},
onSuccess: (result) => {
queryClient.setQueryData<ConsoleStatusResponse>(
["console-status"],
(prev) => {
if (!prev) return prev;
const components = prev.components.map((c) =>
c.name === result.component ? result.status : c,
);
return {
...prev,
components,
overall_status: worstOf(components.map((c) => c.status)),
};
},
);
queryClient.invalidateQueries({
queryKey: ["component-diagnose", result.component],
});
queryClient.invalidateQueries({
queryKey: ["component-logs", result.component],
});
},
});
}
// ─── diagnose query (lazy — fires when the modal opens) ──────────────────────
export const useComponentDiagnoseQuery = (component: string | null) =>
useQuery({
queryKey: ["component-diagnose", component],
queryFn: async ({ signal }) => {
const res = await apiClient.get<DiagnosisResponse>(
`/status/${encodeURIComponent(component as string)}/diagnose`,
{ signal },
);
const body = res.data ?? {};
if (res.status < 200 || res.status >= 300) {
throw new Error(getApiError(body, res.status));
}
return body as DiagnosisResponse;
},
enabled: !!component,
staleTime: 5000,
refetchOnWindowFocus: false,
});