@elizaos/agent 2.0.0-alpha.520 → 2.0.0-alpha.521

package/packages/app-core/src/state/startup-phase-poll.js

@@ -1,272 +0,0 @@
-/**
- * startup-phase-poll.ts
- *
- * Side-effect logic for the "polling-backend" startup phase.
- * Polls the backend until it responds, then dispatches BACKEND_REACHED
- * or an appropriate error/auth event.
- */
-import { logger } from "@elizaos/core";
-import { getStylePresets } from "@elizaos/shared";
-import { client } from "../api";
-import { getBackendStartupTimeoutMs, isElectrobunRuntime, scanProviderCredentials, } from "../bridge";
-import { asApiLikeError, clearPersistedOnboardingStep, deriveOnboardingResumeFieldsFromConfig, formatStartupErrorDetail, inferOnboardingResumeStep, } from "./internal";
-import { loadPersistedOnboardingStep, savePersistedActiveServer, } from "./persistence";
-/** Apply resume fields derived from a partial config to the onboarding state. */
-function applyOnboardingResumeFields(rf, deps) {
-    if (rf.onboardingServerTarget !== undefined)
-        deps.setOnboardingServerTarget(rf.onboardingServerTarget);
-    if (rf.onboardingCloudApiKey !== undefined)
-        deps.setOnboardingCloudApiKey(rf.onboardingCloudApiKey);
-    if (rf.onboardingProvider !== undefined)
-        deps.setOnboardingProvider(rf.onboardingProvider);
-    if (rf.onboardingVoiceProvider !== undefined)
-        deps.setOnboardingVoiceProvider(rf.onboardingVoiceProvider);
-    if (rf.onboardingApiKey !== undefined)
-        deps.setOnboardingApiKey(rf.onboardingApiKey);
-    if (rf.onboardingPrimaryModel !== undefined)
-        deps.setOnboardingPrimaryModel(rf.onboardingPrimaryModel);
-    if (rf.onboardingOpenRouterModel !== undefined)
-        deps.setOnboardingOpenRouterModel(rf.onboardingOpenRouterModel);
-    if (rf.onboardingRemoteConnected !== undefined)
-        deps.setOnboardingRemoteConnected(rf.onboardingRemoteConnected);
-    if (rf.onboardingRemoteApiBase !== undefined)
-        deps.setOnboardingRemoteApiBase(rf.onboardingRemoteApiBase);
-    if (rf.onboardingRemoteToken !== undefined)
-        deps.setOnboardingRemoteToken(rf.onboardingRemoteToken);
-    if (rf.onboardingSmallModel !== undefined)
-        deps.setOnboardingSmallModel(rf.onboardingSmallModel);
-    if (rf.onboardingLargeModel !== undefined)
-        deps.setOnboardingLargeModel(rf.onboardingLargeModel);
-}
-/**
- * Runs the polling-backend phase.
- * Polls /auth/status and /onboarding/status until the backend is reachable
- * and onboarding state is determined.
- *
- * @param deps - Coordinator dependency bag
- * @param dispatch - startupReducer dispatch
- * @param policy - Platform policy (timeout etc.)
- * @param ctx - Session context populated by the restoring-session phase
- * @param effectRunId - The run ID of the calling effect (for stale-close guard)
- * @param effectRunRef - Shared ref tracking the latest run ID
- * @param cancelled - Ref-flag set true by the cleanup function
- * @param tidRef - Mutable ref for the pending setTimeout handle (for cleanup)
- */
-export async function runPollingBackend(deps, dispatch, policy, ctx, effectRunId, effectRunRef, cancelled, tidRef) {
-    const describeBackendFailure = (err, timedOut) => {
-        const apiErr = asApiLikeError(err);
-        if (apiErr?.kind === "http" && apiErr.status === 404)
-            return {
-                reason: "backend-unreachable",
-                phase: "starting-backend",
-                message: "Backend API routes are unavailable on this origin (received 404).",
-                detail: formatStartupErrorDetail(err),
-                status: apiErr.status,
-                path: apiErr.path,
-            };
-        if (timedOut || apiErr?.kind === "timeout")
-            return {
-                reason: "backend-timeout",
-                phase: "starting-backend",
-                message: `Backend did not become reachable within ${Math.round(getBackendStartupTimeoutMs() / 1000)}s.`,
-                detail: formatStartupErrorDetail(err),
-                status: apiErr?.status,
-                path: apiErr?.path,
-            };
-        return {
-            reason: "backend-unreachable",
-            phase: "starting-backend",
-            message: "Failed to reach backend during startup.",
-            detail: formatStartupErrorDetail(err),
-            status: apiErr?.status,
-            path: apiErr?.path,
-        };
-    };
-    const deadline = Date.now() + policy.backendTimeoutMs;
-    let attempts = 0;
-    let lastErr = null;
-    let latestAuth = {
-        required: false,
-        pairingEnabled: false,
-        expiresAt: null,
-    };
-    while (!cancelled.current && effectRunRef.current === effectRunId) {
-        if (Date.now() >= deadline) {
-            deps.setStartupError(describeBackendFailure(lastErr, true));
-            deps.setOnboardingLoading(false);
-            dispatch({ type: "BACKEND_TIMEOUT" });
-            return;
-        }
-        try {
-            const auth = await client.getAuthStatus();
-            latestAuth = auth;
-            if (cancelled.current)
-                return;
-            if (auth.required && !client.hasToken()) {
-                if (auth.loginRequired) {
-                    deps.setAuthRequired(false);
-                    deps.setOnboardingComplete(true);
-                    deps.setOnboardingLoading(false);
-                    dispatch({ type: "BACKEND_REACHED", onboardingComplete: true });
-                    return;
-                }
-                deps.setAuthRequired(true);
-                deps.setPairingEnabled(auth.pairingEnabled);
-                deps.setPairingExpiresAt(auth.expiresAt);
-                deps.setOnboardingLoading(false);
-                dispatch({ type: "BACKEND_AUTH_REQUIRED" });
-                return;
-            }
-            const onboardingStatusRes = await client.getOnboardingStatus();
-            const { complete, cloudProvisioned } = onboardingStatusRes;
-            if (cancelled.current)
-                return;
-            deps.setOnboardingCloudProvisionedContainer(Boolean(cloudProvisioned));
-            let sessionComplete = complete ||
-                deps.onboardingCompletionCommittedRef.current ||
-                (ctx?.shouldPreserveCompletedOnboarding ?? false);
-            // Preserve backend-complete installs even when this browser has no prior
-            // local state (for example headless/VPS setups or a fresh visit to a
-            // cloud-provisioned container). Only clear the optimistic completion
-            // flag when the backend itself still reports onboarding as incomplete.
-            if (sessionComplete &&
-                !complete &&
-                !ctx?.persistedActiveServer &&
-                !ctx?.hadPriorOnboarding) {
-                sessionComplete = false;
-            }
-            if (complete && sessionComplete) {
-                clearPersistedOnboardingStep();
-            }
-            if (sessionComplete &&
-                !ctx?.persistedActiveServer &&
-                ctx?.restoredActiveServer) {
-                savePersistedActiveServer(ctx.restoredActiveServer);
-            }
-            if (!complete && ctx?.shouldPreserveCompletedOnboarding)
-                logger.warn("[eliza][startup:init] Preserving completed onboarding despite incomplete backend onboarding status.");
-            deps.setOnboardingComplete(sessionComplete);
-            if (!sessionComplete) {
-                // Fetch onboarding options
-                const optDeadline = Date.now() + getBackendStartupTimeoutMs();
-                let optErr = null;
-                while (!cancelled.current && effectRunRef.current === effectRunId) {
-                    if (Date.now() >= optDeadline) {
-                        deps.setStartupError(describeBackendFailure(optErr, true));
-                        deps.setOnboardingLoading(false);
-                        dispatch({ type: "BACKEND_TIMEOUT" });
-                        return;
-                    }
-                    try {
-                        const [options, config] = await Promise.all([
-                            client.getOnboardingOptions(),
-                            client.getConfig().catch(() => null),
-                        ]);
-                        if (deps.onboardingCompletionCommittedRef.current) {
-                            deps.setOnboardingLoading(false);
-                            dispatch({ type: "ONBOARDING_COMPLETE" });
-                            return;
-                        }
-                        const rf = deriveOnboardingResumeFieldsFromConfig(config);
-                        deps.setOnboardingOptions({
-                            ...options,
-                            styles: options.styles.length > 0
-                                ? options.styles
-                                : getStylePresets(deps.uiLanguage),
-                        });
-                        if (!rf.onboardingProvider) {
-                            try {
-                                const det = await scanProviderCredentials();
-                                if (det.length > 0)
-                                    deps.applyDetectedProviders(det);
-                            }
-                            catch { }
-                        }
-                        applyOnboardingResumeFields(rf, deps);
-                        deps.setOnboardingStep(inferOnboardingResumeStep({
-                            persistedStep: loadPersistedOnboardingStep(),
-                            config,
-                        }));
-                        deps.setOnboardingLoading(false);
-                        dispatch({
-                            type: "BACKEND_REACHED",
-                            onboardingComplete: false,
-                        });
-                        return;
-                    }
-                    catch (err) {
-                        const ae = asApiLikeError(err);
-                        if (ae?.status === 401 && client.hasToken()) {
-                            // On desktop, 401 is transient (port not ready / port changed).
-                            // Never clear the shell-injected token or show pairing.
-                            if (isElectrobunRuntime()) {
-                                optErr = err;
-                                await new Promise((r) => {
-                                    tidRef.current = setTimeout(r, 500);
-                                });
-                                continue;
-                            }
-                            client.setToken(null);
-                            deps.setAuthRequired(true);
-                            deps.setPairingEnabled(latestAuth.pairingEnabled);
-                            deps.setPairingExpiresAt(latestAuth.expiresAt);
-                            deps.setOnboardingLoading(false);
-                            dispatch({ type: "BACKEND_AUTH_REQUIRED" });
-                            return;
-                        }
-                        if (ae?.status === 404) {
-                            deps.setStartupError(describeBackendFailure(err, false));
-                            deps.setOnboardingLoading(false);
-                            dispatch({ type: "BACKEND_NOT_FOUND" });
-                            return;
-                        }
-                        optErr = err;
-                        await new Promise((r) => {
-                            tidRef.current = setTimeout(r, 500);
-                        });
-                    }
-                }
-                return;
-            }
-            dispatch({ type: "BACKEND_REACHED", onboardingComplete: true });
-            return;
-        }
-        catch (err) {
-            const ae = asApiLikeError(err);
-            if (ae?.status === 401 &&
-                latestAuth.loginRequired &&
-                !client.hasToken()) {
-                deps.setAuthRequired(false);
-                deps.setOnboardingComplete(true);
-                deps.setOnboardingLoading(false);
-                dispatch({ type: "BACKEND_REACHED", onboardingComplete: true });
-                return;
-            }
-            if (ae?.status === 401 && client.hasToken()) {
-                // On desktop, 401 is transient (port not ready / port changed).
-                // Never clear the shell-injected token or show pairing.
-                if (!isElectrobunRuntime()) {
-                    client.setToken(null);
-                    deps.setAuthRequired(true);
-                    deps.setPairingEnabled(latestAuth.pairingEnabled);
-                    deps.setPairingExpiresAt(latestAuth.expiresAt);
-                    deps.setOnboardingLoading(false);
-                    dispatch({ type: "BACKEND_AUTH_REQUIRED" });
-                    return;
-                }
-            }
-            if (ae?.status === 404) {
-                deps.setStartupError(describeBackendFailure(err, false));
-                deps.setOnboardingLoading(false);
-                dispatch({ type: "BACKEND_NOT_FOUND" });
-                return;
-            }
-            lastErr = err;
-            attempts++;
-            const delay = Math.min(250 * 2 ** Math.min(attempts, 2), 1000);
-            await new Promise((r) => {
-                tidRef.current = setTimeout(r, delay);
-            });
-        }
-    }
-}

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

@@ -1,49 +0,0 @@
-/**
- * startup-phase-restore.ts
- *
- * Side-effect logic for the "restoring-session" startup phase.
- * Probes for an existing install/connection and dispatches the result.
- */
-import { client, type OnboardingOptions } from "../api";
-import { scanProviderCredentials } from "../bridge";
-import type { UiLanguage } from "../i18n";
-import { loadPersistedActiveServer, type PersistedActiveServer } from "./persistence";
-import type { StartupEvent } from "./startup-coordinator";
-export interface RestoringSessionDeps {
-    setStartupError: (v: null) => void;
-    setAuthRequired: (v: boolean) => void;
-    setConnected: (v: boolean) => void;
-    setOnboardingExistingInstallDetected: (v: boolean) => void;
-    setOnboardingOptions: (v: OnboardingOptions) => void;
-    setOnboardingComplete: (v: boolean) => void;
-    setOnboardingLoading: (v: boolean) => void;
-    applyDetectedProviders: (detected: Awaited<ReturnType<typeof scanProviderCredentials>>) => void;
-    forceLocalBootstrapRef: React.MutableRefObject<boolean>;
-    onboardingCompletionCommittedRef: React.MutableRefObject<boolean>;
-    uiLanguage: UiLanguage;
-}
-export interface RestoringSessionCtx {
-    persistedActiveServer: ReturnType<typeof loadPersistedActiveServer>;
-    restoredActiveServer: PersistedActiveServer;
-    shouldPreserveCompletedOnboarding: boolean;
-    hadPriorOnboarding: boolean;
-}
-export declare function applyRestoredConnection(args: {
-    restoredActiveServer: PersistedActiveServer;
-    clientRef: Pick<typeof client, "setBaseUrl" | "setToken">;
-    startLocalRuntime?: () => Promise<void>;
-}): Promise<void>;
-/**
- * Runs the restoring-session phase.
- * Probes the local Eliza install and/or API to detect an existing connection,
- * then dispatches SESSION_RESTORED or NO_SESSION.
- *
- * @param deps - Coordinator dependency bag
- * @param dispatch - startupReducer dispatch
- * @param ctxRef - Mutable ref shared with the polling-backend phase
- * @param cancelled - Ref-flag set true by the cleanup function
- */
-export declare function runRestoringSession(deps: RestoringSessionDeps, dispatch: (event: StartupEvent) => void, ctxRef: React.MutableRefObject<RestoringSessionCtx | null>, cancelled: {
-    current: boolean;
-}): Promise<void>;
-//# sourceMappingURL=startup-phase-restore.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"startup-phase-restore.d.ts","sourceRoot":"","sources":["../../../../../../app-core/src/state/startup-phase-restore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAE,KAAK,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,EAML,uBAAuB,EACxB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,OAAO,EACL,yBAAyB,EAEzB,KAAK,qBAAqB,EAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,CAAC,CAAC,EAAE,IAAI,KAAK,IAAI,CAAC;IACnC,eAAe,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,YAAY,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,oCAAoC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3D,oBAAoB,EAAE,CAAC,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACrD,qBAAqB,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C,oBAAoB,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,sBAAsB,EAAE,CACtB,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,KAC1D,IAAI,CAAC;IACV,sBAAsB,EAAE,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACxD,gCAAgC,EAAE,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAClE,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,qBAAqB,EAAE,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;IACpE,oBAAoB,EAAE,qBAAqB,CAAC;IAC5C,iCAAiC,EAAE,OAAO,CAAC;IAC3C,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,oBAAoB,EAAE,qBAAqB,CAAC;IAC5C,SAAS,EAAE,IAAI,CAAC,OAAO,MAAM,EAAE,YAAY,GAAG,UAAU,CAAC,CAAC;IAC1D,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC,iBAoBA;AAeD;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,oBAAoB,EAC1B,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,EACvC,MAAM,EAAE,KAAK,CAAC,gBAAgB,CAAC,mBAAmB,GAAG,IAAI,CAAC,EAC1D,SAAS,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAC9B,OAAO,CAAC,IAAI,CAAC,CAgHf"}

package/packages/app-core/src/state/startup-phase-restore.js

@@ -1,145 +0,0 @@
-/**
- * startup-phase-restore.ts
- *
- * Side-effect logic for the "restoring-session" startup phase.
- * Probes for an existing install/connection and dispatches the result.
- */
-import { getStylePresets, ONBOARDING_PROVIDER_CATALOG } from "@elizaos/shared";
-import { client } from "../api";
-import { getBackendStartupTimeoutMs, getDesktopRuntimeMode, inspectExistingElizaInstall, invokeDesktopBridgeRequest, isElectrobunRuntime, scanProviderCredentials, } from "../bridge";
-import { detectExistingOnboardingConnection } from "./onboarding-bootstrap";
-import { loadPersistedActiveServer, loadPersistedOnboardingComplete, } from "./persistence";
-export async function applyRestoredConnection(args) {
-    const { restoredActiveServer, clientRef, startLocalRuntime } = args;
-    if (restoredActiveServer.kind === "local") {
-        clientRef.setToken(null);
-        clientRef.setBaseUrl(null);
-        if (startLocalRuntime) {
-            await startLocalRuntime();
-        }
-        return;
-    }
-    if (restoredActiveServer.kind === "cloud") {
-        clientRef.setBaseUrl(restoredActiveServer.apiBase ?? null);
-        clientRef.setToken(restoredActiveServer.accessToken ?? null);
-        return;
-    }
-    clientRef.setBaseUrl(restoredActiveServer.apiBase ?? null);
-    clientRef.setToken(restoredActiveServer.accessToken ?? null);
-}
-function activeServerToTarget(kind) {
-    switch (kind) {
-        case "local":
-            return "embedded-local";
-        case "cloud":
-            return "cloud-managed";
-        case "remote":
-            return "remote-backend";
-    }
-}
-/**
- * Runs the restoring-session phase.
- * Probes the local Eliza install and/or API to detect an existing connection,
- * then dispatches SESSION_RESTORED or NO_SESSION.
- *
- * @param deps - Coordinator dependency bag
- * @param dispatch - startupReducer dispatch
- * @param ctxRef - Mutable ref shared with the polling-backend phase
- * @param cancelled - Ref-flag set true by the cleanup function
- */
-export async function runRestoringSession(deps, dispatch, ctxRef, cancelled) {
-    deps.setStartupError(null);
-    deps.setAuthRequired(false);
-    deps.setConnected(false);
-    deps.setOnboardingExistingInstallDetected(false);
-    const forceLocal = deps.forceLocalBootstrapRef.current;
-    deps.forceLocalBootstrapRef.current = false;
-    const persistedActiveServer = loadPersistedActiveServer();
-    const hadPrior = loadPersistedOnboardingComplete();
-    if (cancelled.current)
-        return;
-    const desktopInstall = !persistedActiveServer && isElectrobunRuntime()
-        ? await inspectExistingElizaInstall().catch(() => null)
-        : null;
-    if (cancelled.current)
-        return;
-    const isDesktop = forceLocal || isElectrobunRuntime();
-    const _hasExistingEvidence = hadPrior || Boolean(desktopInstall?.detected);
-    // Probe the API when there is evidence of a prior install, or when no
-    // persisted server exists (covers headless/VPS setups where config was
-    // set via files without going through UI onboarding).
-    const probed = !persistedActiveServer
-        ? await detectExistingOnboardingConnection({
-            client,
-            timeoutMs: isDesktop
-                ? Math.min(getBackendStartupTimeoutMs(), 30_000)
-                : Math.min(getBackendStartupTimeoutMs(), 3_500),
-        })
-        : null;
-    if (cancelled.current)
-        return;
-    const restoredActiveServer = persistedActiveServer ?? (probed ? probed.activeServer : null);
-    const preserveCompleted = hadPrior && !deps.onboardingCompletionCommittedRef.current;
-    deps.setOnboardingExistingInstallDetected(Boolean(hadPrior || desktopInstall?.detected || probed?.detectedExistingInstall));
-    if (!restoredActiveServer) {
-        // No saved backend found — let the user (re-)onboard.
-        deps.setOnboardingOptions({
-            names: [],
-            styles: getStylePresets(deps.uiLanguage),
-            providers: [
-                ...ONBOARDING_PROVIDER_CATALOG,
-            ],
-            cloudProviders: [],
-            models: {
-                nano: [],
-                small: [],
-                medium: [],
-                large: [],
-                mega: [],
-            },
-            inventoryProviders: [],
-            sharedStyleRules: "",
-        });
-        try {
-            const det = await scanProviderCredentials();
-            if (!cancelled.current && det.length > 0) {
-                console.log(`[eliza][startup] Keychain scan found ${det.length} provider(s):`, det.map((p) => p.id));
-                deps.applyDetectedProviders(det);
-            }
-        }
-        catch (scanErr) {
-            console.warn("[eliza][startup] Keychain credential scan failed:", scanErr);
-        }
-        deps.setOnboardingComplete(false);
-        deps.setOnboardingLoading(false);
-        dispatch({ type: "NO_SESSION", hadPriorOnboarding: hadPrior });
-        return;
-    }
-    await applyRestoredConnection({
-        restoredActiveServer,
-        clientRef: client,
-        startLocalRuntime: async () => {
-            try {
-                const runtimeMode = await getDesktopRuntimeMode().catch(() => null);
-                if (runtimeMode && runtimeMode.mode !== "local") {
-                    return;
-                }
-                await invokeDesktopBridgeRequest({
-                    rpcMethod: "agentStart",
-                    ipcChannel: "agent:start",
-                });
-            }
-            catch { }
-        },
-    });
-    ctxRef.current = {
-        persistedActiveServer,
-        restoredActiveServer,
-        shouldPreserveCompletedOnboarding: preserveCompleted,
-        hadPriorOnboarding: hadPrior,
-    };
-    dispatch({
-        type: "SESSION_RESTORED",
-        target: activeServerToTarget(restoredActiveServer.kind),
-    });
-}

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

@@ -1,34 +0,0 @@
-/**
- * startup-phase-runtime.ts
- *
- * Side-effect logic for the "starting-runtime" startup phase.
- * Polls the agent status until running, then dispatches AGENT_RUNNING.
- */
-import { type StartupErrorState } from "./internal";
-import type { StartupEvent } from "./startup-coordinator";
-export interface StartingRuntimeDeps {
-    setAgentStatus: (v: import("../api").AgentStatus | null) => void;
-    setConnected: (v: boolean) => void;
-    setStartupError: (v: StartupErrorState | null) => void;
-    setOnboardingLoading: (v: boolean) => void;
-    setAuthRequired: (v: boolean) => void;
-    setPendingRestart: (v: boolean | ((prev: boolean) => boolean)) => void;
-    setPendingRestartReasons: (v: string[] | ((prev: string[]) => string[])) => void;
-}
-/**
- * Runs the starting-runtime phase.
- * Polls /status until the agent reaches "running", then dispatches AGENT_RUNNING.
- *
- * @param deps - Coordinator dependency bag
- * @param dispatch - startupReducer dispatch
- * @param effectRunId - The run ID of the calling effect (for stale-close guard)
- * @param effectRunRef - Shared ref tracking the latest run ID
- * @param cancelled - Ref-flag set true by the cleanup function
- * @param tidRef - Mutable ref for the pending setTimeout handle (for cleanup)
- */
-export declare function runStartingRuntime(deps: StartingRuntimeDeps, dispatch: (event: StartupEvent) => void, effectRunId: number, effectRunRef: React.MutableRefObject<number>, cancelled: {
-    current: boolean;
-}, tidRef: {
-    current: ReturnType<typeof setTimeout> | null;
-}): Promise<void>;
-//# sourceMappingURL=startup-phase-runtime.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"startup-phase-runtime.d.ts","sourceRoot":"","sources":["../../../../../../app-core/src/state/startup-phase-runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,CAAC,CAAC,EAAE,OAAO,QAAQ,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IACjE,YAAY,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,eAAe,EAAE,CAAC,CAAC,EAAE,iBAAiB,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD,oBAAoB,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,eAAe,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,iBAAiB,EAAE,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,KAAK,IAAI,CAAC;IACvE,wBAAwB,EAAE,CACxB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC,KACzC,IAAI,CAAC;CACX;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,mBAAmB,EACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,EACvC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAC5C,SAAS,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,EAC/B,MAAM,EAAE;IAAE,OAAO,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAA;CAAE,GACxD,OAAO,CAAC,IAAI,CAAC,CAwHf"}

package/packages/app-core/src/state/startup-phase-runtime.js

@@ -1,126 +0,0 @@
-/**
- * startup-phase-runtime.ts
- *
- * Side-effect logic for the "starting-runtime" startup phase.
- * Polls the agent status until running, then dispatches AGENT_RUNNING.
- */
-import { client } from "../api";
-import { isElectrobunRuntime } from "../bridge";
-import { computeAgentDeadlineExtensions, getAgentReadyTimeoutMs, } from "./agent-startup-timing";
-import { asApiLikeError, formatStartupErrorDetail, } from "./internal";
-/**
- * Runs the starting-runtime phase.
- * Polls /status until the agent reaches "running", then dispatches AGENT_RUNNING.
- *
- * @param deps - Coordinator dependency bag
- * @param dispatch - startupReducer dispatch
- * @param effectRunId - The run ID of the calling effect (for stale-close guard)
- * @param effectRunRef - Shared ref tracking the latest run ID
- * @param cancelled - Ref-flag set true by the cleanup function
- * @param tidRef - Mutable ref for the pending setTimeout handle (for cleanup)
- */
-export async function runStartingRuntime(deps, dispatch, effectRunId, effectRunRef, cancelled, tidRef) {
-    const describeAgentFailure = (err, timedOut, diag) => {
-        const detail = diag?.lastError ||
-            formatStartupErrorDetail(err) ||
-            "Agent runtime did not report a reason.";
-        if (!timedOut &&
-            /required companion assets could not be loaded|bundled avatar .* could not be loaded/i.test(detail))
-            return {
-                reason: "asset-missing",
-                phase: "initializing-agent",
-                message: "Required companion assets could not be loaded.",
-                detail,
-            };
-        if (timedOut) {
-            const hint = 'First-time startup often downloads a local embedding model (GGUF, hundreds of MB). That can take many minutes on a slow network.\n\nIf logs still show a download in progress, wait for it to finish, then tap Retry. On desktop, the app keeps extending the wait while the agent stays in "starting" (up to 15 minutes total).';
-            const emb = diag?.embeddingDetail ??
-                (diag?.embeddingPhase === "downloading"
-                    ? "Embedding model download in progress."
-                    : undefined);
-            return {
-                reason: "agent-timeout",
-                phase: "initializing-agent",
-                message: "The agent did not become ready in time. This is common while a large embedding model (GGUF) is still downloading on first run.",
-                detail: [detail, emb, hint]
-                    .filter((b) => typeof b === "string" && b.trim().length > 0)
-                    .join("\n\n"),
-            };
-        }
-        return {
-            reason: "agent-error",
-            phase: "initializing-agent",
-            message: "Agent runtime reported a startup error.",
-            detail,
-        };
-    };
-    const started = Date.now();
-    let deadline = started + getAgentReadyTimeoutMs();
-    let lastErr = null;
-    let lastDiag;
-    while (!cancelled.current && effectRunRef.current === effectRunId) {
-        if (Date.now() >= deadline) {
-            deps.setStartupError(describeAgentFailure(lastErr, true, lastDiag));
-            deps.setOnboardingLoading(false);
-            dispatch({ type: "AGENT_TIMEOUT" });
-            return;
-        }
-        try {
-            let status = await client.getStatus();
-            deps.setAgentStatus(status);
-            deps.setConnected(true);
-            lastDiag = status.startup;
-            deadline = computeAgentDeadlineExtensions({
-                agentWaitStartedAt: started,
-                agentDeadlineAt: deadline,
-                state: status.state,
-            });
-            if (status.pendingRestart) {
-                deps.setPendingRestart(true);
-                deps.setPendingRestartReasons(status.pendingRestartReasons ?? []);
-            }
-            if (status.state === "not_started" || status.state === "stopped") {
-                try {
-                    status = await client.startAgent();
-                    deps.setAgentStatus(status);
-                    lastDiag = status.startup;
-                }
-                catch (e) {
-                    lastErr = e;
-                }
-            }
-            if (status.state === "running") {
-                dispatch({ type: "AGENT_RUNNING" });
-                return;
-            }
-            if (status.state === "error") {
-                deps.setStartupError(describeAgentFailure(lastErr, false, status.startup));
-                deps.setOnboardingLoading(false);
-                dispatch({
-                    type: "AGENT_ERROR",
-                    message: status.startup?.lastError ?? "Agent failed to start",
-                });
-                return;
-            }
-        }
-        catch (err) {
-            const ae = asApiLikeError(err);
-            if (ae?.status === 401 && client.hasToken()) {
-                // On desktop, 401 is transient (port not ready / port changed).
-                // Never clear the shell-injected token or show pairing.
-                if (!isElectrobunRuntime()) {
-                    client.setToken(null);
-                    deps.setAuthRequired(true);
-                    deps.setOnboardingLoading(false);
-                    dispatch({ type: "BACKEND_AUTH_REQUIRED" });
-                    return;
-                }
-            }
-            lastErr = err;
-            deps.setConnected(false);
-        }
-        await new Promise((r) => {
-            tidRef.current = setTimeout(r, 500);
-        });
-    }
-}