@elizaos/shared 2.0.0-alpha.538 → 2.0.3-beta.2

package/contracts/apps.d.ts

@@ -2,6 +2,7 @@
  * Shared app manager contracts.
  */
 import type { IAgentRuntime } from "@elizaos/core";
+import z from "zod";
 export type AppSessionMode = "viewer" | "spectate-and-steer" | "external";
 export type AppSessionFeature = "commands" | "telemetry" | "pause" | "resume" | "suggestions";
 export type AppSessionControlAction = "pause" | "resume";
@@ -84,22 +85,36 @@ export interface RegistryAppInfo {
     latestVersion: string | null;
     supports: RegistryAppSupports;
     npm: RegistryAppNpmInfo;
+    directory?: string | null;
+    registryKind?: string;
+    origin?: "builtin" | "third-party" | string;
+    source?: string;
+    support?: "first-party" | "community" | string;
+    builtIn?: boolean;
+    firstParty?: boolean;
+    thirdParty?: boolean;
+    status?: string;
     uiExtension?: AppUiExtensionConfig;
     viewer?: Omit<AppViewerConfig, "authMessage">;
     session?: AppSessionConfig;
     /**
      * If true, the app is a developer-tooling surface and is hidden from the
      * main UI unless Developer Mode is enabled in Settings.
-     * TODO: server-side population pending
      */
     developerOnly?: boolean;
     /**
      * Controls whether the app appears in the user-facing app store/catalog.
      * Defaults to true. Set to false for apps that auto-install or are surfaced
      * only via direct deep-links.
-     * TODO: server-side population pending
      */
     visibleInAppStore?: boolean;
+    /**
+     * If true, the app declares itself as the default landing tab. Exactly one
+     * installed app should set this. Sourced from `package.json` →
+     * `elizaos.app.mainTab`. Consumed by `getMainTabApp()` in `@elizaos/app-core`
+     * to compute the shell's landing tab at boot.
+     */
+    mainTab?: boolean;
 }
 export interface AppSessionState {
     sessionId: string;
@@ -242,9 +257,874 @@ export interface AppStopResult {
     stoppedAt: string;
     pluginUninstalled: boolean;
     needsRestart: boolean;
-    stopScope: "plugin-uninstalled" | "viewer-session" | "no-op";
+    stopScope: "plugin-uninstalled" | "viewer-session" | "nothing-stopped";
     message: string;
 }
+export declare const AppSessionJsonValueSchema: z.ZodType<AppSessionJsonValue>;
+export declare const AppViewerAuthMessageSchema: z.ZodObject<{
+    type: z.ZodString;
+    authToken: z.ZodOptional<z.ZodString>;
+    characterId: z.ZodOptional<z.ZodString>;
+    sessionToken: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodOptional<z.ZodString>;
+    followEntity: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const AppViewerConfigSchema: z.ZodObject<{
+    url: z.ZodString;
+    embedParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    postMessageAuth: z.ZodOptional<z.ZodBoolean>;
+    sandbox: z.ZodOptional<z.ZodString>;
+    authMessage: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+        authToken: z.ZodOptional<z.ZodString>;
+        characterId: z.ZodOptional<z.ZodString>;
+        sessionToken: z.ZodOptional<z.ZodString>;
+        agentId: z.ZodOptional<z.ZodString>;
+        followEntity: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const AppSessionRecommendationSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    priority: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+    command: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+}, z.core.$strip>;
+export declare const AppSessionActivityItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    message: z.ZodString;
+    timestamp: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+    severity: z.ZodOptional<z.ZodEnum<{
+        error: "error";
+        info: "info";
+        warning: "warning";
+    }>>;
+}, z.core.$strip>;
+export declare const AppSessionStateSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    appName: z.ZodString;
+    mode: z.ZodEnum<{
+        external: "external";
+        viewer: "viewer";
+        "spectate-and-steer": "spectate-and-steer";
+    }>;
+    status: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodOptional<z.ZodString>;
+    characterId: z.ZodOptional<z.ZodString>;
+    followEntity: z.ZodOptional<z.ZodString>;
+    canSendCommands: z.ZodOptional<z.ZodBoolean>;
+    controls: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        pause: "pause";
+        resume: "resume";
+    }>>>;
+    summary: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    goalLabel: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    suggestedPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    recommendations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        priority: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+        command: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    }, z.core.$strip>>>;
+    activity: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        message: z.ZodString;
+        timestamp: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+        severity: z.ZodOptional<z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warning: "warning";
+        }>>;
+    }, z.core.$strip>>>;
+    telemetry: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodType<AppSessionJsonValue, unknown, z.core.$ZodTypeInternals<AppSessionJsonValue, unknown>>>, z.ZodNull]>>;
+}, z.core.$strip>;
+export declare const AppRunHealthSchema: z.ZodObject<{
+    state: z.ZodUnion<readonly [z.ZodLiteral<"healthy">, z.ZodLiteral<"degraded">, z.ZodLiteral<"offline">]>;
+    message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+}, z.core.$strip>;
+export declare const AppRunHealthFacetSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        unknown: "unknown";
+        healthy: "healthy";
+        degraded: "degraded";
+        offline: "offline";
+    }>;
+    message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+}, z.core.$strip>;
+export declare const AppRunHealthDetailsSchema: z.ZodObject<{
+    checkedAt: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+    auth: z.ZodObject<{
+        state: z.ZodEnum<{
+            unknown: "unknown";
+            healthy: "healthy";
+            degraded: "degraded";
+            offline: "offline";
+        }>;
+        message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+    }, z.core.$strip>;
+    runtime: z.ZodObject<{
+        state: z.ZodEnum<{
+            unknown: "unknown";
+            healthy: "healthy";
+            degraded: "degraded";
+            offline: "offline";
+        }>;
+        message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+    }, z.core.$strip>;
+    viewer: z.ZodObject<{
+        state: z.ZodEnum<{
+            unknown: "unknown";
+            healthy: "healthy";
+            degraded: "degraded";
+            offline: "offline";
+        }>;
+        message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+    }, z.core.$strip>;
+    chat: z.ZodObject<{
+        state: z.ZodEnum<{
+            unknown: "unknown";
+            healthy: "healthy";
+            degraded: "degraded";
+            offline: "offline";
+        }>;
+        message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+    }, z.core.$strip>;
+    control: z.ZodObject<{
+        state: z.ZodEnum<{
+            unknown: "unknown";
+            healthy: "healthy";
+            degraded: "degraded";
+            offline: "offline";
+        }>;
+        message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+    }, z.core.$strip>;
+    message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+}, z.core.$strip>;
+export declare const AppRunEventSchema: z.ZodObject<{
+    eventId: z.ZodString;
+    kind: z.ZodEnum<{
+        status: "status";
+        summary: "summary";
+        launch: "launch";
+        refresh: "refresh";
+        attach: "attach";
+        detach: "detach";
+        stop: "stop";
+        health: "health";
+    }>;
+    severity: z.ZodEnum<{
+        error: "error";
+        info: "info";
+        warning: "warning";
+    }>;
+    message: z.ZodString;
+    createdAt: z.ZodString;
+    status: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    details: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodType<AppSessionJsonValue, unknown, z.core.$ZodTypeInternals<AppSessionJsonValue, unknown>>>, z.ZodNull]>>;
+}, z.core.$strip>;
+export declare const AppRunAwaySummarySchema: z.ZodObject<{
+    generatedAt: z.ZodString;
+    message: z.ZodString;
+    eventCount: z.ZodNumber;
+    since: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+    until: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+}, z.core.$strip>;
+export declare const AppRunSummarySchema: z.ZodObject<{
+    runId: z.ZodString;
+    appName: z.ZodString;
+    displayName: z.ZodString;
+    pluginName: z.ZodString;
+    launchType: z.ZodString;
+    launchUrl: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+    viewer: z.ZodUnion<readonly [z.ZodObject<{
+        url: z.ZodString;
+        embedParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        postMessageAuth: z.ZodOptional<z.ZodBoolean>;
+        sandbox: z.ZodOptional<z.ZodString>;
+        authMessage: z.ZodOptional<z.ZodObject<{
+            type: z.ZodString;
+            authToken: z.ZodOptional<z.ZodString>;
+            characterId: z.ZodOptional<z.ZodString>;
+            sessionToken: z.ZodOptional<z.ZodString>;
+            agentId: z.ZodOptional<z.ZodString>;
+            followEntity: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodNull]>;
+    session: z.ZodUnion<readonly [z.ZodObject<{
+        sessionId: z.ZodString;
+        appName: z.ZodString;
+        mode: z.ZodEnum<{
+            external: "external";
+            viewer: "viewer";
+            "spectate-and-steer": "spectate-and-steer";
+        }>;
+        status: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        agentId: z.ZodOptional<z.ZodString>;
+        characterId: z.ZodOptional<z.ZodString>;
+        followEntity: z.ZodOptional<z.ZodString>;
+        canSendCommands: z.ZodOptional<z.ZodBoolean>;
+        controls: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            pause: "pause";
+            resume: "resume";
+        }>>>;
+        summary: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        goalLabel: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        suggestedPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        recommendations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            reason: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+            priority: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+            command: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        }, z.core.$strip>>>;
+        activity: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodString;
+            message: z.ZodString;
+            timestamp: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+            severity: z.ZodOptional<z.ZodEnum<{
+                error: "error";
+                info: "info";
+                warning: "warning";
+            }>>;
+        }, z.core.$strip>>>;
+        telemetry: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodType<AppSessionJsonValue, unknown, z.core.$ZodTypeInternals<AppSessionJsonValue, unknown>>>, z.ZodNull]>>;
+    }, z.core.$strip>, z.ZodNull]>;
+    characterId: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+    agentId: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+    status: z.ZodString;
+    summary: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+    startedAt: z.ZodString;
+    updatedAt: z.ZodString;
+    lastHeartbeatAt: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+    supportsBackground: z.ZodBoolean;
+    supportsViewerDetach: z.ZodBoolean;
+    chatAvailability: z.ZodEnum<{
+        unknown: "unknown";
+        available: "available";
+        unavailable: "unavailable";
+    }>;
+    controlAvailability: z.ZodEnum<{
+        unknown: "unknown";
+        available: "available";
+        unavailable: "unavailable";
+    }>;
+    viewerAttachment: z.ZodEnum<{
+        unavailable: "unavailable";
+        attached: "attached";
+        detached: "detached";
+    }>;
+    recentEvents: z.ZodArray<z.ZodObject<{
+        eventId: z.ZodString;
+        kind: z.ZodEnum<{
+            status: "status";
+            summary: "summary";
+            launch: "launch";
+            refresh: "refresh";
+            attach: "attach";
+            detach: "detach";
+            stop: "stop";
+            health: "health";
+        }>;
+        severity: z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warning: "warning";
+        }>;
+        message: z.ZodString;
+        createdAt: z.ZodString;
+        status: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        details: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodType<AppSessionJsonValue, unknown, z.core.$ZodTypeInternals<AppSessionJsonValue, unknown>>>, z.ZodNull]>>;
+    }, z.core.$strip>>;
+    awaySummary: z.ZodUnion<readonly [z.ZodObject<{
+        generatedAt: z.ZodString;
+        message: z.ZodString;
+        eventCount: z.ZodNumber;
+        since: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+        until: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+    }, z.core.$strip>, z.ZodNull]>;
+    health: z.ZodObject<{
+        state: z.ZodUnion<readonly [z.ZodLiteral<"healthy">, z.ZodLiteral<"degraded">, z.ZodLiteral<"offline">]>;
+        message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+    }, z.core.$strip>;
+    healthDetails: z.ZodObject<{
+        checkedAt: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+        auth: z.ZodObject<{
+            state: z.ZodEnum<{
+                unknown: "unknown";
+                healthy: "healthy";
+                degraded: "degraded";
+                offline: "offline";
+            }>;
+            message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+        }, z.core.$strip>;
+        runtime: z.ZodObject<{
+            state: z.ZodEnum<{
+                unknown: "unknown";
+                healthy: "healthy";
+                degraded: "degraded";
+                offline: "offline";
+            }>;
+            message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+        }, z.core.$strip>;
+        viewer: z.ZodObject<{
+            state: z.ZodEnum<{
+                unknown: "unknown";
+                healthy: "healthy";
+                degraded: "degraded";
+                offline: "offline";
+            }>;
+            message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+        }, z.core.$strip>;
+        chat: z.ZodObject<{
+            state: z.ZodEnum<{
+                unknown: "unknown";
+                healthy: "healthy";
+                degraded: "degraded";
+                offline: "offline";
+            }>;
+            message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+        }, z.core.$strip>;
+        control: z.ZodObject<{
+            state: z.ZodEnum<{
+                unknown: "unknown";
+                healthy: "healthy";
+                degraded: "degraded";
+                offline: "offline";
+            }>;
+            message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+        }, z.core.$strip>;
+        message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const AppLaunchDiagnosticSchema: z.ZodObject<{
+    code: z.ZodString;
+    severity: z.ZodEnum<{
+        error: "error";
+        info: "info";
+        warning: "warning";
+    }>;
+    message: z.ZodString;
+}, z.core.$strip>;
+export declare const AppLaunchResultSchema: z.ZodObject<{
+    pluginInstalled: z.ZodBoolean;
+    needsRestart: z.ZodBoolean;
+    displayName: z.ZodString;
+    launchType: z.ZodString;
+    launchUrl: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+    viewer: z.ZodUnion<readonly [z.ZodObject<{
+        url: z.ZodString;
+        embedParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        postMessageAuth: z.ZodOptional<z.ZodBoolean>;
+        sandbox: z.ZodOptional<z.ZodString>;
+        authMessage: z.ZodOptional<z.ZodObject<{
+            type: z.ZodString;
+            authToken: z.ZodOptional<z.ZodString>;
+            characterId: z.ZodOptional<z.ZodString>;
+            sessionToken: z.ZodOptional<z.ZodString>;
+            agentId: z.ZodOptional<z.ZodString>;
+            followEntity: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodNull]>;
+    session: z.ZodUnion<readonly [z.ZodObject<{
+        sessionId: z.ZodString;
+        appName: z.ZodString;
+        mode: z.ZodEnum<{
+            external: "external";
+            viewer: "viewer";
+            "spectate-and-steer": "spectate-and-steer";
+        }>;
+        status: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        agentId: z.ZodOptional<z.ZodString>;
+        characterId: z.ZodOptional<z.ZodString>;
+        followEntity: z.ZodOptional<z.ZodString>;
+        canSendCommands: z.ZodOptional<z.ZodBoolean>;
+        controls: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            pause: "pause";
+            resume: "resume";
+        }>>>;
+        summary: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        goalLabel: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        suggestedPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        recommendations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            reason: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+            priority: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+            command: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+        }, z.core.$strip>>>;
+        activity: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodString;
+            message: z.ZodString;
+            timestamp: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+            severity: z.ZodOptional<z.ZodEnum<{
+                error: "error";
+                info: "info";
+                warning: "warning";
+            }>>;
+        }, z.core.$strip>>>;
+        telemetry: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodType<AppSessionJsonValue, unknown, z.core.$ZodTypeInternals<AppSessionJsonValue, unknown>>>, z.ZodNull]>>;
+    }, z.core.$strip>, z.ZodNull]>;
+    run: z.ZodUnion<readonly [z.ZodObject<{
+        runId: z.ZodString;
+        appName: z.ZodString;
+        displayName: z.ZodString;
+        pluginName: z.ZodString;
+        launchType: z.ZodString;
+        launchUrl: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+        viewer: z.ZodUnion<readonly [z.ZodObject<{
+            url: z.ZodString;
+            embedParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            postMessageAuth: z.ZodOptional<z.ZodBoolean>;
+            sandbox: z.ZodOptional<z.ZodString>;
+            authMessage: z.ZodOptional<z.ZodObject<{
+                type: z.ZodString;
+                authToken: z.ZodOptional<z.ZodString>;
+                characterId: z.ZodOptional<z.ZodString>;
+                sessionToken: z.ZodOptional<z.ZodString>;
+                agentId: z.ZodOptional<z.ZodString>;
+                followEntity: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodNull]>;
+        session: z.ZodUnion<readonly [z.ZodObject<{
+            sessionId: z.ZodString;
+            appName: z.ZodString;
+            mode: z.ZodEnum<{
+                external: "external";
+                viewer: "viewer";
+                "spectate-and-steer": "spectate-and-steer";
+            }>;
+            status: z.ZodString;
+            displayName: z.ZodOptional<z.ZodString>;
+            agentId: z.ZodOptional<z.ZodString>;
+            characterId: z.ZodOptional<z.ZodString>;
+            followEntity: z.ZodOptional<z.ZodString>;
+            canSendCommands: z.ZodOptional<z.ZodBoolean>;
+            controls: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                pause: "pause";
+                resume: "resume";
+            }>>>;
+            summary: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+            goalLabel: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+            suggestedPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            recommendations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                type: z.ZodOptional<z.ZodString>;
+                reason: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+                priority: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+                command: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+            }, z.core.$strip>>>;
+            activity: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                type: z.ZodString;
+                message: z.ZodString;
+                timestamp: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+                severity: z.ZodOptional<z.ZodEnum<{
+                    error: "error";
+                    info: "info";
+                    warning: "warning";
+                }>>;
+            }, z.core.$strip>>>;
+            telemetry: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodType<AppSessionJsonValue, unknown, z.core.$ZodTypeInternals<AppSessionJsonValue, unknown>>>, z.ZodNull]>>;
+        }, z.core.$strip>, z.ZodNull]>;
+        characterId: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+        agentId: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+        status: z.ZodString;
+        summary: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+        startedAt: z.ZodString;
+        updatedAt: z.ZodString;
+        lastHeartbeatAt: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+        supportsBackground: z.ZodBoolean;
+        supportsViewerDetach: z.ZodBoolean;
+        chatAvailability: z.ZodEnum<{
+            unknown: "unknown";
+            available: "available";
+            unavailable: "unavailable";
+        }>;
+        controlAvailability: z.ZodEnum<{
+            unknown: "unknown";
+            available: "available";
+            unavailable: "unavailable";
+        }>;
+        viewerAttachment: z.ZodEnum<{
+            unavailable: "unavailable";
+            attached: "attached";
+            detached: "detached";
+        }>;
+        recentEvents: z.ZodArray<z.ZodObject<{
+            eventId: z.ZodString;
+            kind: z.ZodEnum<{
+                status: "status";
+                summary: "summary";
+                launch: "launch";
+                refresh: "refresh";
+                attach: "attach";
+                detach: "detach";
+                stop: "stop";
+                health: "health";
+            }>;
+            severity: z.ZodEnum<{
+                error: "error";
+                info: "info";
+                warning: "warning";
+            }>;
+            message: z.ZodString;
+            createdAt: z.ZodString;
+            status: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+            details: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodType<AppSessionJsonValue, unknown, z.core.$ZodTypeInternals<AppSessionJsonValue, unknown>>>, z.ZodNull]>>;
+        }, z.core.$strip>>;
+        awaySummary: z.ZodUnion<readonly [z.ZodObject<{
+            generatedAt: z.ZodString;
+            message: z.ZodString;
+            eventCount: z.ZodNumber;
+            since: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+            until: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+        }, z.core.$strip>, z.ZodNull]>;
+        health: z.ZodObject<{
+            state: z.ZodUnion<readonly [z.ZodLiteral<"healthy">, z.ZodLiteral<"degraded">, z.ZodLiteral<"offline">]>;
+            message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+        }, z.core.$strip>;
+        healthDetails: z.ZodObject<{
+            checkedAt: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+            auth: z.ZodObject<{
+                state: z.ZodEnum<{
+                    unknown: "unknown";
+                    healthy: "healthy";
+                    degraded: "degraded";
+                    offline: "offline";
+                }>;
+                message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+            }, z.core.$strip>;
+            runtime: z.ZodObject<{
+                state: z.ZodEnum<{
+                    unknown: "unknown";
+                    healthy: "healthy";
+                    degraded: "degraded";
+                    offline: "offline";
+                }>;
+                message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+            }, z.core.$strip>;
+            viewer: z.ZodObject<{
+                state: z.ZodEnum<{
+                    unknown: "unknown";
+                    healthy: "healthy";
+                    degraded: "degraded";
+                    offline: "offline";
+                }>;
+                message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+            }, z.core.$strip>;
+            chat: z.ZodObject<{
+                state: z.ZodEnum<{
+                    unknown: "unknown";
+                    healthy: "healthy";
+                    degraded: "degraded";
+                    offline: "offline";
+                }>;
+                message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+            }, z.core.$strip>;
+            control: z.ZodObject<{
+                state: z.ZodEnum<{
+                    unknown: "unknown";
+                    healthy: "healthy";
+                    degraded: "degraded";
+                    offline: "offline";
+                }>;
+                message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+            }, z.core.$strip>;
+            message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodNull]>;
+    diagnostics: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warning: "warning";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const AppStopResultSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    appName: z.ZodString;
+    runId: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+    stoppedAt: z.ZodString;
+    pluginUninstalled: z.ZodBoolean;
+    needsRestart: z.ZodBoolean;
+    stopScope: z.ZodUnion<readonly [z.ZodLiteral<"plugin-uninstalled">, z.ZodLiteral<"viewer-session">, z.ZodLiteral<"nothing-stopped">]>;
+    message: z.ZodString;
+}, z.core.$strip>;
+/**
+ * /relaunch returns `{ launch, verify }` — `launch` is an AppLaunchResult,
+ * `verify` is the verdict from `AppVerificationService.verifyApp` (or null
+ * if the caller did not request post-launch verification).
+ */
+export declare const AppVerifyResultSchema: z.ZodObject<{
+    verdict: z.ZodString;
+    retryablePromptForChild: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const PostRelaunchAppResponseSchema: z.ZodObject<{
+    launch: z.ZodObject<{
+        pluginInstalled: z.ZodBoolean;
+        needsRestart: z.ZodBoolean;
+        displayName: z.ZodString;
+        launchType: z.ZodString;
+        launchUrl: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+        viewer: z.ZodUnion<readonly [z.ZodObject<{
+            url: z.ZodString;
+            embedParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            postMessageAuth: z.ZodOptional<z.ZodBoolean>;
+            sandbox: z.ZodOptional<z.ZodString>;
+            authMessage: z.ZodOptional<z.ZodObject<{
+                type: z.ZodString;
+                authToken: z.ZodOptional<z.ZodString>;
+                characterId: z.ZodOptional<z.ZodString>;
+                sessionToken: z.ZodOptional<z.ZodString>;
+                agentId: z.ZodOptional<z.ZodString>;
+                followEntity: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodNull]>;
+        session: z.ZodUnion<readonly [z.ZodObject<{
+            sessionId: z.ZodString;
+            appName: z.ZodString;
+            mode: z.ZodEnum<{
+                external: "external";
+                viewer: "viewer";
+                "spectate-and-steer": "spectate-and-steer";
+            }>;
+            status: z.ZodString;
+            displayName: z.ZodOptional<z.ZodString>;
+            agentId: z.ZodOptional<z.ZodString>;
+            characterId: z.ZodOptional<z.ZodString>;
+            followEntity: z.ZodOptional<z.ZodString>;
+            canSendCommands: z.ZodOptional<z.ZodBoolean>;
+            controls: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                pause: "pause";
+                resume: "resume";
+            }>>>;
+            summary: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+            goalLabel: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+            suggestedPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            recommendations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                type: z.ZodOptional<z.ZodString>;
+                reason: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+                priority: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+                command: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+            }, z.core.$strip>>>;
+            activity: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                type: z.ZodString;
+                message: z.ZodString;
+                timestamp: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+                severity: z.ZodOptional<z.ZodEnum<{
+                    error: "error";
+                    info: "info";
+                    warning: "warning";
+                }>>;
+            }, z.core.$strip>>>;
+            telemetry: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodType<AppSessionJsonValue, unknown, z.core.$ZodTypeInternals<AppSessionJsonValue, unknown>>>, z.ZodNull]>>;
+        }, z.core.$strip>, z.ZodNull]>;
+        run: z.ZodUnion<readonly [z.ZodObject<{
+            runId: z.ZodString;
+            appName: z.ZodString;
+            displayName: z.ZodString;
+            pluginName: z.ZodString;
+            launchType: z.ZodString;
+            launchUrl: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+            viewer: z.ZodUnion<readonly [z.ZodObject<{
+                url: z.ZodString;
+                embedParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                postMessageAuth: z.ZodOptional<z.ZodBoolean>;
+                sandbox: z.ZodOptional<z.ZodString>;
+                authMessage: z.ZodOptional<z.ZodObject<{
+                    type: z.ZodString;
+                    authToken: z.ZodOptional<z.ZodString>;
+                    characterId: z.ZodOptional<z.ZodString>;
+                    sessionToken: z.ZodOptional<z.ZodString>;
+                    agentId: z.ZodOptional<z.ZodString>;
+                    followEntity: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>, z.ZodNull]>;
+            session: z.ZodUnion<readonly [z.ZodObject<{
+                sessionId: z.ZodString;
+                appName: z.ZodString;
+                mode: z.ZodEnum<{
+                    external: "external";
+                    viewer: "viewer";
+                    "spectate-and-steer": "spectate-and-steer";
+                }>;
+                status: z.ZodString;
+                displayName: z.ZodOptional<z.ZodString>;
+                agentId: z.ZodOptional<z.ZodString>;
+                characterId: z.ZodOptional<z.ZodString>;
+                followEntity: z.ZodOptional<z.ZodString>;
+                canSendCommands: z.ZodOptional<z.ZodBoolean>;
+                controls: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                    pause: "pause";
+                    resume: "resume";
+                }>>>;
+                summary: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+                goalLabel: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+                suggestedPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                recommendations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    label: z.ZodString;
+                    type: z.ZodOptional<z.ZodString>;
+                    reason: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+                    priority: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+                    command: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+                }, z.core.$strip>>>;
+                activity: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    type: z.ZodString;
+                    message: z.ZodString;
+                    timestamp: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+                    severity: z.ZodOptional<z.ZodEnum<{
+                        error: "error";
+                        info: "info";
+                        warning: "warning";
+                    }>>;
+                }, z.core.$strip>>>;
+                telemetry: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodType<AppSessionJsonValue, unknown, z.core.$ZodTypeInternals<AppSessionJsonValue, unknown>>>, z.ZodNull]>>;
+            }, z.core.$strip>, z.ZodNull]>;
+            characterId: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+            agentId: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+            status: z.ZodString;
+            summary: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+            startedAt: z.ZodString;
+            updatedAt: z.ZodString;
+            lastHeartbeatAt: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+            supportsBackground: z.ZodBoolean;
+            supportsViewerDetach: z.ZodBoolean;
+            chatAvailability: z.ZodEnum<{
+                unknown: "unknown";
+                available: "available";
+                unavailable: "unavailable";
+            }>;
+            controlAvailability: z.ZodEnum<{
+                unknown: "unknown";
+                available: "available";
+                unavailable: "unavailable";
+            }>;
+            viewerAttachment: z.ZodEnum<{
+                unavailable: "unavailable";
+                attached: "attached";
+                detached: "detached";
+            }>;
+            recentEvents: z.ZodArray<z.ZodObject<{
+                eventId: z.ZodString;
+                kind: z.ZodEnum<{
+                    status: "status";
+                    summary: "summary";
+                    launch: "launch";
+                    refresh: "refresh";
+                    attach: "attach";
+                    detach: "detach";
+                    stop: "stop";
+                    health: "health";
+                }>;
+                severity: z.ZodEnum<{
+                    error: "error";
+                    info: "info";
+                    warning: "warning";
+                }>;
+                message: z.ZodString;
+                createdAt: z.ZodString;
+                status: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+                details: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodType<AppSessionJsonValue, unknown, z.core.$ZodTypeInternals<AppSessionJsonValue, unknown>>>, z.ZodNull]>>;
+            }, z.core.$strip>>;
+            awaySummary: z.ZodUnion<readonly [z.ZodObject<{
+                generatedAt: z.ZodString;
+                message: z.ZodString;
+                eventCount: z.ZodNumber;
+                since: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+                until: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+            }, z.core.$strip>, z.ZodNull]>;
+            health: z.ZodObject<{
+                state: z.ZodUnion<readonly [z.ZodLiteral<"healthy">, z.ZodLiteral<"degraded">, z.ZodLiteral<"offline">]>;
+                message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+            }, z.core.$strip>;
+            healthDetails: z.ZodObject<{
+                checkedAt: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+                auth: z.ZodObject<{
+                    state: z.ZodEnum<{
+                        unknown: "unknown";
+                        healthy: "healthy";
+                        degraded: "degraded";
+                        offline: "offline";
+                    }>;
+                    message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+                }, z.core.$strip>;
+                runtime: z.ZodObject<{
+                    state: z.ZodEnum<{
+                        unknown: "unknown";
+                        healthy: "healthy";
+                        degraded: "degraded";
+                        offline: "offline";
+                    }>;
+                    message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+                }, z.core.$strip>;
+                viewer: z.ZodObject<{
+                    state: z.ZodEnum<{
+                        unknown: "unknown";
+                        healthy: "healthy";
+                        degraded: "degraded";
+                        offline: "offline";
+                    }>;
+                    message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+                }, z.core.$strip>;
+                chat: z.ZodObject<{
+                    state: z.ZodEnum<{
+                        unknown: "unknown";
+                        healthy: "healthy";
+                        degraded: "degraded";
+                        offline: "offline";
+                    }>;
+                    message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+                }, z.core.$strip>;
+                control: z.ZodObject<{
+                    state: z.ZodEnum<{
+                        unknown: "unknown";
+                        healthy: "healthy";
+                        degraded: "degraded";
+                        offline: "offline";
+                    }>;
+                    message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+                }, z.core.$strip>;
+                message: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodNull]>;
+        diagnostics: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            severity: z.ZodEnum<{
+                error: "error";
+                info: "info";
+                warning: "warning";
+            }>;
+            message: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    verify: z.ZodUnion<readonly [z.ZodObject<{
+        verdict: z.ZodString;
+        retryablePromptForChild: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodNull]>;
+}, z.core.$strip>;
+export type PostRelaunchAppResponse = z.infer<typeof PostRelaunchAppResponseSchema>;
+export type AppVerifyResult = z.infer<typeof AppVerifyResultSchema>;
 export declare const ELIZA_CURATED_APP_DEFINITIONS: readonly ElizaCuratedAppDefinition[];
 export declare function packageNameToAppRouteSlug(packageName: string): string | null;
 export declare function packageNameToAppDisplayName(packageName: string): string;