The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.
Rust agent-orchestrationai-agentsai-assistantdesktopllmlocal-firstmcppersonal-aiprivacyrustsecond-braintauri
import createDebug from 'debug';
import { useCallback, useEffect, useRef, useState } from 'react';
import { type FlowRun, listAllFlowRuns, listFlowRuns } from '../services/api/flowsApi';
const log = createDebug('app:flows:runs-query');
export type FlowRunsQueryScope = { kind: 'flow'; flowId: string | null } | { kind: 'all' };
export interface UseFlowRunsQueryOptions {
scope: FlowRunsQueryScope;
enabled?: boolean;
}
export interface UseFlowRunsQueryResult {
runs: FlowRun[];
loading: boolean;
error: string | null;
refresh: () => Promise<void>;
refreshSilently: () => Promise<void>;
}
function normalizeError(error: unknown): string {
return error instanceof Error ? error.message : String(error);
}
export function useFlowRunsQuery({
scope,
enabled = true,
}: UseFlowRunsQueryOptions): UseFlowRunsQueryResult {
const [runs, setRuns] = useState<FlowRun[]>([]);
const [loading, setLoading] = useState(false);
const [error, setError] = useState<string | null>(null);
const mountedRef = useRef(false);
const requestGenerationRef = useRef(0);
const latestForegroundGenerationRef = useRef(0);
const latestSilentGenerationRef = useRef(0);
const publishedGenerationRef = useRef(0);
const scopeKind = scope.kind;
const flowId = scope.kind === 'flow' ? scope.flowId : null;
const canFetch = enabled && (scopeKind === 'all' || flowId !== null);
const requestRuns = useCallback(
() => (scopeKind === 'flow' ? listFlowRuns(flowId as string) : listAllFlowRuns()),
[flowId, scopeKind]
);
const refresh = useCallback(async () => {
if (!canFetch) return;
const generation = ++requestGenerationRef.current;
latestForegroundGenerationRef.current = generation;
if (mountedRef.current) {
setLoading(true);
setError(null);
}
try {
const result = await requestRuns();
if (
!mountedRef.current ||
generation !== latestForegroundGenerationRef.current ||
generation < publishedGenerationRef.current
) {
return;
}
publishedGenerationRef.current = generation;
setRuns(result);
} catch (requestError) {
if (
!mountedRef.current ||
generation !== latestForegroundGenerationRef.current ||
generation < publishedGenerationRef.current
) {
return;
}
setError(normalizeError(requestError));
} finally {
if (mountedRef.current && generation === latestForegroundGenerationRef.current) {
setLoading(false);
}
}
}, [canFetch, requestRuns]);
const refreshSilently = useCallback(async () => {
if (!canFetch) return;
const generation = ++requestGenerationRef.current;
latestSilentGenerationRef.current = generation;
try {
const result = await requestRuns();
if (
!mountedRef.current ||
generation !== latestSilentGenerationRef.current ||
generation < latestForegroundGenerationRef.current
) {
return;
}
publishedGenerationRef.current = generation;
setRuns(result);
setLoading(false);
} catch {
if (
!mountedRef.current ||
generation !== latestSilentGenerationRef.current ||
generation < latestForegroundGenerationRef.current
) {
return;
}
log('silent refresh failed: scope=%s', scopeKind);
}
}, [canFetch, requestRuns, scopeKind]);
useEffect(() => {
mountedRef.current = true;
return () => {
mountedRef.current = false;
const generation = ++requestGenerationRef.current;
latestForegroundGenerationRef.current = generation;
latestSilentGenerationRef.current = generation;
publishedGenerationRef.current = generation;
};
}, []);
useEffect(() => {
const generation = ++requestGenerationRef.current;
latestForegroundGenerationRef.current = generation;
latestSilentGenerationRef.current = generation;
publishedGenerationRef.current = generation;
setRuns([]);
setLoading(false);
setError(null);
if (canFetch) void refresh();
return () => {
const cleanupGeneration = ++requestGenerationRef.current;
latestForegroundGenerationRef.current = cleanupGeneration;
latestSilentGenerationRef.current = cleanupGeneration;
publishedGenerationRef.current = cleanupGeneration;
};
}, [canFetch, flowId, refresh, scopeKind]);
return { runs, loading, error, refresh, refreshSilently };
}