@elizaos/ui 2.0.0-alpha.85 → 2.0.0-beta.2

package/state/useExportImportState.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Agent export/import state — extracted from AppContext.
+ *
+ * Manages the export/import UI state and the download/upload
+ * callbacks. Uses the client singleton directly, matching the
+ * pattern of useTriggersState / usePairingState.
+ */
+export declare function useExportImportState(): {
+    state: {
+        exportBusy: boolean;
+        exportPassword: string;
+        exportIncludeLogs: boolean;
+        exportError: string | null;
+        exportSuccess: string | null;
+        importBusy: boolean;
+        importPassword: string;
+        importFile: File | null;
+        importError: string | null;
+        importSuccess: string | null;
+    };
+    setExportPassword: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setExportIncludeLogs: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setExportError: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    setExportSuccess: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    setImportPassword: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setImportFile: import("react").Dispatch<import("react").SetStateAction<File | null>>;
+    setImportError: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    setImportSuccess: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    handleAgentExport: () => Promise<void>;
+    handleAgentImport: () => Promise<void>;
+};
+//# sourceMappingURL=useExportImportState.d.ts.map

package/state/useExportImportState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExportImportState.d.ts","sourceRoot":"","sources":["../../../../../src/state/useExportImportState.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,wBAAgB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;EAyInC"}

package/state/useExportImportState.js

@@ -0,0 +1,140 @@
+/**
+ * Agent export/import state — extracted from AppContext.
+ *
+ * Manages the export/import UI state and the download/upload
+ * callbacks. Uses the client singleton directly, matching the
+ * pattern of useTriggersState / usePairingState.
+ */
+import { useCallback, useRef, useState } from "react";
+import { client } from "../api/index.js";
+import { AGENT_TRANSFER_MIN_PASSWORD_LENGTH } from "./internal.js";
+export function useExportImportState() {
+    // ── Export ─────────────────────────────────────────────────────────
+    const [exportBusy, setExportBusy] = useState(false);
+    const [exportPassword, setExportPassword] = useState("");
+    const [exportIncludeLogs, setExportIncludeLogs] = useState(false);
+    const [exportError, setExportError] = useState(null);
+    const [exportSuccess, setExportSuccess] = useState(null);
+    // ── Import ─────────────────────────────────────────────────────────
+    const [importBusy, setImportBusy] = useState(false);
+    const [importPassword, setImportPassword] = useState("");
+    const [importFile, setImportFile] = useState(null);
+    const [importError, setImportError] = useState(null);
+    const [importSuccess, setImportSuccess] = useState(null);
+    /** Synchronous lock for export action to prevent duplicate clicks in the same tick. */
+    const exportBusyRef = useRef(false);
+    /** Synchronous lock for import action to prevent duplicate clicks in the same tick. */
+    const importBusyRef = useRef(false);
+    // ── Callbacks ──────────────────────────────────────────────────────
+    const handleAgentExport = useCallback(async () => {
+        if (exportBusyRef.current || exportBusy)
+            return;
+        if (!exportPassword) {
+            setExportError("Password is required.");
+            setExportSuccess(null);
+            return;
+        }
+        if (exportPassword.length < AGENT_TRANSFER_MIN_PASSWORD_LENGTH) {
+            setExportError(`Password must be at least ${AGENT_TRANSFER_MIN_PASSWORD_LENGTH} characters.`);
+            setExportSuccess(null);
+            return;
+        }
+        try {
+            exportBusyRef.current = true;
+            setExportBusy(true);
+            setExportError(null);
+            setExportSuccess(null);
+            const resp = await client.exportAgent(exportPassword, exportIncludeLogs);
+            const blob = await resp.blob();
+            const disposition = resp.headers.get("Content-Disposition") ?? "";
+            const filenameMatch = /filename="?([^"]+)"?/.exec(disposition);
+            const filename = filenameMatch?.[1] ?? "agent-export.eliza-agent";
+            const url = URL.createObjectURL(blob);
+            const a = document.createElement("a");
+            a.href = url;
+            a.download = filename;
+            document.body.appendChild(a);
+            a.click();
+            document.body.removeChild(a);
+            URL.revokeObjectURL(url);
+            setExportSuccess(`Exported successfully (${(blob.size / 1024).toFixed(0)} KB)`);
+            setExportPassword("");
+        }
+        catch (err) {
+            setExportError(err instanceof Error ? err.message : "Export failed");
+        }
+        finally {
+            exportBusyRef.current = false;
+            setExportBusy(false);
+        }
+    }, [exportBusy, exportPassword, exportIncludeLogs]);
+    const handleAgentImport = useCallback(async () => {
+        if (importBusyRef.current || importBusy)
+            return;
+        if (!importFile) {
+            setImportError("Select an export file before importing.");
+            setImportSuccess(null);
+            return;
+        }
+        if (!importPassword) {
+            setImportError("Password is required.");
+            setImportSuccess(null);
+            return;
+        }
+        if (importPassword.length < AGENT_TRANSFER_MIN_PASSWORD_LENGTH) {
+            setImportError(`Password must be at least ${AGENT_TRANSFER_MIN_PASSWORD_LENGTH} characters.`);
+            setImportSuccess(null);
+            return;
+        }
+        try {
+            importBusyRef.current = true;
+            setImportBusy(true);
+            setImportError(null);
+            setImportSuccess(null);
+            const fileBuffer = await importFile.arrayBuffer();
+            const result = await client.importAgent(importPassword, fileBuffer);
+            const counts = result.counts;
+            const summary = [
+                counts.memories ? `${counts.memories} memories` : null,
+                counts.entities ? `${counts.entities} entities` : null,
+                counts.rooms ? `${counts.rooms} rooms` : null,
+            ]
+                .filter(Boolean)
+                .join(", ");
+            setImportSuccess(`Imported "${result.agentName}" successfully: ${summary || "no data"}. Restart the agent to activate.`);
+            setImportPassword("");
+            setImportFile(null);
+        }
+        catch (err) {
+            setImportError(err instanceof Error ? err.message : "Import failed");
+        }
+        finally {
+            importBusyRef.current = false;
+            setImportBusy(false);
+        }
+    }, [importBusy, importFile, importPassword]);
+    return {
+        state: {
+            exportBusy,
+            exportPassword,
+            exportIncludeLogs,
+            exportError,
+            exportSuccess,
+            importBusy,
+            importPassword,
+            importFile,
+            importError,
+            importSuccess,
+        },
+        setExportPassword,
+        setExportIncludeLogs,
+        setExportError,
+        setExportSuccess,
+        setImportPassword,
+        setImportFile,
+        setImportError,
+        setImportSuccess,
+        handleAgentExport,
+        handleAgentImport,
+    };
+}

package/state/useLifecycleState.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Lifecycle & startup state — consolidated via useReducer.
+ *
+ * Replaces 20+ individual useState hooks from AppContext with a single
+ * reducer + dispatch, cutting hook count and making state transitions explicit.
+ */
+import type { AgentStatus } from "../api";
+import type { ActionNotice, AppState, LifecycleAction, StartupErrorState, StartupPhase } from "./types";
+export interface LifecycleState {
+    connected: boolean;
+    agentStatus: AgentStatus | null;
+    onboardingComplete: boolean;
+    onboardingUiRevealNonce: number;
+    onboardingLoading: boolean;
+    startupPhase: StartupPhase;
+    startupError: StartupErrorState | null;
+    startupRetryNonce: number;
+    authRequired: boolean;
+    actionNotice: ActionNotice | null;
+    lifecycleBusy: boolean;
+    lifecycleAction: LifecycleAction | null;
+    pendingRestart: boolean;
+    pendingRestartReasons: string[];
+    restartBannerDismissed: boolean;
+    backendConnection: AppState["backendConnection"];
+    backendDisconnectedBannerDismissed: boolean;
+    systemWarnings: string[];
+}
+type LifecycleAction_ = {
+    type: "SET_CONNECTED";
+    value: boolean;
+} | {
+    type: "SET_AGENT_STATUS";
+    value: AgentStatus | null;
+} | {
+    type: "SET_ONBOARDING_COMPLETE";
+    value: boolean;
+} | {
+    type: "INCREMENT_ONBOARDING_REVEAL_NONCE";
+} | {
+    type: "SET_ONBOARDING_LOADING";
+    value: boolean;
+} | {
+    type: "SET_STARTUP_PHASE";
+    value: StartupPhase;
+} | {
+    type: "SET_STARTUP_ERROR";
+    value: StartupErrorState | null;
+} | {
+    type: "RETRY_STARTUP";
+} | {
+    type: "SET_AUTH_REQUIRED";
+    value: boolean;
+} | {
+    type: "SET_ACTION_NOTICE";
+    value: ActionNotice | null;
+} | {
+    type: "BEGIN_LIFECYCLE";
+    action: LifecycleAction;
+} | {
+    type: "FINISH_LIFECYCLE";
+} | {
+    type: "SET_PENDING_RESTART";
+    pending: boolean;
+    reasons?: string[];
+} | {
+    type: "DISMISS_RESTART_BANNER";
+} | {
+    type: "SHOW_RESTART_BANNER";
+} | {
+    type: "SET_BACKEND_CONNECTION";
+    value: Partial<AppState["backendConnection"]>;
+} | {
+    type: "DISMISS_BACKEND_BANNER";
+} | {
+    type: "RESET_BACKEND_CONNECTION";
+} | {
+    type: "ADD_SYSTEM_WARNING";
+    warning: string;
+} | {
+    type: "DISMISS_SYSTEM_WARNING";
+    message: string;
+} | {
+    type: "SET_SYSTEM_WARNINGS";
+    value: string[];
+};
+export interface LifecycleStateHook {
+    /** The consolidated lifecycle state. */
+    state: LifecycleState;
+    /** Dispatch an action to the lifecycle reducer. */
+    dispatch: React.Dispatch<LifecycleAction_>;
+    setConnected: (v: boolean) => void;
+    setAgentStatus: (v: AgentStatus | null) => void;
+    /** Only calls setAgentStatus when the payload has materially changed. */
+    setAgentStatusIfChanged: (next: AgentStatus | null) => void;
+    setOnboardingComplete: (v: boolean) => void;
+    incrementOnboardingRevealNonce: () => void;
+    setOnboardingLoading: (v: boolean) => void;
+    setStartupPhase: (v: StartupPhase) => void;
+    setStartupError: (v: StartupErrorState | null) => void;
+    retryStartup: () => void;
+    setAuthRequired: (v: boolean) => void;
+    setActionNotice: (text: string, tone?: "info" | "success" | "error", ttlMs?: number, once?: boolean, busy?: boolean) => void;
+    beginLifecycleAction: (action: LifecycleAction) => boolean;
+    finishLifecycleAction: () => void;
+    setPendingRestart: (pending: boolean, reasons?: string[]) => void;
+    dismissRestartBanner: () => void;
+    showRestartBanner: () => void;
+    setBackendConnection: (v: Partial<AppState["backendConnection"]>) => void;
+    dismissBackendBanner: () => void;
+    resetBackendConnection: () => void;
+    addSystemWarning: (warning: string) => void;
+    dismissSystemWarning: (message: string) => void;
+    setSystemWarnings: (v: string[]) => void;
+    /** Derived startup status. */
+    startupStatus: AppState["startupStatus"];
+    lifecycleBusyRef: React.RefObject<boolean>;
+    lifecycleActionRef: React.RefObject<LifecycleAction | null>;
+    agentStatusRef: React.RefObject<AgentStatus | null>;
+}
+export declare function useLifecycleState(): LifecycleStateHook;
+export type { LifecycleAction_ as LifecycleDispatchAction };
+//# sourceMappingURL=useLifecycleState.d.ts.map

package/state/useLifecycleState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLifecycleState.d.ts","sourceRoot":"","sources":["../../../../../src/state/useLifecycleState.ts"],"names":[],"mappings":"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"}

package/state/useLifecycleState.js

@@ -0,0 +1,258 @@
+/**
+ * Lifecycle & startup state — consolidated via useReducer.
+ *
+ * Replaces 20+ individual useState hooks from AppContext with a single
+ * reducer + dispatch, cutting hook count and making state transitions explicit.
+ */
+import { useCallback, useMemo, useReducer, useRef } from "react";
+import { loadPersistedOnboardingComplete, savePersistedOnboardingComplete, } from "./persistence.js";
+const INITIAL_LIFECYCLE_STATE = {
+    connected: false,
+    agentStatus: null,
+    onboardingComplete: loadPersistedOnboardingComplete(),
+    onboardingUiRevealNonce: 0,
+    onboardingLoading: true,
+    startupPhase: "starting-backend",
+    startupError: null,
+    startupRetryNonce: 0,
+    authRequired: false,
+    actionNotice: null,
+    lifecycleBusy: false,
+    lifecycleAction: null,
+    pendingRestart: false,
+    pendingRestartReasons: [],
+    restartBannerDismissed: false,
+    backendConnection: {
+        state: "disconnected",
+        reconnectAttempt: 0,
+        maxReconnectAttempts: 15,
+        showDisconnectedUI: false,
+    },
+    backendDisconnectedBannerDismissed: false,
+    systemWarnings: [],
+};
+function lifecycleReducer(state, action) {
+    switch (action.type) {
+        case "SET_CONNECTED":
+            return { ...state, connected: action.value };
+        case "SET_AGENT_STATUS":
+            return { ...state, agentStatus: action.value };
+        case "SET_ONBOARDING_COMPLETE":
+            return { ...state, onboardingComplete: action.value };
+        case "INCREMENT_ONBOARDING_REVEAL_NONCE":
+            return {
+                ...state,
+                onboardingUiRevealNonce: state.onboardingUiRevealNonce + 1,
+            };
+        case "SET_ONBOARDING_LOADING":
+            return { ...state, onboardingLoading: action.value };
+        case "SET_STARTUP_PHASE":
+            return { ...state, startupPhase: action.value };
+        case "SET_STARTUP_ERROR":
+            return { ...state, startupError: action.value };
+        case "RETRY_STARTUP":
+            return {
+                ...state,
+                startupError: null,
+                authRequired: false,
+                onboardingLoading: true,
+                startupPhase: "starting-backend",
+                startupRetryNonce: state.startupRetryNonce + 1,
+            };
+        case "SET_AUTH_REQUIRED":
+            return { ...state, authRequired: action.value };
+        case "SET_ACTION_NOTICE":
+            return { ...state, actionNotice: action.value };
+        case "BEGIN_LIFECYCLE":
+            return {
+                ...state,
+                lifecycleBusy: true,
+                lifecycleAction: action.action,
+            };
+        case "FINISH_LIFECYCLE":
+            return { ...state, lifecycleBusy: false, lifecycleAction: null };
+        case "SET_PENDING_RESTART":
+            return {
+                ...state,
+                pendingRestart: action.pending,
+                pendingRestartReasons: action.reasons ?? (action.pending ? state.pendingRestartReasons : []),
+            };
+        case "DISMISS_RESTART_BANNER":
+            return { ...state, restartBannerDismissed: true };
+        case "SHOW_RESTART_BANNER":
+            return { ...state, restartBannerDismissed: false };
+        case "SET_BACKEND_CONNECTION":
+            return {
+                ...state,
+                backendConnection: { ...state.backendConnection, ...action.value },
+                backendDisconnectedBannerDismissed: action.value.state === "failed"
+                    ? state.backendDisconnectedBannerDismissed
+                    : false,
+            };
+        case "DISMISS_BACKEND_BANNER":
+            return { ...state, backendDisconnectedBannerDismissed: true };
+        case "RESET_BACKEND_CONNECTION":
+            return {
+                ...state,
+                backendConnection: {
+                    ...state.backendConnection,
+                    state: "disconnected",
+                    reconnectAttempt: 0,
+                    showDisconnectedUI: false,
+                },
+                backendDisconnectedBannerDismissed: false,
+            };
+        case "ADD_SYSTEM_WARNING": {
+            if (state.systemWarnings.includes(action.warning))
+                return state;
+            return {
+                ...state,
+                systemWarnings: [...state.systemWarnings, action.warning].slice(-50),
+            };
+        }
+        case "DISMISS_SYSTEM_WARNING":
+            return {
+                ...state,
+                systemWarnings: state.systemWarnings.filter((m) => m !== action.message),
+            };
+        case "SET_SYSTEM_WARNINGS":
+            return { ...state, systemWarnings: action.value };
+        default:
+            return state;
+    }
+}
+export function useLifecycleState() {
+    const [state, dispatch] = useReducer(lifecycleReducer, INITIAL_LIFECYCLE_STATE);
+    // Refs for synchronous checks (used by lifecycle actions to avoid race conditions)
+    const lifecycleBusyRef = useRef(false);
+    const lifecycleActionRef = useRef(null);
+    const agentStatusRef = useRef(null);
+    const actionNoticeTimer = useRef(null);
+    const shownOnceNotices = useRef(new Set());
+    // ── Convenience setters ──
+    const setConnected = useCallback((v) => dispatch({ type: "SET_CONNECTED", value: v }), []);
+    const setAgentStatus = useCallback((v) => {
+        agentStatusRef.current = v;
+        dispatch({ type: "SET_AGENT_STATUS", value: v });
+    }, []);
+    const setAgentStatusIfChanged = useCallback((next) => {
+        const prev = agentStatusRef.current;
+        if (prev &&
+            next &&
+            prev.state === next.state &&
+            prev.agentName === next.agentName &&
+            prev.model === next.model &&
+            prev.startedAt === next.startedAt) {
+            return;
+        }
+        agentStatusRef.current = next;
+        dispatch({ type: "SET_AGENT_STATUS", value: next });
+    }, []);
+    const setOnboardingComplete = useCallback((v) => {
+        savePersistedOnboardingComplete(v);
+        dispatch({ type: "SET_ONBOARDING_COMPLETE", value: v });
+    }, []);
+    const incrementOnboardingRevealNonce = useCallback(() => dispatch({ type: "INCREMENT_ONBOARDING_REVEAL_NONCE" }), []);
+    const setOnboardingLoading = useCallback((v) => dispatch({ type: "SET_ONBOARDING_LOADING", value: v }), []);
+    const setStartupPhase = useCallback((v) => dispatch({ type: "SET_STARTUP_PHASE", value: v }), []);
+    const setStartupError = useCallback((v) => dispatch({ type: "SET_STARTUP_ERROR", value: v }), []);
+    const retryStartup = useCallback(() => dispatch({ type: "RETRY_STARTUP" }), []);
+    const setAuthRequired = useCallback((v) => dispatch({ type: "SET_AUTH_REQUIRED", value: v }), []);
+    const setActionNotice = useCallback((text, tone = "info", ttlMs = 2800, once = false, busy = false) => {
+        if (once && shownOnceNotices.current.has(text))
+            return;
+        if (once)
+            shownOnceNotices.current.add(text);
+        dispatch({
+            type: "SET_ACTION_NOTICE",
+            value: { tone, text, ...(busy ? { busy: true } : {}) },
+        });
+        if (actionNoticeTimer.current != null) {
+            window.clearTimeout(actionNoticeTimer.current);
+        }
+        actionNoticeTimer.current = window.setTimeout(() => {
+            dispatch({ type: "SET_ACTION_NOTICE", value: null });
+            actionNoticeTimer.current = null;
+        }, ttlMs);
+    }, []);
+    const beginLifecycleAction = useCallback((action) => {
+        if (lifecycleBusyRef.current)
+            return false;
+        lifecycleBusyRef.current = true;
+        lifecycleActionRef.current = action;
+        dispatch({ type: "BEGIN_LIFECYCLE", action });
+        return true;
+    }, []);
+    const finishLifecycleAction = useCallback(() => {
+        lifecycleBusyRef.current = false;
+        lifecycleActionRef.current = null;
+        dispatch({ type: "FINISH_LIFECYCLE" });
+    }, []);
+    const setPendingRestart = useCallback((pending, reasons) => {
+        dispatch({ type: "SET_PENDING_RESTART", pending, reasons });
+    }, []);
+    const dismissRestartBanner = useCallback(() => dispatch({ type: "DISMISS_RESTART_BANNER" }), []);
+    const showRestartBanner = useCallback(() => dispatch({ type: "SHOW_RESTART_BANNER" }), []);
+    const setBackendConnection = useCallback((v) => {
+        dispatch({ type: "SET_BACKEND_CONNECTION", value: v });
+    }, []);
+    const dismissBackendBanner = useCallback(() => dispatch({ type: "DISMISS_BACKEND_BANNER" }), []);
+    const resetBackendConnection = useCallback(() => dispatch({ type: "RESET_BACKEND_CONNECTION" }), []);
+    const addSystemWarning = useCallback((warning) => {
+        dispatch({ type: "ADD_SYSTEM_WARNING", warning });
+    }, []);
+    const dismissSystemWarning = useCallback((message) => {
+        dispatch({ type: "DISMISS_SYSTEM_WARNING", message });
+    }, []);
+    const setSystemWarnings = useCallback((v) => {
+        dispatch({ type: "SET_SYSTEM_WARNINGS", value: v });
+    }, []);
+    // ── Derived state ──
+    const startupStatus = useMemo(() => {
+        if (state.startupError)
+            return "recoverable-error";
+        if (state.authRequired)
+            return "auth-blocked";
+        if (state.onboardingLoading || state.startupPhase !== "ready")
+            return "loading";
+        if (!state.onboardingComplete)
+            return "onboarding";
+        return "ready";
+    }, [
+        state.authRequired,
+        state.onboardingComplete,
+        state.onboardingLoading,
+        state.startupError,
+        state.startupPhase,
+    ]);
+    return {
+        state,
+        dispatch,
+        setConnected,
+        setAgentStatus,
+        setAgentStatusIfChanged,
+        setOnboardingComplete,
+        incrementOnboardingRevealNonce,
+        setOnboardingLoading,
+        setStartupPhase,
+        setStartupError,
+        retryStartup,
+        setAuthRequired,
+        setActionNotice,
+        beginLifecycleAction,
+        finishLifecycleAction,
+        setPendingRestart,
+        dismissRestartBanner,
+        showRestartBanner,
+        setBackendConnection,
+        dismissBackendBanner,
+        resetBackendConnection,
+        addSystemWarning,
+        dismissSystemWarning,
+        setSystemWarnings,
+        startupStatus,
+        lifecycleBusyRef,
+        lifecycleActionRef,
+        agentStatusRef,
+    };
+}

package/state/useLogsState.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Logs state — extracted from AppContext.
+ *
+ * Manages log entries, sources, tags, and filter state.
+ * The loadLogs callback reads all three filter values from state.
+ */
+import type { LogEntry } from "../api";
+export declare function useLogsState(): {
+    state: {
+        logs: LogEntry[];
+        logSources: string[];
+        logTags: string[];
+        logTagFilter: string;
+        logLevelFilter: string;
+        logSourceFilter: string;
+        logLoadError: string | null;
+    };
+    setLogs: import("react").Dispatch<import("react").SetStateAction<LogEntry[]>>;
+    setLogTagFilter: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setLogLevelFilter: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setLogSourceFilter: import("react").Dispatch<import("react").SetStateAction<string>>;
+    loadLogs: () => Promise<void>;
+};
+//# sourceMappingURL=useLogsState.d.ts.map

package/state/useLogsState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLogsState.d.ts","sourceRoot":"","sources":["../../../../../src/state/useLogsState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAgDvC,wBAAgB,YAAY;;;;;;;;;;;;;;;EA+C3B"}

package/state/useLogsState.js

@@ -0,0 +1,87 @@
+/**
+ * Logs state — extracted from AppContext.
+ *
+ * Manages log entries, sources, tags, and filter state.
+ * The loadLogs callback reads all three filter values from state.
+ */
+import { useCallback, useState } from "react";
+import { client } from "../api/index.js";
+function isLogEntry(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const record = value;
+    return (typeof record.timestamp === "number" &&
+        Number.isFinite(record.timestamp) &&
+        typeof record.level === "string" &&
+        typeof record.message === "string" &&
+        typeof record.source === "string" &&
+        Array.isArray(record.tags) &&
+        record.tags.every((tag) => typeof tag === "string"));
+}
+function isStringArray(value) {
+    return (Array.isArray(value) && value.every((entry) => typeof entry === "string"));
+}
+function normalizeLogsPayload(value) {
+    if (typeof value !== "object" || value === null) {
+        throw new Error("Logs response was not an object.");
+    }
+    const record = value;
+    if (!Array.isArray(record.entries) || !record.entries.every(isLogEntry)) {
+        throw new Error("Logs response contained invalid entries.");
+    }
+    if (!isStringArray(record.sources)) {
+        throw new Error("Logs response contained invalid sources.");
+    }
+    if (!isStringArray(record.tags)) {
+        throw new Error("Logs response contained invalid tags.");
+    }
+    return {
+        entries: record.entries,
+        sources: record.sources,
+        tags: record.tags,
+    };
+}
+export function useLogsState() {
+    const [logs, setLogs] = useState([]);
+    const [logSources, setLogSources] = useState([]);
+    const [logTags, setLogTags] = useState([]);
+    const [logTagFilter, setLogTagFilter] = useState("");
+    const [logLevelFilter, setLogLevelFilter] = useState("");
+    const [logSourceFilter, setLogSourceFilter] = useState("");
+    const [logLoadError, setLogLoadError] = useState(null);
+    const loadLogs = useCallback(async () => {
+        setLogLoadError(null);
+        try {
+            const filter = {};
+            if (logTagFilter)
+                filter.tag = logTagFilter;
+            if (logLevelFilter)
+                filter.level = logLevelFilter;
+            if (logSourceFilter)
+                filter.source = logSourceFilter;
+            const data = normalizeLogsPayload(await client.getLogs(Object.keys(filter).length > 0 ? filter : undefined));
+            setLogs(data.entries);
+            setLogSources(data.sources);
+            setLogTags(data.tags);
+        }
+        catch (err) {
+            setLogLoadError(err instanceof Error ? err.message : "Failed to load logs.");
+        }
+    }, [logTagFilter, logLevelFilter, logSourceFilter]);
+    return {
+        state: {
+            logs,
+            logSources,
+            logTags,
+            logTagFilter,
+            logLevelFilter,
+            logSourceFilter,
+            logLoadError,
+        },
+        setLogs,
+        setLogTagFilter,
+        setLogLevelFilter,
+        setLogSourceFilter,
+        loadLogs,
+    };
+}