@elizaos/agent 2.0.0-alpha.358 → 2.0.0-alpha.376

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: 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/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/GameOperatorShell.d.ts

@@ -0,0 +1,47 @@
+export type GameOperatorEventTone = "user" | "success" | "info" | "warning" | "error";
+export interface GameOperatorEvent {
+    id: string;
+    label: string;
+    message: string;
+    tone?: GameOperatorEventTone;
+    timestamp?: string | number | null;
+}
+export interface GameOperatorAction {
+    id: string;
+    label: string;
+    command: string;
+    testId?: string;
+    active?: boolean;
+    disabled?: boolean;
+}
+export interface GameOperatorDetail {
+    label: string;
+    value: string;
+}
+export interface GameOperatorShellProps {
+    surfaceTestId: string;
+    title: string;
+    statusLabel: string;
+    statusTone?: "live" | "attention" | "idle";
+    objective: string | null;
+    detailItems?: GameOperatorDetail[];
+    primaryActions: GameOperatorAction[];
+    suggestedActions?: GameOperatorAction[];
+    events: GameOperatorEvent[];
+    emptyEventsLabel: string;
+    draft: string;
+    inputPlaceholder: string;
+    sendLabel?: string;
+    sendingLabel?: string;
+    canSend: boolean;
+    sending: boolean;
+    chatInputTestId: string;
+    chatSendTestId: string;
+    noticeTestId?: string;
+    variant?: "detail" | "live" | "running";
+    onDraftChange: (value: string) => void;
+    onSendDraft: () => void;
+    onCommand: (command: string) => void;
+}
+export declare function GameOperatorShell({ surfaceTestId, title, statusLabel, statusTone, objective, detailItems, primaryActions, suggestedActions, events, emptyEventsLabel, draft, inputPlaceholder, sendLabel, sendingLabel, canSend, sending, chatInputTestId, chatSendTestId, noticeTestId, variant, onDraftChange, onSendDraft, onCommand, }: GameOperatorShellProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=GameOperatorShell.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GameOperatorShell.d.ts","sourceRoot":"","sources":["../../../../../../../../app-core/src/components/apps/surfaces/GameOperatorShell.tsx"],"names":[],"mappings":"AAGA,MAAM,MAAM,qBAAqB,GAC7B,MAAM,GACN,SAAS,GACT,MAAM,GACN,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC3C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACnC,cAAc,EAAE,kBAAkB,EAAE,CAAC;IACrC,gBAAgB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACxC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IACxC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAyBD,wBAAgB,iBAAiB,CAAC,EAChC,aAAa,EACb,KAAK,EACL,WAAW,EACX,UAAmB,EACnB,SAAS,EACT,WAAgB,EAChB,cAAc,EACd,gBAAqB,EACrB,MAAM,EACN,gBAAgB,EAChB,KAAK,EACL,gBAAgB,EAChB,SAAkB,EAClB,YAAwB,EACxB,OAAO,EACP,OAAO,EACP,eAAe,EACf,cAAc,EACd,YAAY,EACZ,OAAkB,EAClB,aAAa,EACb,WAAW,EACX,SAAS,GACV,EAAE,sBAAsB,2CAkJxB"}

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

@@ -0,0 +1,42 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button, Input } from "@elizaos/ui";
+function toneClass(tone = "info") {
+    if (tone === "user")
+        return "border-accent/35 bg-accent/10 text-txt";
+    if (tone === "success")
+        return "border-ok/30 bg-ok/10 text-txt";
+    if (tone === "warning")
+        return "border-warn/35 bg-warn/10 text-txt";
+    if (tone === "error")
+        return "border-danger/35 bg-danger/10 text-txt";
+    return "border-border/35 bg-bg/80 text-txt";
+}
+function statusClass(tone) {
+    if (tone === "live")
+        return "border-ok/30 bg-ok/10 text-ok";
+    if (tone === "attention")
+        return "border-warn/35 bg-warn/10 text-warn";
+    return "border-border/45 bg-bg-hover/70 text-muted-strong";
+}
+function formatTimestamp(value) {
+    if (value == null)
+        return null;
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime()))
+        return null;
+    return date.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" });
+}
+export function GameOperatorShell({ surfaceTestId, title, statusLabel, statusTone = "idle", objective, detailItems = [], primaryActions, suggestedActions = [], events, emptyEventsLabel, draft, inputPlaceholder, sendLabel = "Send", sendingLabel = "Sending", canSend, sending, chatInputTestId, chatSendTestId, noticeTestId, variant = "detail", onDraftChange, onSendDraft, onCommand, }) {
+    const latestEvent = events.at(-1) ?? null;
+    const visibleEvents = events.slice(-12);
+    const handleSubmit = (event) => {
+        event.preventDefault();
+        if (!draft.trim() || sending || !canSend)
+            return;
+        onSendDraft();
+    };
+    return (_jsxs("section", { className: `flex min-h-0 flex-col gap-3 ${variant === "live" ? "h-full p-3" : ""}`, "data-testid": surfaceTestId, children: [_jsxs("div", { className: "rounded-2xl border border-border/35 bg-card/74 p-3 shadow-sm", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [_jsx("span", { className: `inline-flex min-h-6 items-center rounded-full border px-2.5 py-1 text-2xs font-medium uppercase tracking-[0.14em] ${statusClass(statusTone)}`, children: statusLabel }), _jsx("span", { className: "text-xs font-semibold text-txt", children: title })] }), objective ? (_jsx("div", { className: "mt-2 text-xs leading-5 text-muted-strong", children: objective })) : null, detailItems.length > 0 ? (_jsx("div", { className: "mt-3 flex flex-wrap gap-2", children: detailItems.map((item) => (_jsxs("span", { className: "rounded-full border border-border/35 bg-bg/65 px-2.5 py-1 text-2xs text-muted-strong", children: [_jsxs("span", { className: "text-muted", children: [item.label, ": "] }), item.value] }, `${item.label}:${item.value}`))) })) : null] }), _jsx("div", { className: "grid grid-cols-2 gap-2", children: primaryActions.map((item) => (_jsx(Button, { type: "button", variant: item.active ? "default" : "outline", size: "sm", className: "min-h-9 rounded-xl shadow-sm", "data-testid": item.testId, disabled: !canSend || sending || item.disabled, onClick: () => onCommand(item.command), children: item.label }, item.id))) }), _jsxs("div", { className: "flex min-h-0 flex-1 flex-col rounded-2xl border border-border/35 bg-card/74 shadow-sm", children: [_jsxs("div", { className: "flex items-center justify-between gap-2 border-b border-border/30 px-3 py-2", children: [_jsx("div", { className: "text-2xs font-semibold uppercase tracking-[0.18em] text-muted", children: "Game chat" }), latestEvent && noticeTestId ? (_jsx("div", { className: "max-w-44 truncate text-2xs text-muted-strong", "data-testid": noticeTestId, title: latestEvent.message, children: latestEvent.message })) : null] }), _jsx("div", { className: "min-h-40 flex-1 space-y-2 overflow-y-auto p-3", children: visibleEvents.length === 0 ? (_jsx("div", { className: "rounded-xl border border-dashed border-border/45 bg-bg/45 px-3 py-4 text-xs leading-5 text-muted-strong", children: emptyEventsLabel })) : (visibleEvents.map((event) => {
+                            const time = formatTimestamp(event.timestamp);
+                            return (_jsxs("div", { className: `rounded-xl border px-3 py-2 text-xs leading-5 ${toneClass(event.tone)}`, children: [_jsxs("div", { className: "mb-1 flex items-center gap-2 text-2xs uppercase tracking-[0.14em] text-muted", children: [_jsx("span", { children: event.label }), time ? _jsx("span", { children: time }) : null] }), _jsx("div", { children: event.message })] }, event.id));
+                        })) }), _jsxs("form", { className: "border-t border-border/30 p-3", onSubmit: handleSubmit, children: [_jsxs("div", { className: "grid gap-2 md:grid-cols-[minmax(0,1fr)_auto]", children: [_jsx(Input, { value: draft, onChange: (event) => onDraftChange(event.target.value), placeholder: inputPlaceholder, className: "min-h-10 rounded-xl", "data-testid": chatInputTestId, disabled: !canSend }), _jsx(Button, { type: "submit", className: "min-h-10 rounded-xl px-4 shadow-sm", "data-testid": chatSendTestId, disabled: !canSend || sending || !draft.trim(), children: sending ? sendingLabel : sendLabel })] }), suggestedActions.length > 0 ? (_jsx("div", { className: "mt-3 flex flex-wrap gap-2", children: suggestedActions.map((item) => (_jsx(Button, { type: "button", variant: "outline", size: "sm", className: "min-h-8 rounded-xl px-3 shadow-sm", "data-testid": item.testId, disabled: !canSend || sending || item.disabled, onClick: () => onCommand(item.command), children: item.label }, item.id))) })) : null] })] })] }));
+}

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/auth/LoginView.d.ts

@@ -0,0 +1,55 @@
+/**
+ * LoginView — multi-method login for Milady.
+ *
+ * Four tabs, rendered in this order (password first: most common for local installs):
+ *   1. Password   — displayName + password + remember device + submit
+ *   2. Eliza Cloud SSO — single button (disabled with tooltip until P2 backend lands)
+ *   3. Connector  — sign in via Discord / Telegram DM link (disabled until P3)
+ *   4. Pairing code — legacy 4-4-4 pairing flow; kept through the 14-day grace window
+ *
+ * On a 200 from /api/auth/me the caller should redirect to "/".
+ *
+ * Uses @elizaos/ui primitives (Tabs, Card, Input, Label, Button) + onboarding
+ * styles for the dark visual shell.
+ */
+import { type AuthLoginResult } from "../../api/auth-client";
+export interface LoginViewProps {
+    /**
+     * Called after a successful login so the shell can redirect to the
+     * main dashboard.
+     */
+    onLoginSuccess: () => void;
+    /**
+     * Whether Eliza Cloud SSO is available. When false the SSO tab button is
+     * disabled with an explanatory tooltip.
+     */
+    cloudEnabled?: boolean;
+    /**
+     * Connector bindings available for DM-link login.
+     * Empty array → connector tab shows "no bindings" state.
+     */
+    connectorBindings?: ConnectorBinding[];
+    /** Optional legacy pairing props forwarded to the pairing tab. */
+    pairing?: PairingTabProps;
+    /** Injected login function (tests). */
+    loginFn?: (params: {
+        displayName: string;
+        password: string;
+        rememberDevice?: boolean;
+    }) => Promise<AuthLoginResult>;
+    reason?: "remote_auth_required" | "remote_password_not_configured";
+}
+export interface ConnectorBinding {
+    connector: "discord" | "telegram" | "wechat" | "matrix";
+    displayHandle: string;
+}
+export interface PairingTabProps {
+    pairingEnabled: boolean;
+    pairingCodeInput: string;
+    pairingBusy: boolean;
+    pairingError: string | null;
+    onCodeChange: (value: string) => void;
+    onSubmit: (code: string) => void;
+}
+export declare function LoginView({ onLoginSuccess, cloudEnabled, connectorBindings, pairing, loginFn, reason, }: LoginViewProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=LoginView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LoginView.d.ts","sourceRoot":"","sources":["../../../../../../../app-core/src/components/auth/LoginView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAqBH,OAAO,EAAE,KAAK,eAAe,EAAqB,MAAM,uBAAuB,CAAC;AAWhF,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACvC,kEAAkE;IAClE,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,uCAAuC;IACvC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,sBAAsB,GAAG,gCAAgC,CAAC;CACpE;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAsXD,wBAAgB,SAAS,CAAC,EACxB,cAAc,EACd,YAAoB,EACpB,iBAAsB,EACtB,OAAO,EACP,OAAO,EACP,MAAM,GACP,EAAE,cAAc,2CA6EhB"}

package/packages/app-core/src/components/auth/LoginView.js

@@ -0,0 +1,147 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * LoginView — multi-method login for Milady.
+ *
+ * Four tabs, rendered in this order (password first: most common for local installs):
+ *   1. Password   — displayName + password + remember device + submit
+ *   2. Eliza Cloud SSO — single button (disabled with tooltip until P2 backend lands)
+ *   3. Connector  — sign in via Discord / Telegram DM link (disabled until P3)
+ *   4. Pairing code — legacy 4-4-4 pairing flow; kept through the 14-day grace window
+ *
+ * On a 200 from /api/auth/me the caller should redirect to "/".
+ *
+ * Uses @elizaos/ui primitives (Tabs, Card, Input, Label, Button) + onboarding
+ * styles for the dark visual shell.
+ */
+import { Button, Card, CardContent, CardHeader, CardTitle, cn, Input, Label, Tabs, TabsContent, TabsList, TabsTrigger, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, } from "@elizaos/ui";
+import { useCallback, useId, useState } from "react";
+import { authLoginPassword } from "../../api/auth-client";
+import { OnboardingStepDivider, onboardingBodyTextShadowStyle, onboardingDescriptionClass, onboardingEyebrowClass, onboardingTitleClass, } from "../onboarding/onboarding-step-chrome";
+function PasswordTab({ onLoginSuccess, loginFn, }) {
+    const displayNameId = useId().replace(/:/g, "");
+    const passwordId = useId().replace(/:/g, "");
+    const [displayName, setDisplayName] = useState("");
+    const [password, setPassword] = useState("");
+    const [rememberDevice, setRememberDevice] = useState(false);
+    const [submitState, setSubmitState] = useState({
+        phase: "idle",
+    });
+    const handleSubmit = useCallback(async (e) => {
+        e.preventDefault();
+        if (!displayName.trim() || !password)
+            return;
+        setSubmitState({ phase: "submitting" });
+        let result;
+        try {
+            const fn = loginFn ?? authLoginPassword;
+            result = await fn({
+                displayName: displayName.trim(),
+                password,
+                rememberDevice,
+            });
+        }
+        catch (err) {
+            setSubmitState({
+                phase: "error",
+                message: err instanceof Error ? err.message : "Network error — try again.",
+            });
+            return;
+        }
+        if (result.ok === false) {
+            setSubmitState({ phase: "error", message: result.message });
+            return;
+        }
+        setSubmitState({ phase: "success" });
+        onLoginSuccess();
+    }, [displayName, password, rememberDevice, loginFn, onLoginSuccess]);
+    const isSubmitting = submitState.phase === "submitting";
+    return (_jsxs("form", { onSubmit: handleSubmit, className: "flex flex-col gap-5", noValidate: true, children: [_jsxs("div", { className: "flex flex-col gap-3", children: [_jsxs("div", { className: "flex flex-col gap-1.5", children: [_jsx(Label, { htmlFor: displayNameId, className: "text-xs uppercase tracking-wide text-muted-foreground", children: "Display name" }), _jsx(Input, { id: displayNameId, type: "text", autoComplete: "username", placeholder: "Your display name", value: displayName, onChange: (e) => {
+                                    setDisplayName(e.target.value);
+                                    if (submitState.phase === "error")
+                                        setSubmitState({ phase: "idle" });
+                                }, disabled: isSubmitting, "aria-required": "true" })] }), _jsxs("div", { className: "flex flex-col gap-1.5", children: [_jsx(Label, { htmlFor: passwordId, className: "text-xs uppercase tracking-wide text-muted-foreground", children: "Password" }), _jsx(Input, { id: passwordId, type: "password", autoComplete: "current-password", placeholder: "Your password", value: password, onChange: (e) => {
+                                    setPassword(e.target.value);
+                                    if (submitState.phase === "error")
+                                        setSubmitState({ phase: "idle" });
+                                }, disabled: isSubmitting, "aria-required": "true" })] }), _jsxs("label", { className: "flex cursor-pointer items-center gap-2 text-sm text-muted-foreground select-none", children: [_jsx("input", { type: "checkbox", checked: rememberDevice, onChange: (e) => setRememberDevice(e.target.checked), disabled: isSubmitting, className: "h-4 w-4 rounded border-border accent-primary" }), "Remember this device for 30 days"] })] }), submitState.phase === "error" && (_jsx("p", { role: "alert", className: "rounded-lg border border-[color:color-mix(in_srgb,var(--danger)_38%,transparent)] bg-[color:color-mix(in_srgb,var(--danger)_12%,transparent)] px-4 py-3 text-sm text-danger", children: submitState.message })), _jsx(Button, { type: "submit", disabled: isSubmitting || !displayName.trim() || !password, className: "w-full", children: isSubmitting ? "Signing in…" : "Sign in" })] }));
+}
+// ── SSO tab ───────────────────────────────────────────────────────────────────
+function SsoTab({ cloudEnabled }) {
+    const tooltipText = "Available when Eliza Cloud is configured on this instance.";
+    return (_jsxs("div", { className: "flex flex-col items-center gap-4 py-2", children: [_jsx("p", { className: "text-sm text-muted-foreground text-center leading-relaxed", children: "Sign in with your Eliza Cloud account. This method requires the instance to have an active Eliza Cloud connection." }), _jsx(TooltipProvider, { children: _jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("span", { className: "w-full", children: _jsx(Button, { asChild: cloudEnabled, disabled: !cloudEnabled, className: "w-full", variant: "outline", children: cloudEnabled ? (_jsx("a", { href: "/api/auth/login/sso/start?returnTo=/", children: "Sign in with Eliza Cloud" })) : (_jsx("span", { children: "Sign in with Eliza Cloud" })) }) }) }), !cloudEnabled && _jsx(TooltipContent, { children: tooltipText })] }) })] }));
+}
+// ── Connector tab ─────────────────────────────────────────────────────────────
+function ConnectorTab({ bindings }) {
+    const hasBindings = bindings.length > 0;
+    const unavailableTooltip = "Available when a connector owner is bound to this instance.";
+    if (!hasBindings) {
+        return (_jsxs("div", { className: "flex flex-col items-center gap-4 py-2", children: [_jsx("p", { className: "text-sm text-muted-foreground text-center leading-relaxed", children: "Log in via a Discord or Telegram message. This method requires a connector owner binding to be configured first." }), _jsx(TooltipProvider, { children: _jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("span", { className: "w-full", children: _jsx(Button, { disabled: true, className: "w-full", variant: "outline", children: "Send login link" }) }) }), _jsx(TooltipContent, { children: unavailableTooltip })] }) }), _jsx("p", { className: "text-xs text-muted-foreground/60 text-center", children: "No connector bindings configured. Set up a connector in Settings to enable this method." })] }));
+    }
+    return (_jsxs("div", { className: "flex flex-col gap-4 py-2", children: [_jsx("p", { className: "text-sm text-muted-foreground leading-relaxed", children: "Choose a connector \u2014 we\u2019ll send you a one-time login link." }), _jsx("div", { className: "flex flex-col gap-2", children: bindings.map((b) => (_jsx(ConnectorLoginButton, { binding: b }, `${b.connector}:${b.displayHandle}`))) })] }));
+}
+function ConnectorLoginButton({ binding }) {
+    const [state, setState] = useState({ phase: "idle" });
+    const handleClick = useCallback(async () => {
+        setState({ phase: "sending" });
+        try {
+            // P3 backend route — may not exist yet. Surface 404 gracefully.
+            const res = await fetch("/api/auth/login/owner/dm-link/request", {
+                method: "POST",
+                credentials: "include",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    connector: binding.connector,
+                    externalId: binding.displayHandle,
+                }),
+            });
+            if (res.status === 404) {
+                setState({
+                    phase: "error",
+                    message: "DM-link login is not yet available (backend pending).",
+                });
+                return;
+            }
+            if (!res.ok) {
+                setState({
+                    phase: "error",
+                    message: `Request failed (${res.status}). Try again.`,
+                });
+                return;
+            }
+            setState({ phase: "sent", connector: binding.connector });
+        }
+        catch (err) {
+            setState({
+                phase: "error",
+                message: err instanceof Error ? err.message : "Network error.",
+            });
+        }
+    }, [binding]);
+    const label = `${binding.connector[0].toUpperCase()}${binding.connector.slice(1)} — ${binding.displayHandle}`;
+    if (state.phase === "sent") {
+        return (_jsxs("p", { className: "rounded-lg border border-[var(--ok-muted)] bg-[var(--ok-subtle)] px-4 py-3 text-sm text-ok", children: ["Login link sent via ", state.connector, ". Click it to sign in."] }));
+    }
+    return (_jsxs("div", { className: "flex flex-col gap-1.5", children: [_jsx(Button, { variant: "outline", disabled: state.phase === "sending", onClick: handleClick, className: "w-full justify-start", children: state.phase === "sending" ? "Sending…" : `Send link via ${label}` }), state.phase === "error" && (_jsx("p", { className: "text-xs text-danger", children: state.message }))] }));
+}
+// ── Pairing tab ───────────────────────────────────────────────────────────────
+function PairingTab({ pairing }) {
+    const pairingCodeId = useId().replace(/:/g, "");
+    if (!pairing) {
+        return (_jsx("p", { className: "py-2 text-sm text-muted-foreground", children: "Pairing is not available in the current server configuration." }));
+    }
+    const code = pairing.pairingCodeInput.trim();
+    return (_jsxs("form", { onSubmit: (e) => {
+            e.preventDefault();
+            if (code)
+                pairing.onSubmit(code);
+        }, className: "flex flex-col gap-4", children: [_jsx("p", { className: "text-sm text-muted-foreground leading-relaxed", children: "Enter the pairing code shown in your CLI or desktop app. This method will be removed after the 14-day migration grace window." }), _jsxs("div", { className: "flex flex-col gap-1.5", children: [_jsx(Label, { htmlFor: pairingCodeId, className: "text-xs uppercase tracking-wide text-muted-foreground", children: "Pairing code" }), _jsx(Input, { id: pairingCodeId, type: "text", placeholder: "xxxx-xxxx-xxxx", value: pairing.pairingCodeInput, onChange: (e) => pairing.onCodeChange(e.target.value), disabled: pairing.pairingBusy || !pairing.pairingEnabled, autoComplete: "off", spellCheck: false })] }), pairing.pairingError && (_jsx("p", { role: "alert", className: "text-sm text-danger", children: pairing.pairingError })), _jsx(Button, { type: "submit", disabled: pairing.pairingBusy || !pairing.pairingEnabled || !code, className: "w-full", children: pairing.pairingBusy ? "Pairing…" : "Submit code" })] }));
+}
+// ── Root component ────────────────────────────────────────────────────────────
+const SCREEN_SHELL_CLASS = "relative flex min-h-screen w-full items-center justify-center overflow-hidden bg-bg px-4 py-6 font-body text-txt sm:px-6";
+const SCREEN_CARD_CLASS = "relative z-10 w-full max-w-[520px] overflow-hidden border border-border/60 bg-card/95 shadow-[0_30px_120px_rgba(0,0,0,0.35)] backdrop-blur-xl";
+export function LoginView({ onLoginSuccess, cloudEnabled = false, connectorBindings = [], pairing, loginFn, reason, }) {
+    const remotePasswordMissing = reason === "remote_password_not_configured";
+    return (_jsxs("div", { className: SCREEN_SHELL_CLASS, children: [_jsxs("div", { className: "absolute inset-0 overflow-hidden pointer-events-none", children: [_jsx("div", { className: "absolute inset-0 bg-[radial-gradient(circle_at_top,rgba(255,255,255,0.08),transparent_40%),linear-gradient(180deg,rgba(11,14,20,0.24),rgba(6,7,8,0.62))]" }), _jsx("div", { className: "absolute left-[-8%] top-[10%] h-[20rem] w-[20rem] rounded-full bg-[rgba(240,185,11,0.09)] blur-[100px]" }), _jsx("div", { className: "absolute bottom-[-10%] right-[-6%] h-[18rem] w-[18rem] rounded-full bg-[rgba(255,255,255,0.06)] blur-[110px]" })] }), _jsxs(Card, { className: SCREEN_CARD_CLASS, children: [_jsx(CardHeader, { className: "pb-2 pt-6 px-6", children: _jsxs("div", { className: "mb-1", children: [_jsx("p", { className: onboardingEyebrowClass, style: onboardingBodyTextShadowStyle, children: "Milady" }), _jsx(OnboardingStepDivider, {}), _jsx(CardTitle, { className: cn(onboardingTitleClass, "mt-2"), style: { textShadow: "var(--onboarding-text-shadow-strong)" }, children: "Sign in" }), _jsx("p", { className: cn(onboardingDescriptionClass, "mt-2"), style: onboardingBodyTextShadowStyle, children: remotePasswordMissing
+                                        ? "Remote access is not enabled yet. Open this instance on the host machine via localhost and set a remote password in Settings."
+                                        : "Choose your login method below." })] }) }), _jsx(CardContent, { className: "px-6 pb-6", children: _jsxs(Tabs, { defaultValue: "password", children: [_jsxs(TabsList, { className: "mb-5 w-full grid grid-cols-4", children: [_jsx(TabsTrigger, { value: "password", children: "Password" }), _jsx(TabsTrigger, { value: "sso", children: "Cloud" }), _jsx(TabsTrigger, { value: "connector", children: "Connector" }), _jsx(TabsTrigger, { value: "pairing", children: "Pairing" })] }), _jsx(TabsContent, { value: "password", children: remotePasswordMissing ? (_jsx("p", { className: "rounded-lg border border-border/60 bg-bg/50 px-4 py-3 text-sm leading-6 text-muted-foreground", children: "Remote password login has not been configured. Open this instance on the host machine with localhost, then set a remote password in Settings." })) : (_jsx(PasswordTab, { onLoginSuccess: onLoginSuccess, loginFn: loginFn })) }), _jsx(TabsContent, { value: "sso", children: _jsx(SsoTab, { cloudEnabled: cloudEnabled }) }), _jsx(TabsContent, { value: "connector", children: _jsx(ConnectorTab, { bindings: connectorBindings }) }), _jsx(TabsContent, { value: "pairing", children: _jsx(PairingTab, { pairing: pairing }) })] }) })] })] }));
+}

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":"AAmFA,OAAO,EAEL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AA6Df,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,2CAyyCL;AAED;;;GAGG;AACH,OAAO,EAAE,eAAe,IAAI,aAAa,EAAE,CAAC"}