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

package/components/apps/internal-tool-apps.js

@@ -0,0 +1,173 @@
+const INTERNAL_TOOL_APPS = [
+    {
+        name: "@elizaos/app-lifeops",
+        displayName: "LifeOps",
+        description: "Run tasks, reminders, calendar, inbox, and connected operational workflows.",
+        heroImage: "/api/apps/hero/lifeops",
+        targetTab: "lifeops",
+        capabilities: ["lifeops", "tasks", "calendar", "gmail"],
+        order: 0,
+        windowPath: "/apps/lifeops",
+    },
+    {
+        name: "@elizaos/app-plugin-viewer",
+        displayName: "Plugin Viewer",
+        description: "Inspect installed plugins, connectors, and runtime feature flags.",
+        heroImage: "/app-heroes/plugin-viewer.png",
+        targetTab: "plugins",
+        capabilities: ["plugins", "connectors", "viewer"],
+        order: 1,
+        windowPath: "/apps/plugins",
+    },
+    {
+        name: "@elizaos/app-skills-viewer",
+        displayName: "Skills Viewer",
+        description: "Create, enable, review, and install custom agent skills.",
+        heroImage: "/app-heroes/skills-viewer.png",
+        targetTab: "skills",
+        capabilities: ["skills", "viewer"],
+        order: 2,
+        windowPath: "/apps/skills",
+    },
+    {
+        name: "@elizaos/app-training",
+        displayName: "Fine Tuning",
+        description: "Build datasets, inspect trajectories, run training jobs, and activate tuned models.",
+        heroImage: "/api/apps/hero/training",
+        targetTab: "fine-tuning",
+        capabilities: ["training", "fine-tuning", "datasets", "models"],
+        order: 3,
+        windowPath: "/apps/fine-tuning",
+        hasDetailsPage: true,
+    },
+    {
+        name: "@elizaos/app-trajectory-viewer",
+        displayName: "Trajectory Viewer",
+        description: "Inspect LLM call history, prompts, and execution traces.",
+        heroImage: "/app-heroes/trajectory-viewer.png",
+        targetTab: "trajectories",
+        capabilities: ["trajectories", "debug", "viewer"],
+        order: 4,
+        windowPath: "/apps/trajectories",
+    },
+    {
+        name: "@elizaos/app-relationship-viewer",
+        displayName: "Relationship Viewer",
+        description: "Explore cross-channel people, identities, and relationship graphs.",
+        heroImage: "/app-heroes/relationship-viewer.png",
+        targetTab: "relationships",
+        capabilities: ["relationships", "graph", "viewer"],
+        order: 5,
+        windowPath: "/apps/relationships",
+    },
+    {
+        name: "@elizaos/app-memory-viewer",
+        displayName: "Memory Viewer",
+        description: "Browse memory, fact, and extraction activity.",
+        heroImage: "/app-heroes/memory-viewer.png",
+        targetTab: "memories",
+        capabilities: ["memory", "facts", "viewer"],
+        order: 6,
+        windowPath: "/apps/memories",
+    },
+    {
+        name: "@elizaos/app-steward",
+        displayName: "Steward",
+        description: "Review wallet approvals, transaction history, and signing execution status.",
+        heroImage: "/api/apps/hero/steward",
+        targetTab: "inventory",
+        capabilities: ["wallet", "transactions", "approvals", "trading"],
+        order: 7,
+        windowPath: "/apps/inventory",
+        hasDetailsPage: true,
+    },
+    {
+        name: "@elizaos/app-runtime-debugger",
+        displayName: "Runtime Debugger",
+        description: "Inspect runtime objects, plugin order, providers, and services.",
+        heroImage: "/app-heroes/runtime-debugger.png",
+        targetTab: "runtime",
+        capabilities: ["runtime", "debug", "viewer"],
+        order: 8,
+        windowPath: "/apps/runtime",
+    },
+    {
+        name: "@elizaos/app-database-viewer",
+        displayName: "Database Viewer",
+        description: "Inspect tables, media, vectors, and ad-hoc SQL.",
+        heroImage: "/app-heroes/database-viewer.png",
+        targetTab: "database",
+        capabilities: ["database", "sql", "viewer"],
+        order: 9,
+        windowPath: "/apps/database",
+    },
+    {
+        name: "@elizaos/app-elizamaker",
+        displayName: "ElizaMaker",
+        description: "Run drop, mint, whitelist, and verification workflows through the agent surfaces.",
+        heroImage: "/api/apps/hero/elizamaker",
+        targetTab: "chat",
+        capabilities: ["drops", "minting", "whitelist", "verification"],
+        order: 10,
+        windowPath: "/apps/elizamaker",
+        hasDetailsPage: true,
+    },
+    {
+        name: "@elizaos/app-log-viewer",
+        displayName: "Log Viewer",
+        description: "Search runtime and service logs.",
+        heroImage: "/app-heroes/log-viewer.png",
+        targetTab: "logs",
+        capabilities: ["logs", "debug", "viewer"],
+        order: 11,
+        windowPath: "/apps/logs",
+    },
+];
+const INTERNAL_TOOL_APP_BY_NAME = new Map(INTERNAL_TOOL_APPS.map((app) => [app.name, app]));
+export function getInternalToolApps() {
+    return INTERNAL_TOOL_APPS.map((app) => ({
+        name: app.name,
+        displayName: app.displayName,
+        description: app.description,
+        category: "utility",
+        launchType: "local",
+        launchUrl: null,
+        icon: null,
+        heroImage: app.heroImage ?? null,
+        capabilities: app.capabilities,
+        stars: 0,
+        repository: "",
+        latestVersion: null,
+        supports: { v0: false, v1: false, v2: true },
+        npm: {
+            package: app.name,
+            v0Version: null,
+            v1Version: null,
+            v2Version: null,
+        },
+    }));
+}
+export function isInternalToolApp(name) {
+    return INTERNAL_TOOL_APP_BY_NAME.has(name);
+}
+export function getInternalToolAppTargetTab(name) {
+    return INTERNAL_TOOL_APP_BY_NAME.get(name)?.targetTab ?? null;
+}
+export function getInternalToolAppCatalogOrder(name) {
+    return INTERNAL_TOOL_APP_BY_NAME.get(name)?.order ?? Number.MAX_SAFE_INTEGER;
+}
+export function getInternalToolAppWindowPath(name) {
+    return INTERNAL_TOOL_APP_BY_NAME.get(name)?.windowPath ?? null;
+}
+export function getInternalToolAppHasDetailsPage(name) {
+    return INTERNAL_TOOL_APP_BY_NAME.get(name)?.hasDetailsPage === true;
+}
+export function getInternalToolAppDescriptors() {
+    return INTERNAL_TOOL_APPS.map((app) => ({
+        name: app.name,
+        displayName: app.displayName,
+        windowPath: app.windowPath ?? null,
+        hasDetailsPage: app.hasDetailsPage === true,
+        order: app.order,
+    }));
+}

package/components/apps/launch-history.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Ring buffer of recent app launch attempts for the App Details diagnostics
+ * panel. Persisted to localStorage as a single array — capped at MAX entries.
+ */
+import type { AppLaunchDiagnostic } from "../../api";
+export interface LaunchAttemptRecord {
+    timestamp: number;
+    appName: string;
+    succeeded: boolean;
+    diagnostics: AppLaunchDiagnostic[];
+    errorMessage?: string;
+}
+export declare function recordLaunchAttempt(record: LaunchAttemptRecord): void;
+export declare function getLaunchHistoryForApp(appName: string): LaunchAttemptRecord[];
+export declare function clearLaunchHistory(): void;
+//# sourceMappingURL=launch-history.d.ts.map

package/components/apps/launch-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-history.d.ts","sourceRoot":"","sources":["../../../../../../src/components/apps/launch-history.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAErD,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAuDD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAGrE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAE7E;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAOzC"}

package/components/apps/launch-history.js

@@ -0,0 +1,77 @@
+/**
+ * Ring buffer of recent app launch attempts for the App Details diagnostics
+ * panel. Persisted to localStorage as a single array — capped at MAX entries.
+ */
+const KEY = "eliza:apps:launch-history";
+const MAX = 20;
+function isDiagnostic(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const candidate = value;
+    return (typeof candidate.message === "string" &&
+        (candidate.severity === "info" ||
+            candidate.severity === "warning" ||
+            candidate.severity === "error"));
+}
+function isRecord(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const candidate = value;
+    if (typeof candidate.timestamp !== "number")
+        return false;
+    if (typeof candidate.appName !== "string")
+        return false;
+    if (typeof candidate.succeeded !== "boolean")
+        return false;
+    if (!Array.isArray(candidate.diagnostics))
+        return false;
+    if (candidate.errorMessage !== undefined &&
+        typeof candidate.errorMessage !== "string") {
+        return false;
+    }
+    return candidate.diagnostics.every(isDiagnostic);
+}
+function loadAll() {
+    if (typeof window === "undefined")
+        return [];
+    try {
+        const raw = window.localStorage.getItem(KEY);
+        if (!raw)
+            return [];
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.filter(isRecord);
+    }
+    catch {
+        return [];
+    }
+}
+function saveAll(records) {
+    if (typeof window === "undefined")
+        return;
+    try {
+        const trimmed = records.slice(0, MAX);
+        window.localStorage.setItem(KEY, JSON.stringify(trimmed));
+    }
+    catch {
+        /* ignore — sandboxed storage */
+    }
+}
+export function recordLaunchAttempt(record) {
+    const existing = loadAll();
+    saveAll([record, ...existing].slice(0, MAX));
+}
+export function getLaunchHistoryForApp(appName) {
+    return loadAll().filter((record) => record.appName === appName);
+}
+export function clearLaunchHistory() {
+    if (typeof window === "undefined")
+        return;
+    try {
+        window.localStorage.removeItem(KEY);
+    }
+    catch {
+        /* ignore */
+    }
+}

package/components/apps/load-apps-catalog.d.ts

@@ -0,0 +1,13 @@
+import { type RegistryAppInfo } from "../../api";
+/**
+ * Fetch the merged apps catalog used by AppsView. Internal-tool entries are
+ * authoritative — server / overlay duplicates are dropped via first-occurrence
+ * dedup on `name`.
+ */
+export declare function loadAppsCatalog(): Promise<RegistryAppInfo[]>;
+/**
+ * Fire-and-forget prefetch used at hydration so the Apps tab opens warm.
+ * Errors are swallowed — the UI's own loadApps will retry on mount.
+ */
+export declare function prefetchAppsCatalog(): Promise<void>;
+//# sourceMappingURL=load-apps-catalog.d.ts.map

package/components/apps/load-apps-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-apps-catalog.d.ts","sourceRoot":"","sources":["../../../../../../src/components/apps/load-apps-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAoBzD;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CA2ClE;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CASzD"}

package/components/apps/load-apps-catalog.js

@@ -0,0 +1,67 @@
+import { client } from "../../api/index.js";
+import { writeAppsCache } from "./apps-cache.js";
+import { getInternalToolApps } from "./internal-tool-apps.js";
+import { getAllOverlayApps, overlayAppToRegistryInfo, } from "./overlay-app-registry.js";
+function isTransientOptionalFetchFailure(err) {
+    if (!(err instanceof Error))
+        return false;
+    const maybeApiError = err;
+    return (err.name === "ApiError" &&
+        maybeApiError.kind === "network" &&
+        /^(Failed to fetch|Request aborted)$/i.test(err.message));
+}
+/**
+ * Fetch the merged apps catalog used by AppsView. Internal-tool entries are
+ * authoritative — server / overlay duplicates are dropped via first-occurrence
+ * dedup on `name`.
+ */
+export async function loadAppsCatalog() {
+    const serverAppsResult = await client
+        .listApps()
+        .then((apps) => ({ status: "fulfilled", value: apps }))
+        .catch((reason) => ({ status: "rejected", reason }));
+    const serverApps = serverAppsResult.status === "fulfilled" ? serverAppsResult.value : [];
+    if (serverAppsResult.status === "rejected" &&
+        !isTransientOptionalFetchFailure(serverAppsResult.reason)) {
+        console.warn("[apps-catalog] listApps failed:", serverAppsResult.reason);
+    }
+    let catalogApps;
+    try {
+        catalogApps = [
+            ...getInternalToolApps(),
+            ...(await client.listCatalogApps()),
+        ];
+    }
+    catch (catalogErr) {
+        if (!isTransientOptionalFetchFailure(catalogErr)) {
+            console.warn("[apps-catalog] listCatalogApps failed; using internal tools:", catalogErr);
+        }
+        catalogApps = getInternalToolApps();
+    }
+    const overlayDescriptors = getAllOverlayApps()
+        .filter((oa) => !serverApps.some((a) => a.name === oa.name))
+        .filter((oa) => !catalogApps.some((a) => a.name === oa.name))
+        .map(overlayAppToRegistryInfo);
+    const seen = new Set();
+    return [...catalogApps, ...overlayDescriptors, ...serverApps].filter((app) => {
+        if (seen.has(app.name))
+            return false;
+        seen.add(app.name);
+        return true;
+    });
+}
+/**
+ * Fire-and-forget prefetch used at hydration so the Apps tab opens warm.
+ * Errors are swallowed — the UI's own loadApps will retry on mount.
+ */
+export async function prefetchAppsCatalog() {
+    try {
+        const apps = await loadAppsCatalog();
+        writeAppsCache(apps);
+    }
+    catch (err) {
+        if (!isTransientOptionalFetchFailure(err)) {
+            console.warn("[apps-catalog] prefetch failed:", err);
+        }
+    }
+}

package/components/apps/overlay-app-api.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Overlay App API — contract for full-screen overlay applications.
+ *
+ * Any app that renders as a full-screen overlay (like the VRM companion)
+ * implements this interface. The host shell renders the active overlay's
+ * Component and manages lifecycle hooks.
+ */
+import type { ReactElement } from "react";
+/** Context passed to every full-screen overlay app by the host shell. */
+export interface OverlayAppContext {
+    /** Navigate back to the apps tab and close this overlay. */
+    exitToApps: () => void;
+    /** Current UI theme. */
+    uiTheme: "light" | "dark";
+    /** i18n translation function. */
+    t: (key: string, opts?: Record<string, unknown>) => string;
+}
+/**
+ * Full-screen overlay app definition.
+ *
+ * Implement this to create an app that renders as a full-screen overlay
+ * on top of the main shell. The component owns its own resources and
+ * lifecycle — load assets on mount, dispose on unmount.
+ */
+export interface OverlayApp {
+    /** Unique app identifier (npm-style, e.g. "@elizaos/app-companion"). */
+    readonly name: string;
+    /** Display name shown in the apps catalog. */
+    readonly displayName: string;
+    /** Short description for the catalog card. */
+    readonly description: string;
+    /** Category for catalog filtering. */
+    readonly category: string;
+    /** Optional icon URL. */
+    readonly icon: string | null;
+    /** Optional hero image shown in app cards and chat widgets. */
+    readonly heroImage?: string | null;
+    /**
+     * When true, the app should only appear in the catalog on MiladyOS Android.
+     * Apps that wrap Android-only Capacitor native plugins (WiFi, Contacts,
+     * Phone) set this so they are hidden on stock Android, iOS, desktop, and
+     * web. Stock Android APKs do not expose these privileged OS-control surfaces.
+     *
+     * The platform check is performed by `getAvailableOverlayApps()` in
+     * `overlay-app-registry.ts`; the registry itself accepts any platform's
+     * registrations so server-side rendering and tests don't have to mock
+     * Capacitor.
+     */
+    readonly androidOnly?: boolean;
+    /**
+     * React component rendered as the full-screen overlay.
+     * Receives context with exit callback, theme, and i18n.
+     * Must handle its own resource lifecycle (load on mount, dispose on unmount).
+     */
+    readonly Component: (props: OverlayAppContext) => ReactElement;
+    /**
+     * Called immediately before the component mounts.
+     * Use for resource prefetching (e.g. VRM assets).
+     */
+    onLaunch?(): void | Promise<void>;
+    /**
+     * Called after the component unmounts.
+     * Use for final resource cleanup beyond what component unmount handles.
+     */
+    onStop?(): void | Promise<void>;
+}
+//# sourceMappingURL=overlay-app-api.d.ts.map

package/components/apps/overlay-app-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-app-api.d.ts","sourceRoot":"","sources":["../../../../../../src/components/apps/overlay-app-api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,wBAAwB;IACxB,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,iCAAiC;IACjC,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;CAC5D;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,YAAY,CAAC;IAC/D;;;OAGG;IACH,QAAQ,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC;;;OAGG;IACH,MAAM,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC"}

package/components/apps/overlay-app-api.js

@@ -0,0 +1,8 @@
+/**
+ * Overlay App API — contract for full-screen overlay applications.
+ *
+ * Any app that renders as a full-screen overlay (like the VRM companion)
+ * implements this interface. The host shell renders the active overlay's
+ * Component and manages lifecycle hooks.
+ */
+export {};

package/components/apps/overlay-app-registry.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Overlay App Registry — simple registry for full-screen overlay apps.
+ *
+ * Apps register here at module scope. The host shell and apps catalog
+ * query the registry to discover and launch overlay apps.
+ */
+import type { RegistryAppInfo } from "../../api";
+import type { OverlayApp } from "./overlay-app-api";
+/** Register an overlay app. Call at module scope. */
+export declare function registerOverlayApp(app: OverlayApp): void;
+/** Look up a registered overlay app by name. */
+export declare function getOverlayApp(name: string): OverlayApp | undefined;
+/** Get all registered overlay apps. */
+export declare function getAllOverlayApps(): OverlayApp[];
+/**
+ * Get overlay apps that are available on the current platform. Filters
+ * out `androidOnly: true` apps unless this is an AOSP Eliza-derived Android
+ * build (ElizaOS, MiladyOS, or any other white-label fork). Used by the apps
+ * catalog UI so stock Android, iOS, desktop, and web users don't see
+ * privileged OS-control tiles that launch into permanent error states.
+ *
+ * AOSP detection: the framework's `MainActivity.applyElizaOSUserAgentSuffix`
+ * appends an `ElizaOS/<tag>` token to the WebView UA when `ro.elizaos.product`
+ * is set by the product makefile. Every Eliza-derived AOSP image carries this
+ * marker; white-label brands (MiladyOS, …) layer additional brand-specific
+ * markers on top via `app.config.ts > android.userAgentMarkers`. Stock Android
+ * APKs leave the UA untouched.
+ *
+ * Platform detection: when `Capacitor.getPlatform()` is available it is
+ * preferred; otherwise the user-agent is inspected. Tests can pass an
+ * explicit context.
+ */
+export interface OverlayAppAvailabilityContext {
+    platform?: string;
+    /**
+     * True when this is an AOSP Eliza-derived Android build (any fork). When
+     * unspecified, derived from `userAgent` by checking for the framework
+     * `ElizaOS/` marker.
+     */
+    aospAndroid?: boolean;
+    userAgent?: string;
+}
+export declare function getAvailableOverlayApps(context?: string | OverlayAppAvailabilityContext): OverlayApp[];
+/**
+ * True when running on an AOSP Eliza-derived Android build (ElizaOS, MiladyOS,
+ * any white-label fork). Tests may pass an explicit context. Shared with
+ * `catalog-loader.ts` so it can apply the same gate to installed/static apps,
+ * not just overlay apps that happen to be registered already.
+ */
+export declare function isAospAndroid(context?: OverlayAppAvailabilityContext): boolean;
+/** Check if an app name belongs to a registered overlay app. */
+export declare function isOverlayApp(name: string): boolean;
+/** Convert an OverlayApp to a RegistryAppInfo for the apps catalog. */
+export declare function overlayAppToRegistryInfo(app: OverlayApp): RegistryAppInfo;
+//# sourceMappingURL=overlay-app-registry.d.ts.map

package/components/apps/overlay-app-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-app-registry.d.ts","sourceRoot":"","sources":["../../../../../../src/components/apps/overlay-app-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAsBpD,qDAAqD;AACrD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAExD;AAED,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAElE;AAED,uCAAuC;AACvC,wBAAgB,iBAAiB,IAAI,UAAU,EAAE,CAEhD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,GACH,MAAM,GACN,6BAAkE,GACrE,UAAU,EAAE,CAUd;AA6CD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAKT;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,uEAAuE;AACvE,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,UAAU,GAAG,eAAe,CAsBzE"}

package/components/apps/overlay-app-registry.js

@@ -0,0 +1,108 @@
+/**
+ * Overlay App Registry — simple registry for full-screen overlay apps.
+ *
+ * Apps register here at module scope. The host shell and apps catalog
+ * query the registry to discover and launch overlay apps.
+ */
+const OVERLAY_APP_REGISTRY_KEY = "__elizaosOverlayAppRegistry__";
+const overlayRegistryGlobal = globalThis;
+function getOverlayRegistry() {
+    const existing = overlayRegistryGlobal[OVERLAY_APP_REGISTRY_KEY];
+    if (existing) {
+        return existing;
+    }
+    const next = new Map();
+    overlayRegistryGlobal[OVERLAY_APP_REGISTRY_KEY] = next;
+    return next;
+}
+const registry = getOverlayRegistry();
+/** Register an overlay app. Call at module scope. */
+export function registerOverlayApp(app) {
+    registry.set(app.name, app);
+}
+/** Look up a registered overlay app by name. */
+export function getOverlayApp(name) {
+    return registry.get(name);
+}
+/** Get all registered overlay apps. */
+export function getAllOverlayApps() {
+    return Array.from(registry.values());
+}
+export function getAvailableOverlayApps(context = detectOverlayAvailabilityContext()) {
+    const availability = typeof context === "string"
+        ? { platform: context, aospAndroid: false }
+        : normalizeOverlayAvailabilityContext(context);
+    const canShowAndroidOnly = availability.platform === "android" && availability.aospAndroid === true;
+    return getAllOverlayApps().filter((app) => canShowAndroidOnly || app.androidOnly !== true);
+}
+function normalizeOverlayAvailabilityContext(context) {
+    const userAgent = context.userAgent ??
+        (typeof navigator !== "undefined" ? navigator.userAgent : "");
+    const platform = context.platform ?? detectPlatformForCatalog(userAgent);
+    return {
+        platform,
+        aospAndroid: context.aospAndroid ??
+            (platform === "android" && hasElizaOSAospMarker(userAgent)),
+        userAgent,
+    };
+}
+function detectOverlayAvailabilityContext() {
+    const userAgent = typeof navigator !== "undefined" ? navigator.userAgent : "";
+    const platform = detectPlatformForCatalog(userAgent);
+    return {
+        platform,
+        aospAndroid: platform === "android" && hasElizaOSAospMarker(userAgent),
+        userAgent,
+    };
+}
+function detectPlatformForCatalog(userAgent) {
+    const cap = globalThis.Capacitor;
+    const fromCap = cap?.getPlatform?.();
+    if (fromCap)
+        return fromCap;
+    if (/Android/i.test(userAgent)) {
+        return "android";
+    }
+    return "web";
+}
+function hasElizaOSAospMarker(userAgent) {
+    return /\bElizaOS\//.test(userAgent);
+}
+/**
+ * True when running on an AOSP Eliza-derived Android build (ElizaOS, MiladyOS,
+ * any white-label fork). Tests may pass an explicit context. Shared with
+ * `catalog-loader.ts` so it can apply the same gate to installed/static apps,
+ * not just overlay apps that happen to be registered already.
+ */
+export function isAospAndroid(context = {}) {
+    const availability = normalizeOverlayAvailabilityContext(context);
+    return (availability.platform === "android" && availability.aospAndroid === true);
+}
+/** Check if an app name belongs to a registered overlay app. */
+export function isOverlayApp(name) {
+    return registry.has(name);
+}
+/** Convert an OverlayApp to a RegistryAppInfo for the apps catalog. */
+export function overlayAppToRegistryInfo(app) {
+    return {
+        name: app.name,
+        displayName: app.displayName,
+        description: app.description,
+        category: app.category,
+        launchType: "overlay",
+        launchUrl: null,
+        icon: app.icon,
+        heroImage: app.heroImage ?? null,
+        capabilities: [],
+        stars: 0,
+        repository: "",
+        latestVersion: null,
+        supports: { v0: false, v1: false, v2: true },
+        npm: {
+            package: app.name,
+            v0Version: null,
+            v1Version: null,
+            v2Version: null,
+        },
+    };
+}

package/components/apps/per-app-config.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Per-app config — launch mode, always-on-top default, and free-form
+ * app-declared settings. NOT widget visibility (lives in widgets/visibility.ts).
+ *
+ * Persisted to localStorage under `eliza:apps:<slug>`. Subscribers receive
+ * change notifications via the `storage` event so multiple windows stay in
+ * sync.
+ */
+export type AppLaunchMode = "window" | "inline";
+export interface PerAppConfig {
+    launchMode: AppLaunchMode;
+    alwaysOnTop: boolean;
+    settings: Record<string, unknown>;
+}
+export declare function loadPerAppConfig(slug: string): PerAppConfig;
+export declare function savePerAppConfig(slug: string, config: PerAppConfig): void;
+export declare function subscribePerAppConfig(slug: string, listener: (config: PerAppConfig) => void): () => void;
+export declare function getDefaultPerAppConfig(): PerAppConfig;
+//# sourceMappingURL=per-app-config.d.ts.map

package/components/apps/per-app-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"per-app-config.d.ts","sourceRoot":"","sources":["../../../../../../src/components/apps/per-app-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,aAAa,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAqDD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAO3D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAczE;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GACvC,MAAM,IAAI,CAWZ;AAED,wBAAgB,sBAAsB,IAAI,YAAY,CAErD"}