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

package/desktop-runtime/DesktopOnboardingRuntime.js

@@ -0,0 +1,10 @@
+/**
+ * DesktopOnboardingRuntime — placeholder.
+ *
+ * Previously triggered a desktop background notice during the permissions
+ * onboarding step. Permissions are now requested lazily when features need
+ * them, so this component is a no-op until the lazy permission flow is wired.
+ */
+export function DesktopOnboardingRuntime() {
+    return null;
+}

package/desktop-runtime/DesktopSurfaceNavigationRuntime.d.ts

@@ -0,0 +1,2 @@
+export declare function DesktopSurfaceNavigationRuntime(): null;
+//# sourceMappingURL=DesktopSurfaceNavigationRuntime.d.ts.map

package/desktop-runtime/DesktopSurfaceNavigationRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesktopSurfaceNavigationRuntime.d.ts","sourceRoot":"","sources":["../../../../../src/desktop-runtime/DesktopSurfaceNavigationRuntime.tsx"],"names":[],"mappings":"AAoBA,wBAAgB,+BAA+B,SAkC9C"}

package/desktop-runtime/DesktopSurfaceNavigationRuntime.js

@@ -0,0 +1,48 @@
+import { useEffect } from "react";
+import { subscribeDesktopBridgeEvent } from "../bridge/electrobun-rpc.js";
+import { useApp } from "../state/useApp.js";
+const MAIN_SURFACE_TABS = new Set([
+    "chat",
+    "plugins",
+    "connectors",
+    "triggers",
+]);
+const MAIN_NAVIGATION_TABS = new Set([
+    "chat",
+    "plugins",
+    "connectors",
+    "triggers",
+    "lifeops",
+    "settings",
+]);
+export function DesktopSurfaceNavigationRuntime() {
+    const { setTab, switchShellView } = useApp();
+    useEffect(() => {
+        return subscribeDesktopBridgeEvent({
+            rpcMessage: "desktopTrayMenuClick",
+            ipcChannel: "desktop:trayMenuClick",
+            listener: (payload) => {
+                const itemId = payload?.itemId ?? "";
+                let target = null;
+                if (itemId.startsWith("show-main:")) {
+                    const candidate = itemId.slice("show-main:".length);
+                    if (MAIN_SURFACE_TABS.has(candidate)) {
+                        target = candidate;
+                    }
+                }
+                else if (itemId.startsWith("navigate-")) {
+                    const candidate = itemId.slice("navigate-".length);
+                    if (MAIN_NAVIGATION_TABS.has(candidate)) {
+                        target = candidate;
+                    }
+                }
+                if (!target) {
+                    return;
+                }
+                switchShellView("desktop");
+                setTab(target);
+            },
+        });
+    }, [setTab, switchShellView]);
+    return null;
+}

package/desktop-runtime/DesktopTrayRuntime.d.ts

@@ -0,0 +1,11 @@
+import type { DesktopClickAuditItem } from "../utils/desktop-workspace";
+interface DesktopTrayMenuItem {
+    id: string;
+    label?: string;
+    type?: "normal" | "separator";
+}
+export declare const DESKTOP_TRAY_MENU_ITEMS: readonly DesktopTrayMenuItem[];
+export declare const DESKTOP_TRAY_CLICK_AUDIT: readonly DesktopClickAuditItem[];
+export declare function DesktopTrayRuntime(): null;
+export {};
+//# sourceMappingURL=DesktopTrayRuntime.d.ts.map

package/desktop-runtime/DesktopTrayRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesktopTrayRuntime.d.ts","sourceRoot":"","sources":["../../../../../src/desktop-runtime/DesktopTrayRuntime.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGxE,UAAU,mBAAmB;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;CAC/B;AAED,eAAO,MAAM,uBAAuB,EAAE,SAAS,mBAAmB,EAcxD,CAAC;AAEX,eAAO,MAAM,wBAAwB,EAAE,SAAS,qBAAqB,EAmF3D,CAAC;AAeX,wBAAgB,kBAAkB,SAoLjC"}

package/desktop-runtime/DesktopTrayRuntime.js

@@ -0,0 +1,265 @@
+import { useEffect } from "react";
+import { getElectrobunRendererRpc, invokeDesktopBridgeRequest, subscribeDesktopBridgeEvent, } from "../bridge/electrobun-rpc.js";
+import { isElectrobunRuntime } from "../bridge/electrobun-runtime.js";
+import { TRAY_ACTION_EVENT } from "../events/index.js";
+import { useApp } from "../state/useApp.js";
+import { openDesktopSettingsWindow } from "../utils/desktop-workspace.js";
+export const DESKTOP_TRAY_MENU_ITEMS = [
+    { id: "tray-open-chat", label: "Open Chat" },
+    { id: "tray-open-plugins", label: "Open Plugins" },
+    { id: "tray-open-desktop-workspace", label: "Open Desktop Workspace" },
+    { id: "tray-open-voice-controls", label: "Open Voice Controls" },
+    { id: "tray-sep-0", type: "separator" },
+    { id: "tray-toggle-lifecycle", label: "Start/Stop Agent" },
+    { id: "tray-restart", label: "Restart Agent" },
+    { id: "tray-notify", label: "Send Test Notification" },
+    { id: "tray-sep-1", type: "separator" },
+    { id: "tray-show-window", label: "Show Window" },
+    { id: "tray-hide-window", label: "Hide Window" },
+    { id: "tray-sep-2", type: "separator" },
+    { id: "quit", label: "Quit" },
+];
+export const DESKTOP_TRAY_CLICK_AUDIT = [
+    {
+        id: "tray-open-chat",
+        entryPoint: "tray",
+        label: "Open Chat",
+        expectedAction: "Show and focus the main window, then switch to chat.",
+        runtimeRequirement: "desktop",
+        coverage: "automated",
+    },
+    {
+        id: "tray-open-plugins",
+        entryPoint: "tray",
+        label: "Open Plugins",
+        expectedAction: "Show and focus the main window, then switch to plugins.",
+        runtimeRequirement: "desktop",
+        coverage: "automated",
+    },
+    {
+        id: "tray-open-desktop-workspace",
+        entryPoint: "tray",
+        label: "Open Desktop Workspace",
+        expectedAction: "Open a detached settings window focused on the desktop workspace section.",
+        runtimeRequirement: "desktop",
+        coverage: "automated",
+    },
+    {
+        id: "tray-open-voice-controls",
+        entryPoint: "tray",
+        label: "Open Voice Controls",
+        expectedAction: "Open a detached settings window focused on the voice controls section.",
+        runtimeRequirement: "desktop",
+        coverage: "automated",
+    },
+    {
+        id: "tray-toggle-lifecycle",
+        entryPoint: "tray",
+        label: "Start/Stop Agent",
+        expectedAction: "Start a stopped agent or stop a running agent.",
+        runtimeRequirement: "desktop",
+        coverage: "automated",
+    },
+    {
+        id: "tray-restart",
+        entryPoint: "tray",
+        label: "Restart Agent",
+        expectedAction: "Restart the desktop agent runtime.",
+        runtimeRequirement: "desktop",
+        coverage: "automated",
+    },
+    {
+        id: "tray-notify",
+        entryPoint: "tray",
+        label: "Send Test Notification",
+        expectedAction: "Emit a desktop notification from the renderer.",
+        runtimeRequirement: "desktop",
+        coverage: "automated",
+    },
+    {
+        id: "tray-show-window",
+        entryPoint: "tray",
+        label: "Show Window",
+        expectedAction: "Show and focus the main desktop window.",
+        runtimeRequirement: "desktop",
+        coverage: "automated",
+    },
+    {
+        id: "tray-hide-window",
+        entryPoint: "tray",
+        label: "Hide Window",
+        expectedAction: "Hide the main desktop window.",
+        runtimeRequirement: "desktop",
+        coverage: "automated",
+    },
+    {
+        id: "quit",
+        entryPoint: "tray",
+        label: "Quit",
+        expectedAction: "Quit the desktop application.",
+        runtimeRequirement: "desktop",
+        coverage: "manual",
+    },
+];
+function isAgentActive(state) {
+    return !(state === null ||
+        state === undefined ||
+        state === "stopped" ||
+        state === "not_started");
+}
+export function DesktopTrayRuntime() {
+    const { agentStatus, handleRestart, handleReset, handleResetAppliedFromMain, handleStart, handleStop, setTab, switchShellView, } = useApp();
+    // App menu "Reset App…" reuses the same push channel as tray `navigate-*`.
+    // WHY: Electrobun already bridges `desktopTrayMenuClick`; no new IPC type needed.
+    // WHY handleReset here: one implementation with Settings (confirm + API + state).
+    useEffect(() => {
+        if (!isElectrobunRuntime()) {
+            return;
+        }
+        let cancelled = false;
+        let unsubscribe = null;
+        let rpcBridgeWaitTimeoutId = null;
+        const attach = () => {
+            if (cancelled || !getElectrobunRendererRpc()) {
+                return false;
+            }
+            if (unsubscribe) {
+                unsubscribe();
+                unsubscribe = null;
+            }
+            unsubscribe = subscribeDesktopBridgeEvent({
+                rpcMessage: "desktopTrayMenuClick",
+                ipcChannel: "desktop:trayMenuClick",
+                listener: (payload) => {
+                    const itemId = payload?.itemId ?? "";
+                    if (itemId === "menu-reset-app-applied") {
+                        console.info("[eliza][reset] menu: main-process reset finished — syncing renderer", { itemId });
+                        void handleResetAppliedFromMain(payload);
+                        return;
+                    }
+                    if (itemId !== "menu-reset-app") {
+                        return;
+                    }
+                    console.info("[eliza][reset] menu: Reset App clicked (legacy IPC — renderer confirm)", { itemId });
+                    void handleReset();
+                },
+            });
+            console.info("[eliza][reset] tray: subscribed to desktopTrayMenuClick (menu Reset App path)");
+            return true;
+        };
+        if (!attach()) {
+            // Poll until the RPC bridge is ready. On Windows, PGLite init can
+            // take up to 240s so a hard 10s ceiling caused the tray subscription
+            // to silently never attach. Back off from 200ms → 2s to stay cheap.
+            let pollMs = 200;
+            const MAX_POLL_MS = 2_000;
+            const schedulePoll = () => {
+                if (cancelled)
+                    return;
+                rpcBridgeWaitTimeoutId = setTimeout(() => {
+                    rpcBridgeWaitTimeoutId = null;
+                    if (cancelled)
+                        return;
+                    if (attach())
+                        return; // success — stop polling
+                    pollMs = Math.min(pollMs * 1.5, MAX_POLL_MS);
+                    schedulePoll();
+                }, pollMs);
+            };
+            schedulePoll();
+        }
+        return () => {
+            cancelled = true;
+            if (rpcBridgeWaitTimeoutId)
+                clearTimeout(rpcBridgeWaitTimeoutId);
+            unsubscribe?.();
+        };
+    }, [handleReset, handleResetAppliedFromMain]);
+    useEffect(() => {
+        if (!isElectrobunRuntime()) {
+            return;
+        }
+        const handleTrayAction = (event) => {
+            const detail = event.detail;
+            const itemId = detail?.itemId ?? "";
+            const showAndFocusWindow = async () => {
+                await invokeDesktopBridgeRequest({
+                    rpcMethod: "desktopShowWindow",
+                    ipcChannel: "desktop:showWindow",
+                });
+                await invokeDesktopBridgeRequest({
+                    rpcMethod: "desktopFocusWindow",
+                    ipcChannel: "desktop:focusWindow",
+                });
+            };
+            const run = async () => {
+                switch (itemId) {
+                    case "tray-open-chat":
+                        switchShellView("desktop");
+                        setTab("chat");
+                        await showAndFocusWindow();
+                        return;
+                    case "tray-open-plugins":
+                        switchShellView("desktop");
+                        setTab("plugins");
+                        await showAndFocusWindow();
+                        return;
+                    case "tray-open-desktop-workspace":
+                        await openDesktopSettingsWindow("desktop");
+                        return;
+                    case "tray-open-voice-controls":
+                        await openDesktopSettingsWindow("voice");
+                        return;
+                    case "tray-toggle-lifecycle":
+                        if (isAgentActive(agentStatus?.state)) {
+                            await handleStop();
+                        }
+                        else {
+                            await handleStart();
+                        }
+                        return;
+                    case "tray-restart":
+                        await handleRestart();
+                        return;
+                    case "tray-notify":
+                        await invokeDesktopBridgeRequest({
+                            rpcMethod: "desktopShowNotification",
+                            ipcChannel: "desktop:showNotification",
+                            params: {
+                                title: "Desktop",
+                                body: "Renderer tray actions are wired and responding.",
+                                urgency: "normal",
+                            },
+                        });
+                        return;
+                    case "tray-show-window":
+                        await showAndFocusWindow();
+                        return;
+                    case "tray-hide-window":
+                        await invokeDesktopBridgeRequest({
+                            rpcMethod: "desktopHideWindow",
+                            ipcChannel: "desktop:hideWindow",
+                        });
+                        return;
+                    default:
+                        return;
+                }
+            };
+            void run().catch((error) => {
+                console.warn("[eliza] Desktop tray action failed:", error);
+            });
+        };
+        document.addEventListener(TRAY_ACTION_EVENT, handleTrayAction);
+        return () => {
+            document.removeEventListener(TRAY_ACTION_EVENT, handleTrayAction);
+        };
+    }, [
+        agentStatus?.state,
+        handleRestart,
+        handleStart,
+        handleStop,
+        setTab,
+        switchShellView,
+    ]);
+    return null;
+}

package/desktop-runtime/DetachedShellRoot.d.ts

@@ -0,0 +1,10 @@
+import { type JSX } from "react";
+import { type WindowShellRoute } from "../platform/window-shell";
+interface DetachedShellRootProps {
+    route: Exclude<WindowShellRoute, {
+        mode: "main";
+    }>;
+}
+export declare function DetachedShellRoot({ route, }: DetachedShellRootProps): JSX.Element;
+export {};
+//# sourceMappingURL=DetachedShellRoot.d.ts.map

package/desktop-runtime/DetachedShellRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetachedShellRoot.d.ts","sourceRoot":"","sources":["../../../../../src/desktop-runtime/DetachedShellRoot.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,GAAG,EAKT,MAAM,OAAO,CAAC;AAcf,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,0BAA0B,CAAC;AAIlC,UAAU,sBAAsB;IAC9B,KAAK,EAAE,OAAO,CAAC,gBAAgB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAsMD,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,GACN,EAAE,sBAAsB,GAAG,GAAG,CAAC,OAAO,CAuCtC"}

package/desktop-runtime/DetachedShellRoot.js

@@ -0,0 +1,114 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { lazy, Suspense, } from "react";
+import { ConversationsSidebar } from "../components/conversations/ConversationsSidebar.js";
+import { ChatView } from "../components/pages/ChatView.js";
+import { ConfigPageView } from "../components/pages/ConfigPageView.js";
+import { CloudDashboard } from "../components/pages/ElizaCloudDashboard.js";
+import { HeartbeatsView } from "../components/pages/HeartbeatsView.js";
+import { ReleaseCenterView } from "../components/pages/ReleaseCenterView.js";
+import { PermissionsSection } from "../components/settings/PermissionsSection.js";
+import { ProviderSwitcher } from "../components/settings/ProviderSwitcher.js";
+import { VoiceConfigView } from "../components/settings/VoiceConfigView.js";
+import { PairingView } from "../components/shell/PairingView.js";
+import { StartupFailureView } from "../components/shell/StartupFailureView.js";
+import { AppWorkspaceChrome } from "../components/workspace/AppWorkspaceChrome.js";
+import { resolveDetachedShellTarget, } from "../platform/window-shell.js";
+import { CodingAgentSettingsSection } from "../slots/task-coordinator-slots.js";
+import { useApp } from "../state/useApp.js";
+function lazyNamedView(load, exportName) {
+    return lazy(async () => {
+        const module = await load();
+        const component = module[exportName];
+        if (typeof component !== "function") {
+            throw new Error(`Missing component export: ${String(exportName)}`);
+        }
+        return {
+            default: component,
+        };
+    });
+}
+const BrowserWorkspaceView = lazyNamedView(() => import("../components/pages/BrowserWorkspaceView.js"), "BrowserWorkspaceView");
+const ConnectorsPageView = lazyNamedView(() => import("../components/pages/ConnectorsPageView.js"), "ConnectorsPageView");
+// Static import: PluginsPageView is statically imported by App.tsx and
+// AppWindowRenderer; a lazy() here can't move it into a separate chunk
+// and just adds a wasted Suspense boundary.
+import { PluginsPageView } from "../components/pages/PluginsPageView.js";
+const SettingsView = lazyNamedView(() => import("../components/pages/SettingsView.js"), "SettingsView");
+function DetachedLazyBoundary({ children }) {
+    return (_jsx(Suspense, { fallback: _jsx("div", { className: "flex flex-1 items-center justify-center text-sm text-muted", children: "Loading\u2026" }), children: children }));
+}
+function DetachedSettingsSectionView({ section, }) {
+    switch (section) {
+        case "ai-model":
+            return _jsx(ProviderSwitcher, {});
+        case "cloud":
+            return _jsx(CloudDashboard, {});
+        case "coding-agents":
+            return _jsx(CodingAgentSettingsSection, {});
+        case "wallet-rpc":
+            return _jsx(ConfigPageView, { embedded: true });
+        case "voice":
+            return _jsx(VoiceConfigView, {});
+        case "permissions":
+            return _jsx(PermissionsSection, {});
+        case "updates":
+            return _jsx(ReleaseCenterView, {});
+        default:
+            return _jsx(SettingsView, { initialSection: section });
+    }
+}
+function DetachedChatView() {
+    const { t } = useApp();
+    return (_jsxs("div", { className: "flex flex-1 min-h-0 relative", children: [_jsx("nav", { "aria-label": t("chat.conversations"), children: _jsx(ConversationsSidebar, {}) }), _jsx("div", { className: "flex flex-col flex-1 min-h-0 min-w-0 overflow-hidden", children: _jsx(ChatView, {}) })] }));
+}
+function DetachedWorkspaceView({ children, chatScope, }) {
+    return (_jsx(AppWorkspaceChrome, { testId: `detached-${chatScope}`, chatScope: chatScope, main: _jsx("div", { className: "flex min-h-0 min-w-0 flex-1 flex-col overflow-hidden", children: children }) }));
+}
+function OnboardingBlockedView() {
+    const { t } = useApp();
+    return (_jsxs("div", { "data-testid": "onboarding-ui-overlay", className: "flex flex-col items-center justify-center flex-1 min-h-0 gap-4 text-center px-6", children: [_jsx("div", { className: "text-4xl", children: "\uD83C\uDF80" }), _jsx("h2", { className: "text-lg font-semibold text-txt", children: t("detachedshell.SetupInProgress", {
+                    defaultValue: "Setup in progress",
+                }) }), _jsx("p", { className: "text-sm text-muted max-w-sm", children: t("detachedshell.SetupInProgressDesc", {
+                    defaultValue: "Complete onboarding in the main window first. This window will become available once your agent is ready.",
+                }) })] }));
+}
+function DetachedShellContent({ route }) {
+    const { t } = useApp();
+    const target = resolveDetachedShellTarget(route);
+    switch (target.tab) {
+        case "browser":
+            return (_jsx(DetachedLazyBoundary, { children: _jsx(BrowserWorkspaceView, {}) }));
+        case "chat":
+            return _jsx(DetachedChatView, {});
+        case "connectors":
+            return (_jsx(DetachedWorkspaceView, { chatScope: "page-connectors", children: _jsx(DetachedLazyBoundary, { children: _jsx(ConnectorsPageView, {}) }) }));
+        case "plugins":
+            return (_jsx(DetachedWorkspaceView, { chatScope: "page-plugins", children: _jsx(DetachedLazyBoundary, { children: _jsx(PluginsPageView, {}) }) }));
+        case "triggers":
+            return (_jsx(DetachedWorkspaceView, { chatScope: "page-automations", children: _jsx(HeartbeatsView, {}) }));
+        case "settings":
+            return (_jsx(DetachedWorkspaceView, { chatScope: "page-settings", children: _jsx(DetachedLazyBoundary, { children: _jsx("section", { className: "w-full overflow-y-auto px-4 py-4 lg:px-6", children: _jsx(DetachedSettingsSectionView, { section: target.settingsSection }) }) }) }));
+        default: {
+            const _exhaustive = target.tab;
+            return (_jsx("div", { className: "flex flex-1 items-center justify-center text-sm text-muted", children: t("detachedshell.UnknownView", {
+                    defaultValue: "Unknown view: {{view}}",
+                    view: String(_exhaustive),
+                }) }));
+        }
+    }
+}
+export function DetachedShellRoot({ route, }) {
+    const { authRequired, onboardingComplete, retryStartup, startupError, t } = useApp();
+    if (startupError) {
+        return _jsx(StartupFailureView, { error: startupError, onRetry: retryStartup });
+    }
+    if (authRequired) {
+        return _jsx(PairingView, {});
+    }
+    if (!onboardingComplete) {
+        return (_jsx("div", { className: "flex h-full min-h-0 w-full flex-col font-body text-txt bg-bg", children: _jsx("main", { className: "flex min-h-0 min-w-0 flex-1 flex-col overflow-hidden", children: _jsx(OnboardingBlockedView, {}) }) }));
+    }
+    return (_jsxs("div", { className: "flex h-full min-h-0 w-full flex-col font-body text-txt bg-bg", children: [_jsx("a", { href: "#detached-main", className: "sr-only focus:not-sr-only focus:absolute focus:z-50 focus:p-2 focus:bg-bg focus:text-txt", children: t("detachedshell.SkipToContent", {
+                    defaultValue: "Skip to content",
+                }) }), _jsx("main", { id: "detached-main", className: "flex min-h-0 min-w-0 flex-1 flex-col overflow-hidden", children: _jsx(DetachedShellContent, { route: route }) })] }));
+}

package/desktop-runtime/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./AppWindowRenderer";
+export * from "./DesktopOnboardingRuntime";
+export * from "./DesktopSurfaceNavigationRuntime";
+export * from "./DesktopTrayRuntime";
+export * from "./DetachedShellRoot";
+//# sourceMappingURL=index.d.ts.map

package/desktop-runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/desktop-runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC"}

package/desktop-runtime/index.js

@@ -0,0 +1,5 @@
+export * from "./AppWindowRenderer.js";
+export * from "./DesktopOnboardingRuntime.js";
+export * from "./DesktopSurfaceNavigationRuntime.js";
+export * from "./DesktopTrayRuntime.js";
+export * from "./DetachedShellRoot.js";

package/events/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Typed constants for eliza:* custom events dispatched across the app.
+ *
+ * Using these constants instead of raw strings prevents typo-driven drift
+ * between producers (main.tsx, bridge, components) and consumers (AppContext,
+ * EmotePicker, ChatView, etc.).
+ */
+export declare const COMMAND_PALETTE_EVENT: "eliza:command-palette";
+export declare const EMOTE_PICKER_EVENT: "eliza:emote-picker";
+export declare const STOP_EMOTE_EVENT: "eliza:stop-emote";
+export declare const AGENT_READY_EVENT: "eliza:agent-ready";
+export declare const BRIDGE_READY_EVENT: "eliza:bridge-ready";
+export declare const SHARE_TARGET_EVENT: "eliza:share-target";
+export declare const TRAY_ACTION_EVENT: "eliza:tray-action";
+export declare const APP_RESUME_EVENT: "eliza:app-resume";
+export declare const APP_PAUSE_EVENT: "eliza:app-pause";
+export declare const CONNECT_EVENT: "eliza:connect";
+export declare const MOBILE_RUNTIME_MODE_CHANGED_EVENT: "eliza:mobile-runtime-mode-changed";
+export declare const VOICE_CONFIG_UPDATED_EVENT: "eliza:voice-config-updated";
+export declare const CHAT_AVATAR_VOICE_EVENT: "eliza:chat-avatar-voice";
+export declare const APP_EMOTE_EVENT: "eliza:app-emote";
+/** After `/api/cloud/status` — chat voice reloads config so cloud-backed TTS mode matches the server snapshot. */
+export declare const ELIZA_CLOUD_STATUS_UPDATED_EVENT: "eliza:cloud-status-updated";
+export interface ElizaCloudStatusUpdatedDetail {
+    /** Same as cloud status `connected` (auth or API key on server). */
+    connected: boolean;
+    /** True only when Eliza Cloud inference is the active connection. */
+    enabled: boolean;
+    /** Server reports a persisted Eliza Cloud API key. */
+    hasPersistedApiKey: boolean;
+    /** True only when cloud voice/chat routing should actively use the proxy. */
+    cloudVoiceProxyAvailable: boolean;
+}
+export declare const VRM_TELEPORT_COMPLETE_EVENT: "eliza:vrm-teleport-complete";
+/** IdentityStep dispatches this after queuing a post-teleport voice preview; OnboardingWizard echoes {@link VRM_TELEPORT_COMPLETE_EVENT} when VRM is off. */
+export declare const ONBOARDING_VOICE_PREVIEW_AWAIT_TELEPORT_EVENT: "eliza:onboarding-voice-preview-await-teleport";
+export declare const SELF_STATUS_SYNC_EVENT: "eliza:self-status-refresh";
+export interface AppEmoteEventDetail {
+    emoteId: string;
+    path: string;
+    duration: number;
+    loop: boolean;
+    showOverlay?: boolean;
+}
+export interface ChatAvatarVoiceEventDetail {
+    mouthOpen: number;
+    isSpeaking: boolean;
+}
+export type ElizaDocumentEventName = typeof COMMAND_PALETTE_EVENT | typeof EMOTE_PICKER_EVENT | typeof STOP_EMOTE_EVENT | typeof AGENT_READY_EVENT | typeof BRIDGE_READY_EVENT | typeof SHARE_TARGET_EVENT | typeof TRAY_ACTION_EVENT | typeof APP_RESUME_EVENT | typeof APP_PAUSE_EVENT | typeof CONNECT_EVENT | typeof MOBILE_RUNTIME_MODE_CHANGED_EVENT;
+export type ElizaWindowEventName = typeof VOICE_CONFIG_UPDATED_EVENT | typeof CHAT_AVATAR_VOICE_EVENT | typeof APP_EMOTE_EVENT | typeof ELIZA_CLOUD_STATUS_UPDATED_EVENT | typeof VRM_TELEPORT_COMPLETE_EVENT | typeof ONBOARDING_VOICE_PREVIEW_AWAIT_TELEPORT_EVENT | typeof SELF_STATUS_SYNC_EVENT;
+export type ElizaEventName = ElizaDocumentEventName | ElizaWindowEventName;
+/** Dispatch a typed custom event on `document`. */
+export declare function dispatchAppEvent(name: ElizaDocumentEventName, detail?: unknown): void;
+/** Dispatch a typed custom event on `window`. */
+export declare function dispatchWindowEvent(name: ElizaWindowEventName, detail?: unknown): void;
+/** Dispatch a normalized app-wide emote event on `window`. */
+export declare function dispatchAppEmoteEvent(detail: AppEmoteEventDetail): void;
+export declare function dispatchElizaCloudStatusUpdated(detail: ElizaCloudStatusUpdatedDetail): void;
+export type AppDocumentEventName = ElizaDocumentEventName;
+export type AppWindowEventName = ElizaWindowEventName;
+export type AppEventName = ElizaEventName;
+//# sourceMappingURL=index.d.ts.map

package/events/index.d.ts.map

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

package/events/index.js

@@ -0,0 +1,51 @@
+/**
+ * Typed constants for eliza:* custom events dispatched across the app.
+ *
+ * Using these constants instead of raw strings prevents typo-driven drift
+ * between producers (main.tsx, bridge, components) and consumers (AppContext,
+ * EmotePicker, ChatView, etc.).
+ */
+// ── App lifecycle ────────────────────────────────────────────────────────
+export const COMMAND_PALETTE_EVENT = "eliza:command-palette";
+export const EMOTE_PICKER_EVENT = "eliza:emote-picker";
+export const STOP_EMOTE_EVENT = "eliza:stop-emote";
+// ── Agent / bridge ───────────────────────────────────────────────────────
+export const AGENT_READY_EVENT = "eliza:agent-ready";
+export const BRIDGE_READY_EVENT = "eliza:bridge-ready";
+export const SHARE_TARGET_EVENT = "eliza:share-target";
+export const TRAY_ACTION_EVENT = "eliza:tray-action";
+// ── App state ────────────────────────────────────────────────────────────
+export const APP_RESUME_EVENT = "eliza:app-resume";
+export const APP_PAUSE_EVENT = "eliza:app-pause";
+export const CONNECT_EVENT = "eliza:connect";
+export const MOBILE_RUNTIME_MODE_CHANGED_EVENT = "eliza:mobile-runtime-mode-changed";
+// ── Voice / config ───────────────────────────────────────────────────────
+export const VOICE_CONFIG_UPDATED_EVENT = "eliza:voice-config-updated";
+export const CHAT_AVATAR_VOICE_EVENT = "eliza:chat-avatar-voice";
+export const APP_EMOTE_EVENT = "eliza:app-emote";
+/** After `/api/cloud/status` — chat voice reloads config so cloud-backed TTS mode matches the server snapshot. */
+export const ELIZA_CLOUD_STATUS_UPDATED_EVENT = "eliza:cloud-status-updated";
+// ── Avatar / VRM ─────────────────────────────────────────────────────────
+export const VRM_TELEPORT_COMPLETE_EVENT = "eliza:vrm-teleport-complete";
+/** IdentityStep dispatches this after queuing a post-teleport voice preview; OnboardingWizard echoes {@link VRM_TELEPORT_COMPLETE_EVENT} when VRM is off. */
+export const ONBOARDING_VOICE_PREVIEW_AWAIT_TELEPORT_EVENT = "eliza:onboarding-voice-preview-await-teleport";
+// ── Sidebar sync ─────────────────────────────────────────────────────────
+export const SELF_STATUS_SYNC_EVENT = "eliza:self-status-refresh";
+// ── Helpers ──────────────────────────────────────────────────────────────
+/** Dispatch a typed custom event on `document`. */
+export function dispatchAppEvent(name, detail) {
+    document.dispatchEvent(new CustomEvent(name, { detail }));
+}
+/** Dispatch a typed custom event on `window`. */
+export function dispatchWindowEvent(name, detail) {
+    if (typeof window === "undefined")
+        return;
+    window.dispatchEvent(new CustomEvent(name, { detail }));
+}
+/** Dispatch a normalized app-wide emote event on `window`. */
+export function dispatchAppEmoteEvent(detail) {
+    dispatchWindowEvent(APP_EMOTE_EVENT, detail);
+}
+export function dispatchElizaCloudStatusUpdated(detail) {
+    dispatchWindowEvent(ELIZA_CLOUD_STATUS_UPDATED_EVENT, detail);
+}

package/hooks/index.d.ts

@@ -0,0 +1,20 @@
+export * from "./useActivityEvents";
+export * from "./useAutomationDeepLink";
+export * from "./useBugReport";
+export * from "./useChatAvatarVoiceBridge";
+export * from "./useConnectorAccounts";
+export * from "./useConnectorSendAsAccount";
+export * from "./useContextMenu";
+export * from "./useDocumentVisibility";
+export { COMMON_SHORTCUTS, useShortcutsHelp } from "./useKeyboardShortcuts";
+export * from "./useLinkedSidebarSelection";
+export * from "./useMediaQuery";
+export * from "./useRenderGuard";
+export * from "./useRuntimeMode";
+export * from "./useSignalPairing";
+export * from "./useStreamPopoutNavigation";
+export * from "./useTimeout";
+export * from "./useVoiceChat";
+export * from "./useWhatsAppPairing";
+export * from "./useWorkflowGenerationState";
+//# sourceMappingURL=index.d.ts.map

package/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC"}