@elizaos/ui 2.0.0-beta.2 → 2.0.3-beta.2

package/first-run/onboarding-intent.js

@@ -0,0 +1,38 @@
+/**
+ * onboarding-intent — the shared contract for driving first-run setup from
+ * non-form surfaces (the tray menu and the voice pill), so both dispatch the
+ * same runtime choice into the existing first-run controller.
+ *
+ * The voice path already parses spoken commands into a runtime choice
+ * (applyFirstRunVoiceTranscript in ./first-run). This is the tray side:
+ * stable item ids + label keys for the onboarding tray entries, and a mapping
+ * from a clicked tray action id back to the runtime choice. The compact
+ * onboarding overlay dispatches the resolved choice into the controller.
+ */
+/**
+ * Tray items shown only while first-run setup is pending. "No default — ask":
+ * local and cloud are presented as equal peers. Cloud completes via the OAuth
+ * popup, which a tray click (a real user gesture) satisfies.
+ */
+export const ONBOARDING_TRAY_ITEMS = [
+    {
+        id: "onboard-use-local",
+        label: "Use Local (on-device)",
+        labelKey: "desktop.onboarding.useLocal",
+        choice: "local",
+    },
+    {
+        id: "onboard-sign-in-cloud",
+        label: "Sign in to Eliza Cloud",
+        labelKey: "desktop.onboarding.signInCloud",
+        choice: "cloud",
+    },
+];
+/** Map a clicked tray action id to its onboarding runtime choice, or null. */
+export function trayActionToOnboardingChoice(id) {
+    return ONBOARDING_TRAY_ITEMS.find((item) => item.id === id)?.choice ?? null;
+}
+/** True when the tray action id is an onboarding choice (vs a normal item). */
+export function isOnboardingTrayAction(id) {
+    return trayActionToOnboardingChoice(id) !== null;
+}

package/first-run/pre-seed-local-runtime.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Pre-seed the AOSP ElizaOS APK when the device itself is the local agent.
+ */
+export { isAospElizaUserAgent } from "../platform/aosp-user-agent";
+export declare function preSeedAndroidLocalRuntimeIfFresh(): boolean;
+//# sourceMappingURL=pre-seed-local-runtime.d.ts.map

package/first-run/pre-seed-local-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-seed-local-runtime.d.ts","sourceRoot":"","sources":["../../../../../src/first-run/pre-seed-local-runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AA2EnE,wBAAgB,iCAAiC,IAAI,OAAO,CAY3D"}

package/first-run/pre-seed-local-runtime.js

@@ -0,0 +1,91 @@
+/**
+ * Pre-seed the AOSP ElizaOS APK when the device itself is the local agent.
+ */
+import { isAndroidCloudBuild } from "../platform/android-runtime.js";
+import { isAospElizaUserAgent } from "../platform/aosp-user-agent.js";
+import { getFrontendPlatform } from "../platform/platform-guards.js";
+import { ANDROID_LOCAL_AGENT_IPC_BASE, ANDROID_LOCAL_AGENT_LABEL, ANDROID_LOCAL_AGENT_SERVER_ID, persistMobileRuntimeModeForServerTarget, readPersistedMobileRuntimeMode, } from "./mobile-runtime-mode.js";
+export { isAospElizaUserAgent } from "../platform/aosp-user-agent.js";
+// Mirror of `ACTIVE_SERVER_STORAGE_KEY` in `state/persistence.ts`. Split
+// here so this file stays a leaf module — `state/persistence.ts` pulls in
+// the entire UI state graph and would create a cycle through
+// `bridge/storage-bridge`.
+const ACTIVE_SERVER_STORAGE_KEY = "elizaos:active-server";
+function hasPersistedActiveServer() {
+    if (typeof window === "undefined")
+        return false;
+    try {
+        const raw = window.localStorage.getItem(ACTIVE_SERVER_STORAGE_KEY);
+        if (!raw)
+            return false;
+        const parsed = JSON.parse(raw);
+        return (parsed != null &&
+            typeof parsed === "object" &&
+            typeof parsed.id === "string" &&
+            parsed.id.length > 0);
+    }
+    catch {
+        return false;
+    }
+}
+function writeLocalAgentActiveServer() {
+    if (typeof window === "undefined")
+        return;
+    const payload = {
+        id: ANDROID_LOCAL_AGENT_SERVER_ID,
+        kind: "remote",
+        label: ANDROID_LOCAL_AGENT_LABEL,
+        apiBase: ANDROID_LOCAL_AGENT_IPC_BASE,
+    };
+    try {
+        window.localStorage.setItem(ACTIVE_SERVER_STORAGE_KEY, JSON.stringify(payload));
+    }
+    catch {
+        // localStorage can be unavailable in embedded shells.
+    }
+}
+function isBrandedAndroidDevice() {
+    if (typeof navigator === "undefined")
+        return false;
+    return isAospElizaUserAgent(navigator.userAgent);
+}
+/**
+ * The stock-phone local sideload build (`android` / `android-system`, renderer
+ * mode `local`) ships the on-device agent — that IS its backend. The
+ * `android-cloud` Play-Store build is a thin cloud client with no on-device
+ * agent, so it must never seed local. iOS/desktop/web are not android and
+ * resolve to a non-cloud mode by default, so gate on the native platform too.
+ */
+function isAndroidLocalSideloadBuild() {
+    return getFrontendPlatform() === "android" && !isAndroidCloudBuild();
+}
+/**
+ * Whether to pre-seed the on-device local agent as the active server.
+ *
+ * Fires for branded ElizaOS device images AND the stock-phone local sideload
+ * build (the on-device-agent APK). Both run the on-device agent as their
+ * backend, so a fresh launch should default to it instead of falling back to
+ * cloud-connect. Gating only on the branded `ElizaOS/<tag>` UA marker (as
+ * before) excluded the stock sideload and left it stuck on cloud onboarding —
+ * which is exactly the bug the caller in `main.tsx` documents. The explicit
+ * cloud/remote-choice and existing-active-server guards in
+ * `preSeedAndroidLocalRuntimeIfFresh` still respect a user who picked cloud.
+ */
+function shouldPreSeedLocalRuntime() {
+    return isBrandedAndroidDevice() || isAndroidLocalSideloadBuild();
+}
+export function preSeedAndroidLocalRuntimeIfFresh() {
+    if (!shouldPreSeedLocalRuntime())
+        return false;
+    // Respect an explicit cloud/remote choice, but treat null or "local" as
+    // seedable: a stock-phone sideload may carry a "local" mode with no active
+    // server yet (so the dashboard would otherwise fall back to cloud-connect).
+    const persistedMode = readPersistedMobileRuntimeMode();
+    if (persistedMode != null && persistedMode !== "local")
+        return false;
+    if (hasPersistedActiveServer())
+        return false;
+    persistMobileRuntimeModeForServerTarget("local");
+    writeLocalAgentActiveServer();
+    return true;
+}

package/first-run/probe-local-agent.d.ts

@@ -0,0 +1,50 @@
+/**
+ * probe-local-agent.ts
+ *
+ * Liveness probe for an on-device Eliza agent.
+ *
+ * Android reaches the bundled foreground service over loopback. iOS reaches
+ * the bundled runtime through an in-app IPC identity, so its local option is
+ * available as soon as the native app is running.
+ *
+ * Result is cached for `PROBE_CACHE_TTL_MS` so repeated renders during the
+ * first-run flow do not hammer loopback. The cache is keyed by URL.
+ *
+ * `clearLocalAgentProbeCache()` resets the cache between tests.
+ */
+export declare const DEFAULT_LOCAL_AGENT_HEALTH_URL = "http://127.0.0.1:31337/api/health";
+/** Reset the probe cache. Test-only. */
+export declare function clearLocalAgentProbeCache(): void;
+export interface LocalOptionGate {
+    isDesktop: boolean;
+    isDev: boolean;
+    isAndroid: boolean;
+    isIOS: boolean;
+}
+/**
+ * Liveness probe for the on-device local agent, framed as "should the local
+ * option be visible / actionable yet?".
+ *
+ * - Desktop and dev builds: always `true` synchronously — they manage the
+ *   runtime themselves.
+ * - Android: unconditionally the only runtime mode on ElizaOS. The probe here
+ *   is purely a *readiness* signal —
+ *   "is the agent's `/api/health` reachable yet?". It is **not** a gate on
+ *   whether the local mode is offered at all; on Android it always is.
+ * - iOS: `true` in native builds because local requests are intercepted by
+ *   the Capacitor/native IPC bridge or the compatibility ITTP kernel instead
+ *   of probing a TCP listener.
+ * - Plain web: `false`. It does not host a local agent.
+ */
+export declare function shouldShowLocalOption(gate: LocalOptionGate): Promise<boolean>;
+/**
+ * Probes a local agent's `/api/health` endpoint with a timeout.
+ *
+ * Returns `true` only when the response is HTTP 200 and the JSON body
+ * contains `{ ok: true }`. Any other outcome (timeout, network error,
+ * non-200, non-JSON, missing field) returns `false`.
+ *
+ * Results are memoized per URL for 30 seconds.
+ */
+export declare function probeLocalAgent(timeoutMs?: number, url?: string): Promise<boolean>;
+//# sourceMappingURL=probe-local-agent.d.ts.map

package/first-run/probe-local-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-local-agent.d.ts","sourceRoot":"","sources":["../../../../../src/first-run/probe-local-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,eAAO,MAAM,8BAA8B,sCACN,CAAC;AA2EtC,wCAAwC;AACxC,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,OAAO,CAAC,CAKlB;AAqGD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,SAAS,SAAO,EAChB,GAAG,GAAE,MAAuC,GAC3C,OAAO,CAAC,OAAO,CAAC,CA0BlB"}

package/first-run/probe-local-agent.js

@@ -0,0 +1,219 @@
+/**
+ * probe-local-agent.ts
+ *
+ * Liveness probe for an on-device Eliza agent.
+ *
+ * Android reaches the bundled foreground service over loopback. iOS reaches
+ * the bundled runtime through an in-app IPC identity, so its local option is
+ * available as soon as the native app is running.
+ *
+ * Result is cached for `PROBE_CACHE_TTL_MS` so repeated renders during the
+ * first-run flow do not hammer loopback. The cache is keyed by URL.
+ *
+ * `clearLocalAgentProbeCache()` resets the cache between tests.
+ */
+import { Capacitor } from "@capacitor/core";
+import { isAndroidLocalAgentUrl } from "./local-agent-token.js";
+export const DEFAULT_LOCAL_AGENT_HEALTH_URL = "http://127.0.0.1:31337/api/health";
+// Positive results are cached longer so re-renders during first-run don't
+// hammer loopback. Negative results are short-lived because the agent may
+// finish booting moments after the first probe — without a short negative
+// TTL the user sees "no local agent" for 30 s after a reboot even though
+// the agent is up. 3 s lets first-run setup re-poll naturally.
+const PROBE_POSITIVE_CACHE_TTL_MS = 30_000;
+const PROBE_NEGATIVE_CACHE_TTL_MS = 3_000;
+const resultCache = new Map();
+const inflight = new Map();
+const agentPluginName = "Agent";
+function toNativeAgentProbePlugin(plugin) {
+    if (typeof plugin?.request !== "function")
+        return null;
+    const request = plugin.request.bind(plugin);
+    return {
+        request: (options) => request(options),
+    };
+}
+function isNativeAndroid() {
+    try {
+        return Capacitor.getPlatform() === "android";
+    }
+    catch {
+        return false;
+    }
+}
+function isNativeIos() {
+    try {
+        return Capacitor.isNativePlatform() && Capacitor.getPlatform() === "ios";
+    }
+    catch {
+        return false;
+    }
+}
+async function resolveNativeAgentPlugin() {
+    try {
+        const capacitorWithPlugins = Capacitor;
+        const registeredAgent = capacitorWithPlugins.Plugins?.[agentPluginName] ??
+            Capacitor.registerPlugin(agentPluginName);
+        const agent = toNativeAgentProbePlugin(registeredAgent);
+        if (agent)
+            return agent;
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+/** Reset the probe cache. Test-only. */
+export function clearLocalAgentProbeCache() {
+    resultCache.clear();
+    inflight.clear();
+}
+/**
+ * Liveness probe for the on-device local agent, framed as "should the local
+ * option be visible / actionable yet?".
+ *
+ * - Desktop and dev builds: always `true` synchronously — they manage the
+ *   runtime themselves.
+ * - Android: unconditionally the only runtime mode on ElizaOS. The probe here
+ *   is purely a *readiness* signal —
+ *   "is the agent's `/api/health` reachable yet?". It is **not** a gate on
+ *   whether the local mode is offered at all; on Android it always is.
+ * - iOS: `true` in native builds because local requests are intercepted by
+ *   the Capacitor/native IPC bridge or the compatibility ITTP kernel instead
+ *   of probing a TCP listener.
+ * - Plain web: `false`. It does not host a local agent.
+ */
+export async function shouldShowLocalOption(gate) {
+    if (gate.isDesktop || gate.isDev)
+        return true;
+    if (gate.isIOS)
+        return isNativeIos();
+    if (!gate.isAndroid)
+        return false;
+    return probeLocalAgent();
+}
+function isHealthyBody(body) {
+    if (typeof body !== "object" || body === null)
+        return false;
+    const b = body;
+    if (b.ok === true)
+        return true;
+    if (b.ready === true)
+        return true;
+    if (b.agentState === "running")
+        return true;
+    return false;
+}
+async function runNativeAndroidProbe(url, timeoutMs) {
+    if (!isAndroidLocalAgentUrl(url) || !isNativeAndroid())
+        return null;
+    const agent = await resolveNativeAgentPlugin();
+    if (!agent?.request)
+        return null;
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return false;
+    }
+    let result;
+    try {
+        result = await agent.request({
+            method: "GET",
+            path: `${parsed.pathname}${parsed.search}`,
+            headers: {
+                Accept: "application/json",
+                "X-ElizaOS-Client-Id": "local-agent-probe",
+            },
+            timeoutMs,
+        });
+    }
+    catch {
+        return false;
+    }
+    if (result.status < 200 || result.status >= 300)
+        return false;
+    let body;
+    try {
+        body = JSON.parse(result.body ?? "");
+    }
+    catch {
+        return false;
+    }
+    return isHealthyBody(body);
+}
+async function runProbe(url, timeoutMs) {
+    const nativeResult = await runNativeAndroidProbe(url, timeoutMs);
+    if (nativeResult !== null)
+        return nativeResult;
+    if (typeof fetch !== "function")
+        return false;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    let res;
+    try {
+        res = await fetch(url, {
+            method: "GET",
+            signal: controller.signal,
+            headers: { Accept: "application/json" },
+        });
+    }
+    catch {
+        return false;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    if (!res.ok)
+        return false;
+    let body;
+    try {
+        body = await res.json();
+    }
+    catch {
+        return false;
+    }
+    // The agent's /api/health responds with one of two shapes depending on
+    // version:
+    //   { ok: true, agent, bun, uptime }                 ← legacy probe shape
+    //   { ready: true, runtime: "ok", database: "ok",
+    //     agentState: "running", uptime, ...}            ← real @elizaos/agent
+    // Treat either as healthy. `ok === true` covers the legacy shape; `ready === true`
+    // and `agentState === "running"` cover the real runtime. Without this, the
+    // local option stays hidden even when the agent is plainly up.
+    return isHealthyBody(body);
+}
+/**
+ * Probes a local agent's `/api/health` endpoint with a timeout.
+ *
+ * Returns `true` only when the response is HTTP 200 and the JSON body
+ * contains `{ ok: true }`. Any other outcome (timeout, network error,
+ * non-200, non-JSON, missing field) returns `false`.
+ *
+ * Results are memoized per URL for 30 seconds.
+ */
+export async function probeLocalAgent(timeoutMs = 1500, url = DEFAULT_LOCAL_AGENT_HEALTH_URL) {
+    const now = Date.now();
+    const cached = resultCache.get(url);
+    if (cached && cached.expiresAt > now) {
+        return cached.result;
+    }
+    const existing = inflight.get(url);
+    if (existing)
+        return existing;
+    const promise = runProbe(url, timeoutMs)
+        .then((result) => {
+        resultCache.set(url, {
+            result,
+            expiresAt: Date.now() +
+                (result ? PROBE_POSITIVE_CACHE_TTL_MS : PROBE_NEGATIVE_CACHE_TTL_MS),
+        });
+        return result;
+    })
+        .finally(() => {
+        inflight.delete(url);
+    });
+    inflight.set(url, promise);
+    return promise;
+}

package/first-run/reload-into-first-run-runtime.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Helper for the Settings > Runtime panel "Switch runtime" action.
+ */
+export declare const FIRST_RUN_QUERY_NAME = "runtime";
+export declare const FIRST_RUN_QUERY_VALUE = "first-run";
+export declare const FIRST_RUN_TARGET_QUERY_NAME = "runtimeTarget";
+export type FirstRunReloadTarget = "cloud" | "local" | "remote";
+export declare function readFirstRunRuntimeTarget(search?: string | URLSearchParams): FirstRunReloadTarget | null;
+export declare function reloadIntoFirstRunRuntime(target?: FirstRunReloadTarget): void;
+export declare const __TEST_ONLY__: {
+    ACTIVE_SERVER_STORAGE_KEY: string;
+    MOBILE_RUNTIME_MODE_STORAGE_KEY: string;
+};
+//# sourceMappingURL=reload-into-first-run-runtime.d.ts.map

package/first-run/reload-into-first-run-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload-into-first-run-runtime.d.ts","sourceRoot":"","sources":["../../../../../src/first-run/reload-into-first-run-runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAC9C,eAAO,MAAM,qBAAqB,cAAc,CAAC;AACjD,eAAO,MAAM,2BAA2B,kBAAkB,CAAC;AAE3D,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAQhE,wBAAgB,yBAAyB,CACvC,MAAM,GAAE,MAAM,GAAG,eAES,GACzB,oBAAoB,GAAG,IAAI,CAS7B;AAED,wBAAgB,yBAAyB,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAgB7E;AAED,eAAO,MAAM,aAAa;;;CAGzB,CAAC"}

package/first-run/reload-into-first-run-runtime.js

@@ -0,0 +1,46 @@
+/**
+ * Helper for the Settings > Runtime panel "Switch runtime" action.
+ */
+import { MOBILE_RUNTIME_MODE_STORAGE_KEY, persistMobileRuntimeModeForServerTarget, } from "./mobile-runtime-mode.js";
+const ACTIVE_SERVER_STORAGE_KEY = "elizaos:active-server";
+export const FIRST_RUN_QUERY_NAME = "runtime";
+export const FIRST_RUN_QUERY_VALUE = "first-run";
+export const FIRST_RUN_TARGET_QUERY_NAME = "runtimeTarget";
+function isFirstRunReloadTarget(value) {
+    return value === "cloud" || value === "local" || value === "remote";
+}
+export function readFirstRunRuntimeTarget(search = typeof window === "undefined"
+    ? ""
+    : window.location.search) {
+    const params = typeof search === "string" ? new URLSearchParams(search) : search;
+    const runtime = params.get(FIRST_RUN_QUERY_NAME);
+    if (runtime !== FIRST_RUN_QUERY_VALUE) {
+        return null;
+    }
+    const target = params.get(FIRST_RUN_TARGET_QUERY_NAME);
+    return isFirstRunReloadTarget(target) ? target : "local";
+}
+export function reloadIntoFirstRunRuntime(target) {
+    if (typeof window === "undefined")
+        return;
+    persistMobileRuntimeModeForServerTarget("");
+    try {
+        window.localStorage.removeItem(ACTIVE_SERVER_STORAGE_KEY);
+    }
+    catch {
+        // The query navigation still forces first-run when storage is unavailable.
+    }
+    const url = new URL(window.location.href);
+    url.searchParams.set(FIRST_RUN_QUERY_NAME, FIRST_RUN_QUERY_VALUE);
+    if (target) {
+        url.searchParams.set(FIRST_RUN_TARGET_QUERY_NAME, target);
+    }
+    else {
+        url.searchParams.delete(FIRST_RUN_TARGET_QUERY_NAME);
+    }
+    window.location.href = url.toString();
+}
+export const __TEST_ONLY__ = {
+    ACTIVE_SERVER_STORAGE_KEY,
+    MOBILE_RUNTIME_MODE_STORAGE_KEY,
+};

package/first-run/runtime-target.d.ts

@@ -0,0 +1,4 @@
+export type FirstRunRuntimeTarget = "" | "local" | "remote" | "elizacloud" | "elizacloud-hybrid";
+export declare function isElizaCloudFirstRunTarget(target: FirstRunRuntimeTarget): boolean;
+export declare function activeServerKindToFirstRunRuntimeTarget(kind: "local" | "cloud" | "remote"): Exclude<FirstRunRuntimeTarget, "">;
+//# sourceMappingURL=runtime-target.d.ts.map

package/first-run/runtime-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-target.d.ts","sourceRoot":"","sources":["../../../../../src/first-run/runtime-target.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAC7B,EAAE,GACF,OAAO,GACP,QAAQ,GACR,YAAY,GACZ,mBAAmB,CAAC;AAExB,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAET;AAED,wBAAgB,uCAAuC,CACrD,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,GACjC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CASpC"}

package/first-run/runtime-target.js

@@ -0,0 +1,13 @@
+export function isElizaCloudFirstRunTarget(target) {
+    return target === "elizacloud" || target === "elizacloud-hybrid";
+}
+export function activeServerKindToFirstRunRuntimeTarget(kind) {
+    switch (kind) {
+        case "local":
+            return "local";
+        case "cloud":
+            return "elizacloud";
+        case "remote":
+            return "remote";
+    }
+}

package/first-run/setup-steps.d.ts

@@ -0,0 +1,22 @@
+import type { FlaminaGuideTopic, SetupStep, SetupStepMeta } from "../state/types";
+export declare function getSetupStepOrder(): SetupStep[];
+export declare function getSetupStepIndex(step: SetupStep): number;
+export declare function resolveSetupNextStep(current: SetupStep): SetupStep | null;
+export declare function resolveSetupPreviousStep(current: SetupStep): SetupStep | null;
+export declare function canRevertSetupTo(params: {
+    current: SetupStep;
+    target: SetupStep;
+}): boolean;
+export declare function getSetupNavMetas(_currentStep: SetupStep, cloudOnly: boolean): SetupStepMeta[];
+export declare function shouldSkipConnectionStepsForCloudProvisionedContainer(args: {
+    currentStep: SetupStep;
+    cloudProvisionedContainer: boolean;
+}): boolean;
+export declare function shouldUseCloudSetupFastTrack(args: {
+    cloudProvisionedContainer: boolean;
+    elizaCloudConnected: boolean;
+    firstRunRunMode: "local" | "cloud" | "";
+    firstRunProvider: string;
+}): boolean;
+export declare function getFlaminaTopicForSetupStep(step: SetupStep): FlaminaGuideTopic | null;
+//# sourceMappingURL=setup-steps.d.ts.map

package/first-run/setup-steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-steps.d.ts","sourceRoot":"","sources":["../../../../../src/first-run/setup-steps.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,SAAS,EACT,aAAa,EACd,MAAM,gBAAgB,CAAC;AAGxB,wBAAgB,iBAAiB,IAAI,SAAS,EAAE,CAE/C;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAEzD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAKzE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAK7E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;CACnB,GAAG,OAAO,CAIV;AAED,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,SAAS,EACvB,SAAS,EAAE,OAAO,GACjB,aAAa,EAAE,CAKjB;AAED,wBAAgB,qDAAqD,CAAC,IAAI,EAAE;IAC1E,WAAW,EAAE,SAAS,CAAC;IACvB,yBAAyB,EAAE,OAAO,CAAC;CACpC,GAAG,OAAO,CAEV;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,yBAAyB,EAAE,OAAO,CAAC;IACnC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,OAAO,GAAG,OAAO,GAAG,EAAE,CAAC;IACxC,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAaV;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,SAAS,GACd,iBAAiB,GAAG,IAAI,CAS1B"}

package/first-run/setup-steps.js

@@ -0,0 +1,55 @@
+import { canRunLocal } from "../platform/init.js";
+import { SETUP_STEPS } from "../state/types.js";
+export function getSetupStepOrder() {
+    return SETUP_STEPS.map((s) => s.id);
+}
+export function getSetupStepIndex(step) {
+    return getSetupStepOrder().indexOf(step);
+}
+export function resolveSetupNextStep(current) {
+    const order = getSetupStepOrder();
+    const i = order.indexOf(current);
+    if (i < 0 || i >= order.length - 1)
+        return null;
+    return order[i + 1] ?? null;
+}
+export function resolveSetupPreviousStep(current) {
+    const order = getSetupStepOrder();
+    const i = order.indexOf(current);
+    if (i > 0)
+        return order[i - 1] ?? null;
+    return null;
+}
+export function canRevertSetupTo(params) {
+    const curIdx = getSetupStepIndex(params.current);
+    const tgtIdx = getSetupStepIndex(params.target);
+    return tgtIdx >= 0 && curIdx >= 0 && tgtIdx < curIdx;
+}
+export function getSetupNavMetas(_currentStep, cloudOnly) {
+    if (cloudOnly || canRunLocal()) {
+        return SETUP_STEPS.filter((s) => s.id !== "connection");
+    }
+    return [...SETUP_STEPS];
+}
+export function shouldSkipConnectionStepsForCloudProvisionedContainer(args) {
+    return args.cloudProvisionedContainer && args.currentStep === "connection";
+}
+export function shouldUseCloudSetupFastTrack(args) {
+    if (args.cloudProvisionedContainer) {
+        return true;
+    }
+    return (args.elizaCloudConnected &&
+        !(args.firstRunRunMode === "local" &&
+            args.firstRunProvider &&
+            args.firstRunProvider !== "elizacloud"));
+}
+export function getFlaminaTopicForSetupStep(step) {
+    switch (step) {
+        case "model":
+            return "provider";
+        case "capabilities":
+            return "features";
+        default:
+            return null;
+    }
+}

package/first-run/use-first-run-controller.d.ts

@@ -0,0 +1,46 @@
+import type { CloudCompatAgent } from "../api/client-types-cloud";
+import { type FirstRunDraftUpdate, type FirstRunProfileDraft, type FirstRunStep } from "./first-run";
+import { type MicrophonePermissionController } from "./use-microphone-permission";
+export interface FirstRunVoiceState {
+    supported: boolean;
+    listening: boolean;
+    speaking: boolean;
+    transcript: string;
+    error: string | null;
+}
+/** Phase of the post-sign-in cloud agent picker (the "pick-agent" step). */
+export type FirstRunPickerPhase = "loading" | "ready" | "error" | "binding";
+export interface FirstRunController {
+    step: FirstRunStep;
+    draft: FirstRunProfileDraft;
+    localRuntimeAvailable: boolean;
+    cloudOnly: boolean;
+    elizaCloudConnected: boolean;
+    submitting: boolean;
+    busyText: string | null;
+    error: string | null;
+    cloudError: string | null | undefined;
+    voice: FirstRunVoiceState;
+    microphone: MicrophonePermissionController;
+    primaryLabel: string;
+    canBack: boolean;
+    pickerAgents: CloudCompatAgent[];
+    pickerPhase: FirstRunPickerPhase;
+    pickerError: string | null;
+    pickerActiveAgentId: string | null;
+    pickerBindingId: string | null;
+    onPickAgent: (agentId: string) => void;
+    onCreateNewAgent: () => void;
+    onRetryPicker: () => void;
+    onBackFromPicker: () => void;
+    updateDraft: FirstRunDraftUpdate;
+    setStep: (step: FirstRunStep) => void;
+    goBack: () => void;
+    finishRuntime: () => Promise<void>;
+    startVoice: () => Promise<void>;
+    stopVoice: () => Promise<void>;
+    toggleVoice: () => Promise<void>;
+    onPromptReady: (promptText: string, lineId: string) => void;
+}
+export declare function useFirstRunController(): FirstRunController;
+//# sourceMappingURL=use-first-run-controller.d.ts.map

package/first-run/use-first-run-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-first-run-controller.d.ts","sourceRoot":"","sources":["../../../../../src/first-run/use-first-run-controller.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAyBlE,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAEzB,KAAK,YAAY,EAWlB,MAAM,aAAa,CAAC;AASrB,OAAO,EACL,KAAK,8BAA8B,EAEpC,MAAM,6BAA6B,CAAC;AAoBrC,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,4EAA4E;AAC5E,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAE5E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACtC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,UAAU,EAAE,8BAA8B,CAAC;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IAEjB,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,WAAW,EAAE,mBAAmB,CAAC;IACjC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,WAAW,EAAE,mBAAmB,CAAC;IACjC,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IACtC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7D;AAoLD,wBAAgB,qBAAqB,IAAI,kBAAkB,CAmiC1D"}