@elizaos/agent 2.0.0-alpha.358 → 2.0.0-alpha.376

package/packages/app-core/src/state/shell-routing.d.ts

@@ -0,0 +1,12 @@
+import type { Tab } from "../navigation";
+import type { OnboardingMode, ShellView } from "./types";
+import type { UiShellMode } from "./ui-preferences";
+export declare function deriveUiShellModeForTab(tab: Tab): UiShellMode;
+export declare function getTabForShellView(view: ShellView, lastNativeTab: Tab): Tab;
+export declare function shouldStartAtCharacterSelectOnLaunch(_params: {
+    onboardingNeedsOptions: boolean;
+    onboardingMode: OnboardingMode;
+    navPath: string;
+    urlTab: Tab | null;
+}): boolean;
+//# sourceMappingURL=shell-routing.d.ts.map

package/packages/app-core/src/state/shell-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-routing.d.ts","sourceRoot":"","sources":["../../../../../../app-core/src/state/shell-routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,GAAG,GAAG,WAAW,CAE7D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,GAAG,GAAG,CAiB3E;AAED,wBAAgB,oCAAoC,CAAC,OAAO,EAAE;IAC5D,sBAAsB,EAAE,OAAO,CAAC;IAChC,cAAc,EAAE,cAAc,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;CACpB,GAAG,OAAO,CAEV"}

package/packages/app-core/src/state/shell-routing.js

@@ -0,0 +1,21 @@
+export function deriveUiShellModeForTab(tab) {
+    return tab === "companion" ? "companion" : "native";
+}
+export function getTabForShellView(view, lastNativeTab) {
+    if (view === "companion") {
+        return "companion";
+    }
+    if (view === "character") {
+        return "character";
+    }
+    // Guard against companion-only tabs leaking into native/desktop mode.
+    // lastNativeTab should already be sanitized by normalizeLastNativeTab,
+    // but be defensive: character-select and companion are never valid here.
+    if (lastNativeTab === "character-select" || lastNativeTab === "companion") {
+        return "chat";
+    }
+    return lastNativeTab;
+}
+export function shouldStartAtCharacterSelectOnLaunch(_params) {
+    return false;
+}

package/packages/app-core/src/state/startup-coordinator.d.ts

@@ -0,0 +1,137 @@
+/**
+ * StartupCoordinator — pure state machine for application startup.
+ *
+ * Replaces the implicit state encoded across `startupPhase + authRequired +
+ * onboardingNeedsOptions + startupError` with an explicit state machine.
+ * Side effects (API calls, storage reads) are triggered by the consumer
+ * based on state transitions, not embedded in the machine itself.
+ *
+ * Design principles:
+ * - States are explicit and exhaustive — no boolean flag combinations
+ * - Transitions are pure functions: `(state, event) => state`
+ * - Side effects live outside the machine (in the useEffect that drives it)
+ * - Platform policy is injected, not hardcoded
+ * - Same machine for desktop, web, and mobile — only policy differs
+ */
+import type { StartupErrorReason } from "./types";
+export type RuntimeTarget = "embedded-local" | "remote-backend" | "cloud-managed";
+export interface PlatformPolicy {
+    /** Can this platform run a local embedded agent? */
+    supportsLocalRuntime: boolean;
+    /** Backend poll timeout (ms) — desktop gets longer */
+    backendTimeoutMs: number;
+    /** Agent ready timeout (ms) — initial, before sliding extensions */
+    agentReadyTimeoutMs: number;
+    /** Should we probe for an existing local install on startup? */
+    probeForExistingInstall: boolean;
+    /** Default runtime target when nothing is persisted */
+    defaultTarget: RuntimeTarget | null;
+}
+export type StartupState = {
+    phase: "splash";
+    loaded: boolean;
+} | {
+    phase: "restoring-session";
+} | {
+    phase: "resolving-target";
+    target: RuntimeTarget;
+} | {
+    phase: "polling-backend";
+    target: RuntimeTarget;
+    attempts: number;
+} | {
+    phase: "pairing-required";
+} | {
+    phase: "onboarding-required";
+    /** true = server reachable, fetch options from it. false = first-run, use static options. */
+    serverReachable: boolean;
+} | {
+    phase: "starting-runtime";
+    attempts: number;
+} | {
+    phase: "hydrating";
+} | {
+    phase: "ready";
+} | {
+    phase: "error";
+    reason: StartupErrorReason;
+    message: string;
+    timedOut: boolean;
+};
+export type { StartupErrorReason };
+export type StartupPhaseValue = StartupState["phase"];
+export type StartupEvent = {
+    type: "SESSION_RESTORED";
+    target: RuntimeTarget;
+} | {
+    type: "NO_SESSION";
+    hadPriorOnboarding: boolean;
+} | {
+    type: "EXISTING_INSTALL_DETECTED";
+    target: RuntimeTarget;
+} | {
+    type: "BACKEND_REACHED";
+    onboardingComplete: boolean;
+} | {
+    type: "BACKEND_AUTH_REQUIRED";
+} | {
+    type: "BACKEND_NOT_FOUND";
+} | {
+    type: "BACKEND_TIMEOUT";
+} | {
+    type: "BACKEND_POLL_RETRY";
+} | {
+    type: "ONBOARDING_OPTIONS_LOADED";
+} | {
+    type: "ONBOARDING_COMPLETE";
+} | {
+    type: "AGENT_RUNNING";
+} | {
+    type: "AGENT_STARTING";
+} | {
+    type: "AGENT_ERROR";
+    message: string;
+} | {
+    type: "AGENT_TIMEOUT";
+} | {
+    type: "AGENT_POLL_RETRY";
+} | {
+    type: "HYDRATION_COMPLETE";
+} | {
+    type: "RETRY";
+} | {
+    type: "RESET";
+} | {
+    type: "PAIRING_SUCCESS";
+} | {
+    type: "SPLASH_CONTINUE";
+} | {
+    type: "SPLASH_LOADED";
+} | {
+    type: "SPLASH_CLOUD_SKIP";
+} | {
+    type: "SWITCH_AGENT";
+    target: RuntimeTarget;
+};
+export declare function startupReducer(state: StartupState, event: StartupEvent): StartupState;
+export declare const INITIAL_STARTUP_STATE: StartupState;
+export declare function createDesktopPolicy(): PlatformPolicy;
+export declare function createWebPolicy(): PlatformPolicy;
+export declare function createMobilePolicy(): PlatformPolicy;
+/** Map a restored server-target hint to a RuntimeTarget. */
+export declare function connectionModeToTarget(runMode: string | undefined): RuntimeTarget;
+/** True when the coordinator is in a phase where the UI should show loading. */
+export declare function isStartupLoading(state: StartupState): boolean;
+/** True when the coordinator has reached a terminal phase (ready or error). */
+export declare function isStartupTerminal(state: StartupState): boolean;
+/**
+ * Derive the legacy StartupPhase from the coordinator state.
+ *
+ * NOTE: pairing-required, onboarding-required, error, and hydrating all map
+ * to "ready" — this looks counterintuitive but is correct because App.tsx's
+ * coordinator gate (`startupCoordinator.phase !== "ready"`) catches these
+ * phases BEFORE the legacy startupPhase/startupStatus rendering logic runs.
+ * The legacy "ready" value is a no-op passthrough that never renders.
+ */
+export declare function toLegacyStartupPhase(state: StartupState): "starting-backend" | "initializing-agent" | "ready";
+//# sourceMappingURL=startup-coordinator.d.ts.map

package/packages/app-core/src/state/startup-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-coordinator.d.ts","sourceRoot":"","sources":["../../../../../../app-core/src/state/startup-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAIlD,MAAM,MAAM,aAAa,GACrB,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,oBAAoB,EAAE,OAAO,CAAC;IAC9B,sDAAsD;IACtD,gBAAgB,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,uBAAuB,EAAE,OAAO,CAAC;IACjC,uDAAuD;IACvD,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;CACrC;AAID,MAAM,MAAM,YAAY,GACpB;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACpC;IAAE,KAAK,EAAE,mBAAmB,CAAA;CAAE,GAC9B;IACE,KAAK,EAAE,kBAAkB,CAAC;IAC1B,MAAM,EAAE,aAAa,CAAC;CACvB,GACD;IACE,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IAAE,KAAK,EAAE,kBAAkB,CAAA;CAAE,GAC7B;IACE,KAAK,EAAE,qBAAqB,CAAC;IAC7B,6FAA6F;IAC7F,eAAe,EAAE,OAAO,CAAC;CAC1B,GACD;IACE,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,GACtB;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAClB;IACE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEN,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;AAItD,MAAM,MAAM,YAAY,GAEpB;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,kBAAkB,EAAE,OAAO,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,2BAA2B,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GAG5D;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,kBAAkB,EAAE,OAAO,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,uBAAuB,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC3B;IAAE,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAG9B;IAAE,IAAI,EAAE,2BAA2B,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,qBAAqB,CAAA;CAAE,GAG/B;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,GAG5B;IAAE,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAG9B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC3B;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC3B;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GAGzB;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,GAG7B;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC;AAIpD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,YAAY,GAClB,YAAY,CA4Kd;AAID,eAAO,MAAM,qBAAqB,EAAE,YAGnC,CAAC;AAIF,wBAAgB,mBAAmB,IAAI,cAAc,CAQpD;AAED,wBAAgB,eAAe,IAAI,cAAc,CAQhD;AAED,wBAAgB,kBAAkB,IAAI,cAAc,CAQnD;AAID,4DAA4D;AAC5D,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,aAAa,CASf;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAQ7D;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,YAAY,GAClB,kBAAkB,GAAG,oBAAoB,GAAG,OAAO,CAWrD"}

package/packages/app-core/src/state/startup-coordinator.js

@@ -0,0 +1,250 @@
+/**
+ * StartupCoordinator — pure state machine for application startup.
+ *
+ * Replaces the implicit state encoded across `startupPhase + authRequired +
+ * onboardingNeedsOptions + startupError` with an explicit state machine.
+ * Side effects (API calls, storage reads) are triggered by the consumer
+ * based on state transitions, not embedded in the machine itself.
+ *
+ * Design principles:
+ * - States are explicit and exhaustive — no boolean flag combinations
+ * - Transitions are pure functions: `(state, event) => state`
+ * - Side effects live outside the machine (in the useEffect that drives it)
+ * - Platform policy is injected, not hardcoded
+ * - Same machine for desktop, web, and mobile — only policy differs
+ */
+// ── Reducer ──────────────────────────────────────────────────────────
+export function startupReducer(state, event) {
+    switch (state.phase) {
+        case "splash":
+            switch (event.type) {
+                case "SPLASH_LOADED":
+                    return { phase: "splash", loaded: true };
+                case "SPLASH_CONTINUE":
+                    return { phase: "restoring-session" };
+                case "SPLASH_CLOUD_SKIP":
+                    // Cloud-provisioned containers skip splash + restoring-session
+                    // entirely. Jump straight to polling-backend so the existing
+                    // cloud-aware logic there handles onboarding bypass.
+                    return {
+                        phase: "polling-backend",
+                        target: "cloud-managed",
+                        attempts: 0,
+                    };
+                case "RETRY":
+                    return { phase: "splash", loaded: false };
+                default:
+                    return state;
+            }
+        case "restoring-session":
+            switch (event.type) {
+                case "SESSION_RESTORED":
+                    return { phase: "resolving-target", target: event.target };
+                case "EXISTING_INSTALL_DETECTED":
+                    return { phase: "resolving-target", target: event.target };
+                case "NO_SESSION":
+                    if (event.hadPriorOnboarding) {
+                        return {
+                            phase: "error",
+                            reason: "backend-unreachable",
+                            message: "Previously configured backend is unreachable. Check your connection or reset.",
+                            timedOut: false,
+                        };
+                    }
+                    return { phase: "onboarding-required", serverReachable: false };
+                default:
+                    return state;
+            }
+        case "resolving-target":
+            // Target is set — proceed to backend polling. The effect reads
+            // state.target to configure the client base URL, then dispatches
+            // BACKEND_REACHED or timeout events.
+            return { phase: "polling-backend", target: state.target, attempts: 0 };
+        case "polling-backend":
+            switch (event.type) {
+                case "BACKEND_REACHED":
+                    console.log("[eliza][coordinator] BACKEND_REACHED onboardingComplete:", event.onboardingComplete);
+                    if (event.onboardingComplete) {
+                        console.log("[eliza][coordinator] → starting-runtime (skip onboarding)");
+                        return { phase: "starting-runtime", attempts: 0 };
+                    }
+                    console.log("[eliza][coordinator] → onboarding-required");
+                    return { phase: "onboarding-required", serverReachable: true };
+                case "BACKEND_AUTH_REQUIRED":
+                    return { phase: "pairing-required" };
+                case "BACKEND_NOT_FOUND":
+                    return {
+                        phase: "error",
+                        reason: "backend-unreachable",
+                        message: "Backend returned 404 — check the API base URL.",
+                        timedOut: false,
+                    };
+                case "BACKEND_TIMEOUT":
+                    return {
+                        phase: "error",
+                        reason: "backend-timeout",
+                        message: "Backend did not respond within the timeout period.",
+                        timedOut: true,
+                    };
+                case "BACKEND_POLL_RETRY":
+                    return { ...state, attempts: state.attempts + 1 };
+                default:
+                    return state;
+            }
+        case "pairing-required":
+            switch (event.type) {
+                case "PAIRING_SUCCESS":
+                    return { phase: "restoring-session" };
+                case "RETRY":
+                    return { phase: "restoring-session" };
+                default:
+                    return state;
+            }
+        case "onboarding-required":
+            switch (event.type) {
+                case "ONBOARDING_OPTIONS_LOADED":
+                    return state; // Stay in onboarding — UI handles the wizard
+                case "ONBOARDING_COMPLETE":
+                    return { phase: "starting-runtime", attempts: 0 };
+                case "RETRY":
+                    return { phase: "restoring-session" };
+                default:
+                    return state;
+            }
+        case "starting-runtime":
+            switch (event.type) {
+                case "AGENT_RUNNING":
+                    return { phase: "hydrating" };
+                case "AGENT_STARTING":
+                case "AGENT_POLL_RETRY":
+                    return { ...state, attempts: state.attempts + 1 };
+                case "AGENT_ERROR":
+                    return {
+                        phase: "error",
+                        reason: "agent-error",
+                        message: event.message,
+                        timedOut: false,
+                    };
+                case "AGENT_TIMEOUT":
+                    return {
+                        phase: "error",
+                        reason: "agent-timeout",
+                        message: "Agent did not reach running state within the timeout period.",
+                        timedOut: true,
+                    };
+                case "BACKEND_AUTH_REQUIRED":
+                    return { phase: "pairing-required" };
+                default:
+                    return state;
+            }
+        case "hydrating":
+            switch (event.type) {
+                case "HYDRATION_COMPLETE":
+                    return { phase: "ready" };
+                default:
+                    return state;
+            }
+        case "ready":
+            switch (event.type) {
+                case "RESET":
+                    // Agent reset — return to splash so user can re-onboard
+                    return INITIAL_STARTUP_STATE;
+                case "SWITCH_AGENT":
+                    // Switch to a different agent profile — re-enter polling
+                    return {
+                        phase: "polling-backend",
+                        target: event.target,
+                        attempts: 0,
+                    };
+                default:
+                    return state;
+            }
+        case "error":
+            switch (event.type) {
+                case "RETRY":
+                    return { phase: "restoring-session" };
+                default:
+                    return state;
+            }
+        default:
+            return state;
+    }
+}
+// ── Initial state ────────────────────────────────────────────────────
+export const INITIAL_STARTUP_STATE = {
+    phase: "splash",
+    loaded: false,
+};
+// ── Policy factories ─────────────────────────────────────────────────
+export function createDesktopPolicy() {
+    return {
+        supportsLocalRuntime: true,
+        backendTimeoutMs: 180_000,
+        agentReadyTimeoutMs: 300_000,
+        probeForExistingInstall: true,
+        defaultTarget: "embedded-local",
+    };
+}
+export function createWebPolicy() {
+    return {
+        supportsLocalRuntime: false,
+        backendTimeoutMs: 30_000,
+        agentReadyTimeoutMs: 180_000,
+        probeForExistingInstall: false,
+        defaultTarget: null,
+    };
+}
+export function createMobilePolicy() {
+    return {
+        supportsLocalRuntime: false,
+        backendTimeoutMs: 15_000,
+        agentReadyTimeoutMs: 60_000,
+        probeForExistingInstall: false,
+        defaultTarget: "cloud-managed",
+    };
+}
+// ── Helpers ──────────────────────────────────────────────────────────
+/** Map a restored server-target hint to a RuntimeTarget. */
+export function connectionModeToTarget(runMode) {
+    switch (runMode) {
+        case "cloud":
+            return "cloud-managed";
+        case "remote":
+            return "remote-backend";
+        default:
+            return "embedded-local";
+    }
+}
+/** True when the coordinator is in a phase where the UI should show loading. */
+export function isStartupLoading(state) {
+    return (state.phase === "restoring-session" ||
+        state.phase === "resolving-target" ||
+        state.phase === "polling-backend" ||
+        state.phase === "starting-runtime" ||
+        state.phase === "hydrating");
+}
+/** True when the coordinator has reached a terminal phase (ready or error). */
+export function isStartupTerminal(state) {
+    return state.phase === "ready" || state.phase === "error";
+}
+/**
+ * Derive the legacy StartupPhase from the coordinator state.
+ *
+ * NOTE: pairing-required, onboarding-required, error, and hydrating all map
+ * to "ready" — this looks counterintuitive but is correct because App.tsx's
+ * coordinator gate (`startupCoordinator.phase !== "ready"`) catches these
+ * phases BEFORE the legacy startupPhase/startupStatus rendering logic runs.
+ * The legacy "ready" value is a no-op passthrough that never renders.
+ */
+export function toLegacyStartupPhase(state) {
+    switch (state.phase) {
+        case "restoring-session":
+        case "resolving-target":
+        case "polling-backend":
+            return "starting-backend";
+        case "starting-runtime":
+            return "initializing-agent";
+        default:
+            return "ready";
+    }
+}

package/packages/app-core/src/state/startup-phase-hydrate.d.ts

@@ -0,0 +1,74 @@
+/**
+ * startup-phase-hydrate.ts
+ *
+ * Side-effect logic for the "hydrating" startup phase and the persistent
+ * "ready" phase (WebSocket bindings, nav listener).
+ */
+import type { AgentStatus, WalletAddresses } from "../api";
+import { type CodingAgentSession, type Conversation, type ConversationMessage, type StreamEventEnvelope } from "../api";
+import { type Tab } from "../navigation";
+import type { StartupEvent } from "./startup-coordinator";
+import type { OnboardingMode } from "./types";
+export interface HydratingDeps {
+    setStartupError: (v: null) => void;
+    setOnboardingLoading: (v: boolean) => void;
+    hydrateInitialConversationState: () => Promise<string | null>;
+    requestGreetingWhenRunningRef: React.RefObject<(convId: string) => Promise<void>>;
+    loadWorkbench: () => Promise<void>;
+    loadPlugins: () => Promise<void>;
+    loadSkills: () => Promise<void>;
+    loadCharacter: () => Promise<void>;
+    loadWalletConfig: () => Promise<void>;
+    loadInventory: () => Promise<void>;
+    loadUpdateStatus: (force?: boolean) => Promise<void>;
+    checkExtensionStatus: () => Promise<void>;
+    pollCloudCredits: () => void;
+    fetchAutonomyReplay: () => Promise<void>;
+    setSelectedVrmIndex: (v: number) => void;
+    setCustomVrmUrl: (v: string) => void;
+    setCustomBackgroundUrl: (v: string) => void;
+    setWalletAddresses: (v: WalletAddresses) => void;
+    setTab: (t: Tab) => void;
+    setTabRaw: (t: Tab) => void;
+    onboardingCompletionCommittedRef: React.MutableRefObject<boolean>;
+    initialTabSetRef: React.MutableRefObject<boolean>;
+    onboardingMode: OnboardingMode;
+}
+export interface ReadyPhaseDeps {
+    setAgentStatusIfChanged: (v: AgentStatus) => void;
+    setPendingRestart: (v: boolean | ((prev: boolean) => boolean)) => void;
+    setPendingRestartReasons: (v: string[] | ((prev: string[]) => string[])) => void;
+    setSystemWarnings: (v: string[] | ((prev: string[]) => string[])) => void;
+    showRestartBanner: () => void;
+    setPtySessions: (v: CodingAgentSession[] | ((prev: CodingAgentSession[]) => CodingAgentSession[])) => void;
+    /** Ref whose .current is true when there are active PTY sessions. */
+    hasPtySessionsRef: React.MutableRefObject<boolean>;
+    setTabRaw: (t: Tab) => void;
+    setConversationMessages: (v: ConversationMessage[] | ((prev: ConversationMessage[]) => ConversationMessage[])) => void;
+    setUnreadConversations: (v: Set<string> | ((prev: Set<string>) => Set<string>)) => void;
+    setConversations: (v: Conversation[] | ((prev: Conversation[]) => Conversation[])) => void;
+    appendAutonomousEvent: (event: StreamEventEnvelope) => void;
+    notifyAssistantEvent: (event: StreamEventEnvelope) => void;
+    notifyHeartbeatEvent: (event: StreamEventEnvelope) => void;
+    loadPlugins: () => Promise<void>;
+    loadWalletConfig: () => Promise<void>;
+    pollCloudCredits: () => void;
+    activeConversationIdRef: React.RefObject<string | null>;
+    elizaCloudPollInterval: React.MutableRefObject<number | null>;
+    elizaCloudLoginPollTimer: React.MutableRefObject<number | null>;
+}
+/**
+ * Runs the hydrating phase.
+ * Loads initial conversation state, wallet, avatar, plugins, and sets the tab.
+ * Dispatches HYDRATION_COMPLETE when done.
+ */
+export declare function runHydrating(deps: HydratingDeps, dispatch: (event: StartupEvent) => void, cancelled: {
+    current: boolean;
+}): Promise<void>;
+/**
+ * Sets up persistent WebSocket bindings and the navigation listener.
+ * Returns a cleanup function that unbinds everything.
+ * Should be called once when the coordinator first reaches "ready".
+ */
+export declare function bindReadyPhase(depsRef: React.MutableRefObject<ReadyPhaseDeps | undefined>): () => void;
+//# sourceMappingURL=startup-phase-hydrate.d.ts.map

package/packages/app-core/src/state/startup-phase-hydrate.d.ts.map

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