@elizaos/ui 2.0.0-alpha.20 → 2.0.0-alpha.201

package/packages/app-core/src/components/apps/internal-tool-apps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-tool-apps.d.ts","sourceRoot":"","sources":["../../../../../../../app-core/src/components/apps/internal-tool-apps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAwG5C,wBAAgB,mBAAmB,IAAI,eAAe,EAAE,CAsBvD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAEpE;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/packages/app-core/src/components/apps/internal-tool-apps.js

@@ -0,0 +1,116 @@
+const INTERNAL_TOOL_APPS = [
+    {
+        name: "@elizaos/app-lifeops",
+        displayName: "LifeOps",
+        description: "Run tasks, reminders, calendar, inbox, and connected operational workflows.",
+        heroImage: "/app-heroes/lifeops.png",
+        targetTab: "lifeops",
+        capabilities: ["lifeops", "tasks", "calendar", "gmail"],
+        order: 0,
+    },
+    {
+        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,
+    },
+    {
+        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,
+    },
+    {
+        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: 3,
+    },
+    {
+        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: 4,
+    },
+    {
+        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: 5,
+    },
+    {
+        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: 6,
+    },
+    {
+        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: 7,
+    },
+    {
+        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: 8,
+    },
+];
+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,
+        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;
+}

package/packages/app-core/src/components/apps/overlay-app-api.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 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;
+    /**
+     * 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/packages/app-core/src/components/apps/overlay-app-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-app-api.d.ts","sourceRoot":"","sources":["../../../../../../../app-core/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;;;;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/packages/app-core/src/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/packages/app-core/src/components/apps/overlay-app-registry.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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[];
+/** 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/packages/app-core/src/components/apps/overlay-app-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-app-registry.d.ts","sourceRoot":"","sources":["../../../../../../../app-core/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;AAIpD,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,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,uEAAuE;AACvE,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,UAAU,GAAG,eAAe,CAsBzE"}

package/packages/app-core/src/components/apps/overlay-app-registry.js

@@ -0,0 +1,47 @@
+/**
+ * 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 registry = new Map();
+/** 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());
+}
+/** 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: "local",
+        launchUrl: null,
+        icon: app.icon,
+        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/packages/app-core/src/components/apps/run-attention.d.ts

@@ -0,0 +1,3 @@
+import type { AppRunSummary } from "../../api";
+export declare function getRunAttentionReasons(run: AppRunSummary, now?: number): string[];
+//# sourceMappingURL=run-attention.d.ts.map

package/packages/app-core/src/components/apps/run-attention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-attention.d.ts","sourceRoot":"","sources":["../../../../../../../app-core/src/components/apps/run-attention.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AA2C/C,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,aAAa,EAClB,GAAG,GAAE,MAAmB,GACvB,MAAM,EAAE,CAgDV"}

package/packages/app-core/src/components/apps/run-attention.js

@@ -0,0 +1,77 @@
+const HEARTBEAT_STALE_MS = 2 * 60 * 1000;
+const DOWN_STATUS_PATTERNS = [
+    "disconnected",
+    "failed",
+    "error",
+    "stale",
+    "stopping",
+    "stopped",
+    "paused",
+    "blocked",
+    "offline",
+    "lost",
+    "missing",
+    "unavailable",
+];
+const SESSION_READY_STATUSES = new Set([
+    "running",
+    "active",
+    "connected",
+    "ready",
+    "playing",
+    "live",
+    "monitoring",
+    "steering",
+    "attached",
+    "idle",
+]);
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function isDownSessionStatus(status) {
+    const normalized = status.trim().toLowerCase();
+    return DOWN_STATUS_PATTERNS.some((pattern) => normalized.includes(pattern));
+}
+function isReadySessionStatus(status) {
+    return SESSION_READY_STATUSES.has(status.trim().toLowerCase());
+}
+export function getRunAttentionReasons(run, now = Date.now()) {
+    const reasons = [];
+    const heartbeatAt = run.lastHeartbeatAt
+        ? new Date(run.lastHeartbeatAt).getTime()
+        : null;
+    if (run.health.state === "offline") {
+        reasons.push("Run is offline");
+    }
+    else if (run.health.state === "degraded") {
+        reasons.push(run.health.message ?? "Run health is degraded");
+    }
+    if (run.viewerAttachment === "detached") {
+        reasons.push("Viewer is detached");
+    }
+    else if (run.viewerAttachment === "unavailable") {
+        reasons.push("No viewer surface is available");
+    }
+    if (!run.viewer?.url && run.viewerAttachment !== "unavailable") {
+        reasons.push("Viewer URL is missing");
+    }
+    if (run.session?.canSendCommands === false) {
+        reasons.push("Command bridge is unavailable");
+    }
+    if (isNonEmptyString(run.session?.status) &&
+        isDownSessionStatus(run.session.status) &&
+        !isReadySessionStatus(run.session.status)) {
+        reasons.push(`Session status is ${run.session.status}`);
+    }
+    if (heartbeatAt === null) {
+        reasons.push("No heartbeat recorded");
+    }
+    else if (Number.isFinite(heartbeatAt) &&
+        now - heartbeatAt > HEARTBEAT_STALE_MS) {
+        reasons.push("Heartbeat is stale");
+    }
+    if (!run.supportsBackground && run.viewerAttachment !== "attached") {
+        reasons.push("Run may pause when the viewer is detached");
+    }
+    return Array.from(new Set(reasons));
+}

package/packages/app-core/src/components/apps/surfaces/registry.d.ts

@@ -0,0 +1,11 @@
+import type { AppOperatorSurfaceComponent } from "./types";
+/**
+ * Register an operator surface component for a given app package name.
+ * Call this once per app at module load time (e.g. from the app's UI entry).
+ *
+ * @example
+ *   registerOperatorSurface("@elizaos/app-babylon", BabylonOperatorSurface);
+ */
+export declare function registerOperatorSurface(appName: string, component: AppOperatorSurfaceComponent): void;
+export declare function getAppOperatorSurface(appName: string | null | undefined): AppOperatorSurfaceComponent | null;
+//# sourceMappingURL=registry.d.ts.map

package/packages/app-core/src/components/apps/surfaces/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../../../../../app-core/src/components/apps/surfaces/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAc3D;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,2BAA2B,GACrC,IAAI,CAEN;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACjC,2BAA2B,GAAG,IAAI,CAGpC"}

package/packages/app-core/src/components/apps/surfaces/registry.js

@@ -0,0 +1,23 @@
+/**
+ * Registry of operator surface components keyed by app package name.
+ *
+ * Apps register their surface on startup via side-effect import. The host
+ * app entry imports each game/app UI package which calls
+ * `registerOperatorSurface` during module initialization.
+ */
+const OPERATOR_SURFACE_COMPONENTS = new Map();
+/**
+ * Register an operator surface component for a given app package name.
+ * Call this once per app at module load time (e.g. from the app's UI entry).
+ *
+ * @example
+ *   registerOperatorSurface("@elizaos/app-babylon", BabylonOperatorSurface);
+ */
+export function registerOperatorSurface(appName, component) {
+    OPERATOR_SURFACE_COMPONENTS.set(appName, component);
+}
+export function getAppOperatorSurface(appName) {
+    if (!appName)
+        return null;
+    return OPERATOR_SURFACE_COMPONENTS.get(appName) ?? null;
+}

package/packages/app-core/src/components/apps/surfaces/types.d.ts

@@ -0,0 +1,10 @@
+import type { ComponentType } from "react";
+export type AppOperatorSurfaceVariant = "detail" | "live" | "running";
+export type AppOperatorSurfaceFocus = "all" | "dashboard" | "chat";
+export interface AppOperatorSurfaceProps {
+    appName: string;
+    variant?: AppOperatorSurfaceVariant;
+    focus?: AppOperatorSurfaceFocus;
+}
+export type AppOperatorSurfaceComponent = ComponentType<AppOperatorSurfaceProps>;
+//# sourceMappingURL=types.d.ts.map

package/packages/app-core/src/components/apps/surfaces/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../app-core/src/components/apps/surfaces/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,MAAM,MAAM,yBAAyB,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AACtE,MAAM,MAAM,uBAAuB,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC;AAEnE,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,yBAAyB,CAAC;IACpC,KAAK,CAAC,EAAE,uBAAuB,CAAC;CACjC;AAED,MAAM,MAAM,2BAA2B,GACrC,aAAa,CAAC,uBAAuB,CAAC,CAAC"}

package/packages/app-core/src/components/apps/surfaces/types.js

@@ -0,0 +1 @@
+export {};

package/packages/app-core/src/components/apps/viewer-auth.d.ts

@@ -0,0 +1,7 @@
+import type { AppRunSummary, AppViewerAuthMessage } from "../../api/client-types-cloud";
+export declare function resolveEmbeddedViewerUrl(viewerUrl: string): string;
+export declare function resolvePostMessageTargetOrigin(viewerUrl: string): string;
+export declare function resolveViewerReadyEventType(payload: AppViewerAuthMessage | null | undefined): string | null;
+export declare function buildViewerSessionKey(viewerUrl: string, payload: AppViewerAuthMessage | null | undefined): string;
+export declare function shouldUseEmbeddedAppViewer(run: AppRunSummary | null | undefined): boolean;
+//# sourceMappingURL=viewer-auth.d.ts.map

package/packages/app-core/src/components/apps/viewer-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-auth.d.ts","sourceRoot":"","sources":["../../../../../../../app-core/src/components/apps/viewer-auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AAOtC,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CASlE;AAED,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAaxE;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAC/C,MAAM,GAAG,IAAI,CAUf;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAC/C,MAAM,CAER;AAED,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,GACpC,OAAO,CAeT"}

package/packages/app-core/src/components/apps/viewer-auth.js

@@ -0,0 +1,55 @@
+import { resolveApiUrl } from "../../utils";
+function normalizeEmbedFlag(value) {
+    return value?.trim().toLowerCase() === "true";
+}
+export function resolveEmbeddedViewerUrl(viewerUrl) {
+    const normalized = viewerUrl.trim();
+    if (!normalized) {
+        return normalized;
+    }
+    if (normalized.startsWith("/api/")) {
+        return resolveApiUrl(normalized);
+    }
+    return normalized;
+}
+export function resolvePostMessageTargetOrigin(viewerUrl) {
+    const resolvedViewerUrl = resolveEmbeddedViewerUrl(viewerUrl);
+    try {
+        const parsed = resolvedViewerUrl.startsWith("/")
+            ? new URL(resolvedViewerUrl, window.location.origin)
+            : new URL(resolvedViewerUrl);
+        if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+            return "*";
+        }
+        return parsed.origin === "null" ? "*" : parsed.origin;
+    }
+    catch {
+        return "*";
+    }
+}
+export function resolveViewerReadyEventType(payload) {
+    if (!payload?.type) {
+        return null;
+    }
+    const normalizedType = payload.type.trim();
+    if (normalizedType.length === 0) {
+        return null;
+    }
+    return normalizedType.replace(/_AUTH$/i, "_READY");
+}
+export function buildViewerSessionKey(viewerUrl, payload) {
+    return `${resolveEmbeddedViewerUrl(viewerUrl)}::${JSON.stringify(payload ?? null)}`;
+}
+export function shouldUseEmbeddedAppViewer(run) {
+    const viewer = run?.viewer;
+    if (!viewer?.url) {
+        return false;
+    }
+    if (viewer.postMessageAuth) {
+        return true;
+    }
+    if (normalizeEmbedFlag(viewer.embedParams?.embedded)) {
+        return true;
+    }
+    return typeof viewer.embedParams?.surface === "string";
+}

package/packages/app-core/src/components/character/CharacterEditor.d.ts

@@ -0,0 +1,12 @@
+import { type ReactNode } from "react";
+export declare function CharacterEditor({ sceneOverlay, inModal: _inModal, onHeaderActionsChange, }?: {
+    sceneOverlay?: boolean;
+    inModal?: boolean;
+    onHeaderActionsChange?: (actions: ReactNode | null) => void;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Re-export as CharacterView so the upstream App.tsx import resolves here
+ * when the Vite alias redirects ./CharacterView to this file.
+ */
+export { CharacterEditor as CharacterView };
+//# sourceMappingURL=CharacterEditor.d.ts.map

package/packages/app-core/src/components/character/CharacterEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CharacterEditor.d.ts","sourceRoot":"","sources":["../../../../../../../app-core/src/components/character/CharacterEditor.tsx"],"names":[],"mappings":"AAkGA,OAAO,EAEL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AA4Df,wBAAgB,eAAe,CAAC,EAC9B,YAAoB,EACpB,OAAO,EAAE,QAAgB,EACzB,qBAAqB,GACtB,GAAE;IACD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAC;CACxD,2CAmmDL;AAED;;;GAGG;AACH,OAAO,EAAE,eAAe,IAAI,aAAa,EAAE,CAAC"}