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

package/state/useMiscUiState.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Miscellaneous UI state — extracted from AppContext.
+ *
+ * Covers three loosely-coupled UI domains that don't warrant their
+ * own dedicated hook files:
+ *
+ *  - MCP: configured servers, statuses, marketplace flow
+ *  - Games: active game iframe state and overlay flag
+ *  - UI chrome: command palette, emote picker, dropped files
+ */
+import type { AppRunSummary, AppSessionState, McpMarketplaceResult, McpRegistryServerDetail, McpServerConfig, McpServerStatus } from "../api";
+/**
+ * Currently-selected connector chat in the messages sidebar.
+ * When non-null, ChatView swaps its main panel out for a read-only
+ * view of that room's inbox messages (rendered via `/api/inbox/
+ * messages?roomId=…`). Mutually exclusive with a live dashboard
+ * conversation — the sidebar clears one when selecting the other.
+ */
+export interface ActiveInboxChat {
+    avatarUrl?: string;
+    canSend?: boolean;
+    id: string;
+    source: string;
+    transportSource?: string;
+    title: string;
+    worldId?: string;
+    worldLabel?: string;
+}
+export declare function useMiscUiState(): {
+    state: {
+        analysisMode: boolean;
+        commandPaletteOpen: boolean;
+        commandQuery: string;
+        commandActiveIndex: number;
+        emotePickerOpen: boolean;
+        mcpConfiguredServers: Record<string, McpServerConfig>;
+        mcpServerStatuses: McpServerStatus[];
+        mcpMarketplaceQuery: string;
+        mcpMarketplaceResults: McpMarketplaceResult[];
+        mcpMarketplaceLoading: boolean;
+        mcpAction: string;
+        mcpAddingServer: McpRegistryServerDetail | null;
+        mcpAddingResult: McpMarketplaceResult | null;
+        mcpEnvInputs: Record<string, string>;
+        mcpHeaderInputs: Record<string, string>;
+        droppedFiles: string[];
+        shareIngestNotice: string;
+        appRuns: AppRunSummary[];
+        activeGameRunId: string;
+        activeGameApp: string;
+        activeGameDisplayName: string;
+        activeGameViewerUrl: string;
+        activeGameSandbox: string;
+        activeGamePostMessageAuth: boolean;
+        activeGamePostMessagePayload: import("@elizaos/shared").AppViewerAuthMessage | null;
+        activeGameSession: AppSessionState | null;
+        gameOverlayEnabled: boolean;
+        companionAppRunning: boolean;
+        activeOverlayApp: string | null;
+        activeInboxChat: ActiveInboxChat | null;
+        activeTerminalSessionId: string | null;
+    };
+    setActiveInboxChat: import("react").Dispatch<import("react").SetStateAction<ActiveInboxChat | null>>;
+    setActiveTerminalSessionId: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    setAnalysisMode: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setCommandQuery: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setCommandActiveIndex: import("react").Dispatch<import("react").SetStateAction<number>>;
+    setEmotePickerOpen: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setMcpConfiguredServers: import("react").Dispatch<import("react").SetStateAction<Record<string, McpServerConfig>>>;
+    setMcpServerStatuses: import("react").Dispatch<import("react").SetStateAction<McpServerStatus[]>>;
+    setMcpMarketplaceQuery: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setMcpMarketplaceResults: import("react").Dispatch<import("react").SetStateAction<McpMarketplaceResult[]>>;
+    setMcpMarketplaceLoading: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setMcpAction: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setMcpAddingServer: import("react").Dispatch<import("react").SetStateAction<McpRegistryServerDetail | null>>;
+    setMcpAddingResult: import("react").Dispatch<import("react").SetStateAction<McpMarketplaceResult | null>>;
+    setMcpEnvInputs: import("react").Dispatch<import("react").SetStateAction<Record<string, string>>>;
+    setMcpHeaderInputs: import("react").Dispatch<import("react").SetStateAction<Record<string, string>>>;
+    setDroppedFiles: import("react").Dispatch<import("react").SetStateAction<string[]>>;
+    setShareIngestNotice: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setAppRuns: import("react").Dispatch<import("react").SetStateAction<AppRunSummary[]>>;
+    setActiveGameRunId: (id: string) => void;
+    setGameOverlayEnabled: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setActiveOverlayApp: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    closeCommandPalette: () => void;
+    openEmotePicker: () => void;
+    closeEmotePicker: () => void;
+};
+//# sourceMappingURL=useMiscUiState.d.ts.map

package/state/useMiscUiState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMiscUiState.d.ts","sourceRoot":"","sources":["../../../../../src/state/useMiscUiState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,EACf,eAAe,EAChB,MAAM,QAAQ,CAAC;AAEhB;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BA4CgB,MAAM;;;;;;EA+HnD"}

package/state/useMiscUiState.js

@@ -0,0 +1,154 @@
+/**
+ * Miscellaneous UI state — extracted from AppContext.
+ *
+ * Covers three loosely-coupled UI domains that don't warrant their
+ * own dedicated hook files:
+ *
+ *  - MCP: configured servers, statuses, marketplace flow
+ *  - Games: active game iframe state and overlay flag
+ *  - UI chrome: command palette, emote picker, dropped files
+ */
+import { useCallback, useEffect, useMemo, useState } from "react";
+export function useMiscUiState() {
+    // ── Command palette ────────────────────────────────────────────────
+    const [commandPaletteOpen, _setCommandPaletteOpen] = useState(false);
+    const [commandQuery, setCommandQuery] = useState("");
+    const [commandActiveIndex, setCommandActiveIndex] = useState(0);
+    // ── Emote picker ───────────────────────────────────────────────────
+    const [emotePickerOpen, setEmotePickerOpen] = useState(false);
+    // ── MCP ────────────────────────────────────────────────────────────
+    const [mcpConfiguredServers, setMcpConfiguredServers] = useState({});
+    const [mcpServerStatuses, setMcpServerStatuses] = useState([]);
+    const [mcpMarketplaceQuery, setMcpMarketplaceQuery] = useState("");
+    const [mcpMarketplaceResults, setMcpMarketplaceResults] = useState([]);
+    const [mcpMarketplaceLoading, setMcpMarketplaceLoading] = useState(false);
+    const [mcpAction, setMcpAction] = useState("");
+    const [mcpAddingServer, setMcpAddingServer] = useState(null);
+    const [mcpAddingResult, setMcpAddingResult] = useState(null);
+    const [mcpEnvInputs, setMcpEnvInputs] = useState({});
+    const [mcpHeaderInputs, setMcpHeaderInputs] = useState({});
+    // ── Share ingest / dropped files ───────────────────────────────────
+    const [droppedFiles, setDroppedFiles] = useState([]);
+    const [shareIngestNotice, setShareIngestNotice] = useState("");
+    // ── Game ───────────────────────────────────────────────────────────
+    const [appRuns, setAppRuns] = useState([]);
+    const [activeGameRunId, setActiveGameRunIdRaw] = useState(() => {
+        try {
+            return sessionStorage.getItem("eliza:activeGameRunId") ?? "";
+        }
+        catch {
+            return "";
+        }
+    });
+    const setActiveGameRunId = useCallback((id) => {
+        setActiveGameRunIdRaw(id);
+        try {
+            if (id)
+                sessionStorage.setItem("eliza:activeGameRunId", id);
+            else
+                sessionStorage.removeItem("eliza:activeGameRunId");
+        }
+        catch {
+            /* ignore */
+        }
+    }, []);
+    const [gameOverlayEnabled, setGameOverlayEnabled] = useState(false);
+    const [activeOverlayApp, setActiveOverlayApp] = useState(null);
+    const companionAppRunning = activeOverlayApp === "@elizaos/app-companion";
+    const activeGameRun = useMemo(() => appRuns.find((run) => run.runId === activeGameRunId) ?? null, [activeGameRunId, appRuns]);
+    const activeGameApp = activeGameRun?.appName ?? "";
+    const activeGameDisplayName = activeGameRun?.displayName ?? "";
+    const activeGameViewerUrl = activeGameRun?.viewer?.url ?? "";
+    const activeGameSandbox = activeGameRun?.viewer?.sandbox ??
+        "allow-scripts allow-same-origin allow-popups";
+    const activeGamePostMessageAuth = Boolean(activeGameRun?.viewer?.postMessageAuth);
+    const activeGamePostMessagePayload = activeGameRun?.viewer?.authMessage ?? null;
+    const activeGameSession = activeGameRun?.session ?? null;
+    useEffect(() => {
+        if (!activeGameRunId)
+            return;
+        if (appRuns.some((run) => run.runId === activeGameRunId))
+            return;
+        setActiveGameRunId("");
+    }, [activeGameRunId, appRuns, setActiveGameRunId]);
+    // ── Messages sidebar ───────────────────────────────────────
+    const [activeInboxChat, setActiveInboxChat] = useState(null);
+    // ── Terminal channel ───────────────────────────────────────────────
+    // Selected PTY session id when the Terminal channel is active.
+    // Mutually exclusive with activeInboxChat / activeConversationId.
+    const [activeTerminalSessionId, setActiveTerminalSessionId] = useState(null);
+    // ── Callbacks ──────────────────────────────────────────────────────
+    const closeCommandPalette = useCallback(() => {
+        _setCommandPaletteOpen(false);
+        setCommandQuery("");
+        setCommandActiveIndex(0);
+    }, []);
+    const openEmotePicker = useCallback(() => {
+        setEmotePickerOpen(true);
+    }, []);
+    const closeEmotePicker = useCallback(() => {
+        setEmotePickerOpen(false);
+    }, []);
+    // ── Analysis Mode ───────────────────────────────────────────────────
+    const [analysisMode, setAnalysisMode] = useState(false);
+    return {
+        state: {
+            analysisMode,
+            commandPaletteOpen,
+            commandQuery,
+            commandActiveIndex,
+            emotePickerOpen,
+            mcpConfiguredServers,
+            mcpServerStatuses,
+            mcpMarketplaceQuery,
+            mcpMarketplaceResults,
+            mcpMarketplaceLoading,
+            mcpAction,
+            mcpAddingServer,
+            mcpAddingResult,
+            mcpEnvInputs,
+            mcpHeaderInputs,
+            droppedFiles,
+            shareIngestNotice,
+            appRuns,
+            activeGameRunId,
+            activeGameApp,
+            activeGameDisplayName,
+            activeGameViewerUrl,
+            activeGameSandbox,
+            activeGamePostMessageAuth,
+            activeGamePostMessagePayload,
+            activeGameSession,
+            gameOverlayEnabled,
+            companionAppRunning,
+            activeOverlayApp,
+            activeInboxChat,
+            activeTerminalSessionId,
+        },
+        setActiveInboxChat,
+        setActiveTerminalSessionId,
+        setAnalysisMode,
+        setCommandQuery,
+        setCommandActiveIndex,
+        setEmotePickerOpen,
+        setMcpConfiguredServers,
+        setMcpServerStatuses,
+        setMcpMarketplaceQuery,
+        setMcpMarketplaceResults,
+        setMcpMarketplaceLoading,
+        setMcpAction,
+        setMcpAddingServer,
+        setMcpAddingResult,
+        setMcpEnvInputs,
+        setMcpHeaderInputs,
+        setDroppedFiles,
+        setShareIngestNotice,
+        setAppRuns,
+        setActiveGameRunId,
+        setGameOverlayEnabled,
+        setActiveOverlayApp,
+        closeCommandPalette,
+        openEmotePicker,
+        closeEmotePicker,
+    };
+}

package/state/useNavigationState.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Navigation state — extracted from AppContext.
+ *
+ * Owns: setTab wrappers, switchShellView, switchUiShellMode, setUiShellMode,
+ * tab commit effects, uiShellMode persist, lastNativeTab persist,
+ * tabFromPath logic, and the NavigationEventHub.
+ */
+import { type Tab } from "../navigation";
+import { type ShellView, type TabCommittedDetail, type UiShellMode } from "./internal";
+export interface NavigationStateDeps {
+    tab: Tab;
+    setTabRaw: (t: Tab) => void;
+    uiShellMode: UiShellMode;
+    hasActiveGameRun: boolean;
+    setAppsSubTab: (value: "browse" | "running" | "games") => void;
+}
+export declare function useNavigationState(deps: NavigationStateDeps): {
+    lastNativeTab: Tab;
+    setLastNativeTabState: import("react").Dispatch<import("react").SetStateAction<Tab>>;
+    setTab: (newTab: Tab) => void;
+    setUiShellMode: (mode: UiShellMode) => void;
+    switchUiShellMode: (mode: UiShellMode) => void;
+    switchShellView: (view: ShellView) => void;
+    navigation: {
+        subscribeTabCommitted: (listener: (detail: TabCommittedDetail) => void) => (() => void);
+        scheduleAfterTabCommit: (fn: () => void) => void;
+    };
+};
+//# sourceMappingURL=useNavigationState.d.ts.map

package/state/useNavigationState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNavigationState.d.ts","sourceRoot":"","sources":["../../../../../src/state/useNavigationState.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,EAAuC,KAAK,GAAG,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAGL,KAAK,SAAS,EAGd,KAAK,kBAAkB,EACvB,KAAK,WAAW,EACjB,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,GAAG,CAAC;IACT,SAAS,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAC5B,WAAW,EAAE,WAAW,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,KAAK,IAAI,CAAC;CAChE;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,mBAAmB;;;qBAmB/C,GAAG;2BAsBL,WAAW;8BAoBX,WAAW;4BAeX,SAAS;;0CA8BF,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,KAC7C,CAAC,MAAM,IAAI,CAAC;qCAb6B,MAAM,IAAI;;EAqD3D"}

package/state/useNavigationState.js

@@ -0,0 +1,122 @@
+/**
+ * Navigation state — extracted from AppContext.
+ *
+ * Owns: setTab wrappers, switchShellView, switchUiShellMode, setUiShellMode,
+ * tab commit effects, uiShellMode persist, lastNativeTab persist,
+ * tabFromPath logic, and the NavigationEventHub.
+ */
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState, } from "react";
+import { pathForTab, shouldUseHashNavigation } from "../navigation/index.js";
+import { loadLastNativeTab, normalizeUiShellMode, saveLastNativeTab, saveUiShellMode, } from "./internal.js";
+import { NavigationEventHub } from "./navigation-events.js";
+import { getTabForShellView } from "./shell-routing.js";
+// ── Hook ──────────────────────────────────────────────────────────────────
+export function useNavigationState(deps) {
+    const { tab, setTabRaw, uiShellMode, hasActiveGameRun, setAppsSubTab } = deps;
+    const [lastNativeTab, setLastNativeTabState] = useState(loadLastNativeTab);
+    // ── Persist side effects ────────────────────────────────────────────
+    useEffect(() => {
+        saveUiShellMode(uiShellMode);
+    }, [uiShellMode]);
+    useEffect(() => {
+        saveLastNativeTab(lastNativeTab);
+    }, [lastNativeTab]);
+    // ── setTab (with URL sync) ──────────────────────────────────────────
+    const setTab = useCallback((newTab) => {
+        setTabRaw(newTab);
+        if (newTab === "apps") {
+            setAppsSubTab(hasActiveGameRun ? "games" : "browse");
+        }
+        const path = pathForTab(newTab);
+        try {
+            if (shouldUseHashNavigation()) {
+                window.location.hash = path;
+            }
+            else {
+                window.history.pushState(null, "", path);
+            }
+        }
+        catch (err) {
+            console.warn("[eliza][nav] failed to update browser location", err);
+        }
+    }, [hasActiveGameRun, setTabRaw, setAppsSubTab]);
+    // ── Shell mode toggles ──────────────────────────────────────────────
+    const setUiShellMode = useCallback((mode) => {
+        const nextMode = normalizeUiShellMode(mode);
+        if (nextMode === "companion") {
+            setTab("companion");
+            return;
+        }
+        setTab(lastNativeTab);
+    }, [lastNativeTab, setTab]);
+    useEffect(() => {
+        // Remember all tabs except companion (which is now an app overlay, not a nav tab).
+        if (tab === "companion") {
+            return;
+        }
+        setLastNativeTabState((prev) => (prev === tab ? prev : tab));
+    }, [tab]);
+    const switchUiShellMode = useCallback((mode) => {
+        const nextMode = normalizeUiShellMode(mode);
+        if (nextMode === uiShellMode) {
+            return;
+        }
+        if (nextMode === "native") {
+            setTab(lastNativeTab);
+            return;
+        }
+        setTab("companion");
+    }, [lastNativeTab, setTab, uiShellMode]);
+    const switchShellView = useCallback((view) => {
+        const nextTab = getTabForShellView(view, lastNativeTab);
+        console.log(`[shell] switchShellView: ${view} → tab=${nextTab}, lastNativeTab=${lastNativeTab}`);
+        setTab(nextTab);
+    }, [lastNativeTab, setTab]);
+    // ── Tab commit events ───────────────────────────────────────────────
+    const navigationHubRef = useRef(new NavigationEventHub());
+    const pendingPostTabCommitRef = useRef([]);
+    const prevTabCommittedRef = useRef(null);
+    const prevUiShellCommittedRef = useRef(null);
+    const [_tabCommitFlushNonce, setTabCommitFlushNonce] = useState(0);
+    const scheduleAfterTabCommit = useCallback((fn) => {
+        pendingPostTabCommitRef.current.push(fn);
+        if (pendingPostTabCommitRef.current.length === 1) {
+            queueMicrotask(() => {
+                setTabCommitFlushNonce((n) => n + 1);
+            });
+        }
+    }, []);
+    const navigation = useMemo(() => ({
+        subscribeTabCommitted: (listener) => navigationHubRef.current.subscribe(listener),
+        scheduleAfterTabCommit,
+    }), [scheduleAfterTabCommit]);
+    useLayoutEffect(() => {
+        const tabChanged = prevTabCommittedRef.current !== tab;
+        const shellChanged = prevUiShellCommittedRef.current !== uiShellMode;
+        const pending = pendingPostTabCommitRef.current;
+        pendingPostTabCommitRef.current = [];
+        if (tabChanged || shellChanged) {
+            const previousTab = prevTabCommittedRef.current;
+            prevTabCommittedRef.current = tab;
+            prevUiShellCommittedRef.current = uiShellMode;
+            navigationHubRef.current.emit({ tab, previousTab, uiShellMode });
+        }
+        for (const task of pending) {
+            try {
+                task();
+            }
+            catch (err) {
+                console.warn("[eliza][navigation] scheduleAfterTabCommit task failed", err);
+            }
+        }
+    }, [tab, uiShellMode]);
+    return {
+        lastNativeTab,
+        setLastNativeTabState,
+        setTab,
+        setUiShellMode,
+        switchUiShellMode,
+        switchShellView,
+        navigation,
+    };
+}

package/state/useOnboardingCallbacks.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Onboarding callbacks — extracted from AppContext.
+ *
+ * Holds all the callback functions for the onboarding flow:
+ * completeOnboarding, runOnboardingChatHandoff, handleOnboardingFinish,
+ * advanceOnboarding / handleOnboardingNext, revertOnboarding /
+ * handleOnboardingBack, handleOnboardingJumpToStep, goToOnboardingStep,
+ * applyResetConnectionWizardToHostingStep, handleCloudOnboardingFinish,
+ * handleOnboardingUseLocalBackend, handleOnboardingRemoteConnect,
+ * and applyDetectedProviders.
+ */
+import { type RefObject } from "react";
+import type { StylePreset } from "../api";
+import { ElizaClient, type VoiceConfig } from "../api";
+import { type scanProviderCredentials } from "../bridge";
+import type { UiLanguage } from "../i18n";
+import { type Tab } from "../navigation";
+import { type OnboardingNextOptions } from "./internal";
+import type { AppState, CompleteOnboardingOptions, OnboardingStep } from "./types";
+import type { OnboardingStateHook } from "./useOnboardingState";
+export declare function buildOnboardingStyleVoiceConfig(args: {
+    style: StylePreset | undefined;
+    voiceProvider: string;
+    voiceApiKey: string;
+    cloudTtsSelected: boolean;
+}): VoiceConfig | null;
+export declare function buildOnboardingFeatureSubmitPayload(args: {
+    onboardingFeatureTelegram: boolean;
+    onboardingFeatureDiscord: boolean;
+    onboardingFeatureBrowser: boolean;
+    onboardingFeatureComputerUse: boolean;
+}): {
+    connectors?: Record<string, {
+        enabled: true;
+        managed: true;
+    }>;
+    features?: Record<string, {
+        enabled: true;
+    }>;
+};
+export interface OnboardingCallbacksDeps {
+    /** Full result of useOnboardingState — state + all dispatch helpers. */
+    onboarding: OnboardingStateHook;
+    setActiveOverlayApp: (appName: string | null) => void;
+    /**
+     * Compat setter functions that already wrap onboarding.setField / dispatch.
+     * Passed in from AppContext so we don't duplicate them here.
+     */
+    setOnboardingStep: (step: OnboardingStep) => void;
+    setOnboardingMode: (v: AppState["onboardingMode"]) => void;
+    setOnboardingActiveGuide: (v: string | null) => void;
+    addDeferredOnboardingTask: (task: string) => void;
+    setOnboardingDetectedProviders: (v: AppState["onboardingDetectedProviders"]) => void;
+    setOnboardingServerTarget: (v: AppState["onboardingServerTarget"]) => void;
+    setOnboardingCloudApiKey: (v: string) => void;
+    setOnboardingProvider: (v: string) => void;
+    setOnboardingApiKey: (v: string) => void;
+    setOnboardingPrimaryModel: (v: string) => void;
+    setOnboardingRemoteApiBase: (v: string) => void;
+    setOnboardingRemoteToken: (v: string) => void;
+    setOnboardingRemoteConnecting: (v: boolean) => void;
+    setOnboardingRemoteError: (v: string | null) => void;
+    setOnboardingRemoteConnected: (v: boolean) => void;
+    setPostOnboardingChecklistDismissed: (v: boolean) => void;
+    setBrowserEnabled?: (v: boolean) => void;
+    setComputerUseEnabled?: (v: boolean) => void;
+    setWalletEnabled?: (v: boolean) => void;
+    /** Lifecycle / global */
+    setOnboardingComplete: (v: boolean) => void;
+    coordinatorOnboardingCompleteRef: RefObject<(() => void) | null>;
+    initialTabSetRef: RefObject<boolean>;
+    setTab: (tab: Tab) => void;
+    defaultLandingTab: Tab;
+    loadCharacter: () => Promise<void>;
+    uiLanguage: UiLanguage;
+    selectedVrmIndex: number;
+    walletConfig: AppState["walletConfig"];
+    elizaCloudConnected: boolean;
+    setActionNotice: (text: string, tone?: "info" | "success" | "error", ttlMs?: number) => void;
+    retryStartup: () => void;
+    forceLocalBootstrapRef: RefObject<boolean>;
+    client: ElizaClient;
+}
+export declare function useOnboardingCallbacks(deps: OnboardingCallbacksDeps): {
+    completeOnboarding: (landingTab?: Tab, options?: CompleteOnboardingOptions) => void;
+    runOnboardingChatHandoff: (options?: OnboardingNextOptions) => Promise<void>;
+    handleOnboardingFinish: (options?: OnboardingNextOptions) => Promise<void>;
+    goToOnboardingStep: (step: OnboardingStep) => void;
+    applyResetConnectionWizardToHostingStep: () => void;
+    advanceOnboarding: (options?: OnboardingNextOptions) => Promise<void>;
+    handleOnboardingNext: (options?: OnboardingNextOptions) => Promise<void>;
+    revertOnboarding: () => void;
+    handleOnboardingBack: () => void;
+    handleOnboardingJumpToStep: (target: OnboardingStep) => void;
+    handleOnboardingUseLocalBackend: () => void;
+    handleOnboardingRemoteConnect: () => Promise<void>;
+    handleCloudOnboardingFinish: () => Promise<void>;
+    applyDetectedProviders: (detected: Awaited<ReturnType<typeof scanProviderCredentials>>) => void;
+};
+//# sourceMappingURL=useOnboardingCallbacks.d.ts.map

package/state/useOnboardingCallbacks.d.ts.map

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