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

package/packages/agent/src/services/app-manager.js

@@ -15,32 +15,17 @@ import { logger } from "@elizaos/core";
 import { getElizaCuratedAppCatalogOrder, getElizaCuratedAppLookupNames, hasAppInterface, normalizeElizaCuratedAppName, packageNameToAppDisplayName, packageNameToAppRouteSlug, } from "../contracts/apps.js";
 import { importAppPlugin, importAppRouteModule, } from "./app-package-modules.js";
 import { readAppRunStore, writeAppRunStore } from "./app-run-store.js";
-import { generateBotPassword, generateBotUsername, } from "./credential-words.js";
 import { getPluginInfo, getRegistryPlugins } from "./registry-client.js";
 import { mergeAppMeta as mergeRegistryAppMeta, resolveAppOverride, } from "./registry-client-app-meta.js";
 import { resolveAppHeroImage, scoreEntries, toSearchResults, } from "./registry-client-queries.js";
 const LOCAL_PLUGINS_DIR = "plugins";
 const DEFAULT_VIEWER_SANDBOX = "allow-scripts allow-same-origin allow-popups";
-const RS_2004SCAPE_APP_ROUTE_SLUG = "2004scape";
-const RS_2004SCAPE_AUTH_MESSAGE_TYPE = "RS_2004SCAPE_AUTH";
-const RS_2004SCAPE_BOT_NAME_KEYS = ["RS_SDK_BOT_NAME", "BOT_NAME"];
-const RS_2004SCAPE_BOT_PASSWORD_KEYS = [
-    "RS_SDK_BOT_PASSWORD",
-    "BOT_PASSWORD",
-];
 const DEFAULT_RS_SDK_SERVER_URL = "https://rs-sdk-demo.fly.dev";
-const BABYLON_APP_ROUTE_SLUG = "babylon";
-const LOCAL_DEV_BABYLON_CLIENT_URL = "http://localhost:3000";
-const PRODUCTION_BABYLON_CLIENT_URL = "https://staging.babylon.market";
-const BABYLON_AGENT_SESSION_TOKEN_KEY = "BABYLON_AGENT_SESSION_TOKEN";
-const BABYLON_AGENT_SESSION_EXPIRES_AT_KEY = "BABYLON_AGENT_SESSION_EXPIRES_AT";
 const HYPERSCAPE_APP_ROUTE_SLUG = "hyperscape";
 const LOCAL_DEV_HYPERSCAPE_CLIENT_URL = "http://localhost:3333";
 const PRODUCTION_HYPERSCAPE_CLIENT_URL = "https://hyperscape.gg";
-const HYPERSCAPE_WALLET_AUTH_TIMEOUT_MS = 5_000;
 const SAFE_APP_URL_PROTOCOLS = new Set(["http:", "https:"]);
 const SAFE_APP_TEMPLATE_ENV_KEYS = new Set([
-    "BABYLON_CLIENT_URL",
     "BOT_NAME",
     "HYPERSCAPE_CHARACTER_ID",
     "HYPERSCAPE_CLIENT_URL",
@@ -65,35 +50,9 @@ function isProductionRuntime() {
 function isAppRegistryPlugin(plugin) {
     return hasAppInterface(plugin);
 }
-function is2004scapeAppName(appName) {
-    return packageNameToAppRouteSlug(appName) === RS_2004SCAPE_APP_ROUTE_SLUG;
-}
-function isBabylonAppName(appName) {
-    return packageNameToAppRouteSlug(appName) === BABYLON_APP_ROUTE_SLUG;
-}
 function isHyperscapeAppName(appName) {
     return packageNameToAppRouteSlug(appName) === HYPERSCAPE_APP_ROUTE_SLUG;
 }
-/**
- * Quick TCP-level probe to check if the 2004scape game server is reachable.
- * Returns true if a connection can be established within the timeout.
- */
-async function is2004scapeServerReachable(serverUrl, timeoutMs = 2000) {
-    try {
-        const url = new URL(serverUrl);
-        const controller = new AbortController();
-        const timer = setTimeout(() => controller.abort(), timeoutMs);
-        const res = await fetch(url.href, {
-            method: "HEAD",
-            signal: controller.signal,
-        }).catch(() => null);
-        clearTimeout(timer);
-        return res !== null;
-    }
-    catch {
-        return false;
-    }
-}
 function resolveDisplayViewerInfo(viewer) {
     if (!viewer)
         return viewer;
@@ -369,17 +328,6 @@ function isLocalPlugin(appInfo) {
     return false;
 }
 function getTemplateFallbackValue(key) {
-    if (key === "BABYLON_CLIENT_URL") {
-        const runtimeClientUrl = process.env.BABYLON_CLIENT_URL?.trim() ??
-            process.env.BABYLON_APP_URL?.trim() ??
-            process.env.BABYLON_API_URL?.trim();
-        if (runtimeClientUrl && runtimeClientUrl.length > 0) {
-            return runtimeClientUrl;
-        }
-        return isProductionRuntime()
-            ? PRODUCTION_BABYLON_CLIENT_URL
-            : LOCAL_DEV_BABYLON_CLIENT_URL;
-    }
     if (key === "RS_SDK_BOT_NAME") {
         const runtimeBotName = process.env.BOT_NAME?.trim();
         if (runtimeBotName && runtimeBotName.length > 0) {
@@ -410,295 +358,6 @@ function resolveSettingLike(runtime, key) {
     }
     return undefined;
 }
-function resolve2004scapeServerUrl(runtime) {
-    const runtimeUrl = resolveSettingLike(runtime, "RS_SDK_SERVER_URL");
-    if (runtimeUrl) {
-        return runtimeUrl.replace(/\/+$/, "");
-    }
-    return DEFAULT_RS_SDK_SERVER_URL;
-}
-function get2004scapeCredentialKeys(key) {
-    return key === "RS_SDK_BOT_NAME"
-        ? RS_2004SCAPE_BOT_NAME_KEYS
-        : RS_2004SCAPE_BOT_PASSWORD_KEYS;
-}
-function resolve2004scapeCredential(runtime, key) {
-    for (const credentialKey of get2004scapeCredentialKeys(key)) {
-        const value = resolveSettingLike(runtime, credentialKey);
-        if (value) {
-            return value;
-        }
-    }
-    return undefined;
-}
-// ---------------------------------------------------------------------------
-// 2004scape credential auto-provisioning
-// ---------------------------------------------------------------------------
-function persist2004scapeCredential(runtime, key, value, secret = false) {
-    const credentialKeys = get2004scapeCredentialKeys(key);
-    for (const credentialKey of credentialKeys) {
-        process.env[credentialKey] = value;
-    }
-    if (!runtime)
-        return;
-    const character = runtime.character;
-    if (!character.settings) {
-        character.settings = {};
-    }
-    if (!character.settings.secrets) {
-        character.settings.secrets = {};
-    }
-    if (!character.secrets) {
-        character.secrets = {};
-    }
-    for (const credentialKey of credentialKeys) {
-        try {
-            runtime.setSetting(credentialKey, value, secret);
-        }
-        catch (err) {
-            logger.error(`[app-manager] Failed to persist 2004scape credential "${credentialKey}": ${err}`);
-        }
-        character.settings.secrets[credentialKey] = value;
-        character.secrets[credentialKey] = value;
-    }
-}
-async function prepare2004scapeLaunch(runtime) {
-    const primaryName = resolveSettingLike(runtime, "RS_SDK_BOT_NAME");
-    const compatName = resolveSettingLike(runtime, "BOT_NAME");
-    const primaryPassword = resolveSettingLike(runtime, "RS_SDK_BOT_PASSWORD");
-    const compatPassword = resolveSettingLike(runtime, "BOT_PASSWORD");
-    const agentDisplayName = runtime?.character?.name || "agent";
-    const username = primaryName ?? compatName ?? generateBotUsername(agentDisplayName);
-    const password = primaryPassword ?? compatPassword ?? generateBotPassword();
-    const shouldPersistName = primaryName !== username || compatName !== username;
-    const shouldPersistPassword = primaryPassword !== password || compatPassword !== password;
-    if (shouldPersistName) {
-        persist2004scapeCredential(runtime, "RS_SDK_BOT_NAME", username);
-    }
-    if (shouldPersistPassword) {
-        persist2004scapeCredential(runtime, "RS_SDK_BOT_PASSWORD", password, true);
-    }
-    if (shouldPersistName || shouldPersistPassword) {
-        logger.info(`[app-manager] Prepared 2004scape credentials for "${username}"`);
-    }
-    return [];
-}
-// ---------------------------------------------------------------------------
-// Babylon credential auto-provisioning
-// ---------------------------------------------------------------------------
-function persistBabylonCredential(runtime, key, value, secret = false) {
-    process.env[key] = value;
-    if (!runtime)
-        return;
-    try {
-        runtime.setSetting(key, value, secret);
-    }
-    catch (err) {
-        logger.error(`[app-manager] Failed to persist Babylon credential "${key}": ${err}`);
-    }
-    const character = runtime.character;
-    if (!character.settings) {
-        character.settings = {};
-    }
-    if (!character.settings.secrets) {
-        character.settings.secrets = {};
-    }
-    character.settings.secrets[key] = value;
-    if (!character.secrets) {
-        character.secrets = {};
-    }
-    character.secrets[key] = value;
-}
-function resolveBabylonApiBaseUrl(runtime) {
-    return (resolveSettingLike(runtime, "BABYLON_API_URL") ??
-        resolveSettingLike(runtime, "BABYLON_APP_URL") ??
-        resolveSettingLike(runtime, "BABYLON_CLIENT_URL") ??
-        (isProductionRuntime()
-            ? PRODUCTION_BABYLON_CLIENT_URL
-            : LOCAL_DEV_BABYLON_CLIENT_URL)).replace(/\/+$/, "");
-}
-/**
- * Probe Babylon for dev credentials. In development mode, Babylon generates
- * deterministic credentials from the server hostname. We can discover them
- * by calling the health/auth probe endpoints.
- */
-async function probeBabylonDevCredentials(baseUrl) {
-    // Try well-known dev agent IDs with common dev secrets
-    const devAgentIds = [
-        "babylon-agent-alice",
-        "babylon-test-agent",
-        "dev-admin-local",
-    ];
-    // Dev secrets are deterministic from hostname — try multiple hostname sources
-    const nodeCrypto = await import("node:crypto");
-    const os = await import("node:os");
-    const hostnames = new Set();
-    // Add all likely hostname sources
-    hostnames.add("localhost");
-    hostnames.add("0.0.0.0");
-    if (process.env.HOSTNAME)
-        hostnames.add(process.env.HOSTNAME);
-    try {
-        hostnames.add(os.hostname());
-    }
-    catch {
-        /* ignore */
-    }
-    const devSecrets = [];
-    for (const hostname of hostnames) {
-        if (!hostname)
-            continue;
-        const hash = nodeCrypto
-            .createHash("sha256")
-            .update(`babylon-dev:${hostname}:agent`)
-            .digest("hex")
-            .substring(0, 32);
-        devSecrets.push(`dev_agent_${hash}`);
-    }
-    for (const agentId of devAgentIds) {
-        for (const agentSecret of devSecrets) {
-            try {
-                const response = await fetch(new URL("/api/agents/auth", baseUrl), {
-                    method: "POST",
-                    headers: { "Content-Type": "application/json" },
-                    body: JSON.stringify({ agentId, agentSecret }),
-                    signal: AbortSignal.timeout(3_000),
-                });
-                if (response.ok) {
-                    const data = (await response.json());
-                    if (data.success || data.sessionToken) {
-                        logger.info(`[app-manager] Babylon dev credentials discovered (agentId=${agentId})`);
-                        return { agentId, agentSecret };
-                    }
-                }
-            }
-            catch {
-                // Connection failed — Babylon not reachable
-                return null;
-            }
-        }
-    }
-    return null;
-}
-async function authenticateBabylonAgentSession(baseUrl, agentId, agentSecret) {
-    const response = await fetch(new URL("/api/agents/auth", baseUrl), {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-            agentId,
-            agentSecret,
-        }),
-        signal: AbortSignal.timeout(3_000),
-    });
-    if (!response.ok) {
-        return null;
-    }
-    const data = (await response.json());
-    if (!data.sessionToken) {
-        return null;
-    }
-    return {
-        sessionToken: data.sessionToken,
-        expiresAt: typeof data.expiresAt === "string" && data.expiresAt.trim().length > 0
-            ? data.expiresAt
-            : undefined,
-    };
-}
-/**
- * Auto-provision Babylon credentials on app launch.
- *
- * Flow:
- * 1. If BABYLON_AGENT_ID + BABYLON_AGENT_SECRET are already set, skip.
- * 2. In dev mode: probe Babylon for dev credentials and auto-configure.
- * 3. In production: warn the user to set credentials manually.
- */
-async function prepareBabylonLaunch(runtime) {
-    const existingId = resolveSettingLike(runtime, "BABYLON_AGENT_ID") ??
-        process.env.BABYLON_AGENT_ID?.trim();
-    const existingSecret = resolveSettingLike(runtime, "BABYLON_AGENT_SECRET") ??
-        process.env.BABYLON_AGENT_SECRET?.trim();
-    // Already configured — nothing to do
-    if (existingId && existingSecret) {
-        // Verify the credentials work by attempting auth
-        const baseUrl = resolveBabylonApiBaseUrl(runtime);
-        try {
-            const session = await authenticateBabylonAgentSession(baseUrl, existingId, existingSecret);
-            if (session) {
-                persistBabylonCredential(runtime, BABYLON_AGENT_SESSION_TOKEN_KEY, session.sessionToken, true);
-                if (session.expiresAt) {
-                    persistBabylonCredential(runtime, BABYLON_AGENT_SESSION_EXPIRES_AT_KEY, session.expiresAt, true);
-                }
-                logger.info(`[app-manager] Babylon credentials verified (agentId=${existingId})`);
-                return [];
-            }
-            return [
-                {
-                    code: "babylon-auth-failed",
-                    severity: "warning",
-                    message: "Babylon credentials are set but authentication failed. Check BABYLON_AGENT_ID and BABYLON_AGENT_SECRET.",
-                },
-            ];
-        }
-        catch {
-            return [
-                {
-                    code: "babylon-unreachable",
-                    severity: "warning",
-                    message: `Cannot reach Babylon at ${baseUrl}. Is the server running?`,
-                },
-            ];
-        }
-    }
-    // No credentials — try auto-provisioning in dev mode
-    if (!isProductionRuntime()) {
-        const baseUrl = resolveBabylonApiBaseUrl(runtime);
-        // First check if Babylon is even reachable
-        try {
-            await fetch(new URL("/api/health", baseUrl), {
-                signal: AbortSignal.timeout(3_000),
-            });
-        }
-        catch {
-            return [
-                {
-                    code: "babylon-unreachable",
-                    severity: "warning",
-                    message: `Cannot reach Babylon at ${baseUrl}. Start the Babylon dev server and re-launch.`,
-                },
-            ];
-        }
-        // Try dev credentials
-        const devCreds = await probeBabylonDevCredentials(baseUrl);
-        if (devCreds) {
-            persistBabylonCredential(runtime, "BABYLON_AGENT_ID", devCreds.agentId);
-            persistBabylonCredential(runtime, "BABYLON_AGENT_SECRET", devCreds.agentSecret, true);
-            const session = await authenticateBabylonAgentSession(baseUrl, devCreds.agentId, devCreds.agentSecret);
-            if (session) {
-                persistBabylonCredential(runtime, BABYLON_AGENT_SESSION_TOKEN_KEY, session.sessionToken, true);
-                if (session.expiresAt) {
-                    persistBabylonCredential(runtime, BABYLON_AGENT_SESSION_EXPIRES_AT_KEY, session.expiresAt, true);
-                }
-            }
-            logger.info(`[app-manager] Auto-provisioned Babylon dev credentials (agentId=${devCreds.agentId})`);
-            return [];
-        }
-        return [
-            {
-                code: "babylon-no-agent-id",
-                severity: "warning",
-                message: "Could not auto-provision Babylon credentials. Set BABYLON_AGENT_ID and BABYLON_AGENT_SECRET in your environment.",
-            },
-        ];
-    }
-    // Production without credentials
-    return [
-        {
-            code: "babylon-no-agent-id",
-            severity: "warning",
-            message: "BABYLON_AGENT_ID is not set. Set BABYLON_AGENT_ID and BABYLON_AGENT_SECRET for full Babylon integration.",
-        },
-    ];
-}
 function readSafeTemplateEnv(key) {
     if (!SAFE_APP_TEMPLATE_ENV_KEYS.has(key)) {
         return undefined;
@@ -807,61 +466,6 @@ async function buildViewerAuthMessage(appInfo, launchUrl, runtime) {
             viewer: null,
         })) ?? undefined);
     }
-    if (isHyperscapeAppName(appInfo.name)) {
-        const authToken = resolveSettingLike(runtime, "HYPERSCAPE_AUTH_TOKEN");
-        if (!authToken) {
-            return undefined;
-        }
-        const agentId = typeof runtime?.agentId === "string" && runtime.agentId.trim().length > 0
-            ? runtime.agentId.trim()
-            : undefined;
-        if (!agentId) {
-            return undefined;
-        }
-        const characterId = resolveSettingLike(runtime, "HYPERSCAPE_CHARACTER_ID") ?? agentId;
-        return {
-            type: "HYPERSCAPE_AUTH",
-            authToken,
-            agentId,
-            characterId,
-            followEntity: characterId,
-        };
-    }
-    // Babylon auth — passes agent credentials to the viewer iframe
-    if (isBabylonAppName(appInfo.name)) {
-        const agentId = resolveSettingLike(runtime, "BABYLON_AGENT_ID") ??
-            process.env.BABYLON_AGENT_ID?.trim();
-        const sessionToken = resolveSettingLike(runtime, BABYLON_AGENT_SESSION_TOKEN_KEY) ??
-            process.env[BABYLON_AGENT_SESSION_TOKEN_KEY]?.trim();
-        if (!agentId || !sessionToken) {
-            return undefined;
-        }
-        return {
-            type: "BABYLON_AUTH",
-            authToken: sessionToken,
-            sessionToken,
-            agentId,
-            characterId: agentId,
-        };
-    }
-    // 2004scape auth - uses auto-provisioned or user-supplied credentials
-    if (is2004scapeAppName(appInfo.name)) {
-        await prepare2004scapeLaunch(runtime ?? null);
-        const username = resolve2004scapeCredential(runtime, "RS_SDK_BOT_NAME");
-        const password = resolve2004scapeCredential(runtime, "RS_SDK_BOT_PASSWORD");
-        if (!username || !password) {
-            logger.warn("[app-manager] 2004scape credentials are unavailable. " +
-                "Launch the app with a live runtime to auto-provision credentials.");
-            return undefined;
-        }
-        return {
-            type: RS_2004SCAPE_AUTH_MESSAGE_TYPE,
-            authToken: username,
-            sessionToken: password,
-            characterId: username,
-            agentId: runtime?.agentId,
-        };
-    }
     return undefined;
 }
 async function buildViewerConfig(appInfo, launchUrl, runtime) {
@@ -925,9 +529,6 @@ function buildAppSession(appInfo, authMessage, runtime) {
         controls.push("resume");
     }
     const canSendCommands = features.has("commands") || features.has("suggestions");
-    const summary = isBabylonAppName(appInfo.name)
-        ? "Connecting to Babylon..."
-        : "Connecting session...";
     const characterId = authMessage?.characterId ??
         (isHyperscapeAppName(appInfo.name)
             ? resolveSettingLike(runtime, "HYPERSCAPE_CHARACTER_ID")
@@ -944,7 +545,7 @@ function buildAppSession(appInfo, authMessage, runtime) {
         followEntity,
         canSendCommands,
         controls,
-        summary,
+        summary: "Connecting session...",
     };
 }
 function buildUnavailableSession(run, status, summary) {
@@ -1001,161 +602,15 @@ async function invokeAppStopRunHook(run, runtime) {
         logger.warn(`[app-manager] stopRun hook for "${run.appName}" (runId=${run.runId}) failed: ${message}`);
     }
 }
-function persistHyperscapeCredential(runtime, key, value, secret = false) {
-    if (!runtime) {
-        return;
-    }
-    try {
-        runtime.setSetting?.(key, value, secret);
-    }
-    catch (err) {
-        logger.error(`[app-manager] Failed to persist Hyperscape credential "${key}": ${err}`);
-    }
-    const character = runtime.character;
-    if (!character.settings) {
-        character.settings = {};
-    }
-    if (!character.settings.secrets) {
-        character.settings.secrets = {};
-    }
-    character.settings.secrets[key] = value;
-    if (!character.secrets) {
-        character.secrets = {};
-    }
-    character.secrets[key] = value;
-}
-function resolveHyperscapeApiBaseUrl(runtime) {
-    const configuredUrl = resolveSettingLike(runtime, "HYPERSCAPE_API_URL");
-    if (!configuredUrl) {
-        return null;
-    }
-    const normalized = normalizeSafeAppUrl(configuredUrl);
-    if (!normalized || normalized.startsWith("/")) {
-        logger.warn("[app-manager] Ignoring invalid HYPERSCAPE_API_URL; expected an absolute http/https URL.");
-        return null;
-    }
-    return normalized.replace(/\/+$/, "");
-}
-async function prepareHyperscapeWalletAuthFromRuntime(runtime) {
-    if (!runtime) {
-        return;
-    }
-    if (resolveSettingLike(runtime, "HYPERSCAPE_AUTH_TOKEN")) {
-        return;
-    }
-    const base = resolveHyperscapeApiBaseUrl(runtime);
-    if (!base) {
-        return;
-    }
-    let agent;
-    try {
-        if (typeof runtime.getAgent === "function" && runtime.agentId) {
-            agent = await runtime.getAgent(runtime.agentId);
-        }
-    }
-    catch {
-        agent = null;
-    }
-    const walletAddresses = agent && typeof agent === "object"
-        ? agent.walletAddresses
-        : undefined;
-    let evm = walletAddresses?.evm?.trim();
-    if (!evm) {
-        const existingPk = resolveSettingLike(runtime, "EVM_PRIVATE_KEY")?.trim() ||
-            process.env.EVM_PRIVATE_KEY?.trim();
-        if (existingPk) {
-            const { deriveEvmAddress } = await import("../api/wallet.js");
-            evm = deriveEvmAddress(existingPk);
-        }
-    }
-    if (!evm) {
-        logger.info("[app-manager] Skipping Hyperscape wallet auth: no EVM address or EVM_PRIVATE_KEY is available.");
-        return;
-    }
-    try {
-        const walletAuthUrl = new URL("/api/agents/wallet-auth", `${base}/`);
-        const res = await fetch(walletAuthUrl, {
-            method: "POST",
-            headers: { "content-type": "application/json" },
-            body: JSON.stringify({
-                walletAddress: evm,
-                walletType: "evm",
-                agentName: runtime.character?.name,
-                agentId: runtime.agentId,
-            }),
-            signal: AbortSignal.timeout(HYPERSCAPE_WALLET_AUTH_TIMEOUT_MS),
-        });
-        if (!res.ok) {
-            return;
-        }
-        const data = (await res.json());
-        if (data.success !== true || typeof data.authToken !== "string") {
-            return;
-        }
-        persistHyperscapeCredential(runtime, "HYPERSCAPE_AUTH_TOKEN", data.authToken, true);
-        if (typeof data.characterId === "string" && data.characterId.trim()) {
-            persistHyperscapeCredential(runtime, "HYPERSCAPE_CHARACTER_ID", data.characterId.trim());
-        }
-    }
-    catch {
-        // Fixture or network unavailable — viewer may still load without auth.
-    }
-}
 async function prepareLaunch(appInfo, launchUrl, runtime) {
     const routeModule = await importAppRouteModule(appInfo.name);
-    if (isBabylonAppName(appInfo.name)) {
-        const diagnostics = await prepareBabylonLaunch(runtime);
-        const babylonUrl = resolveBabylonApiBaseUrl(runtime);
-        const agentId = resolveSettingLike(runtime, "BABYLON_AGENT_ID");
-        logger.info(`[app-manager] Babylon launch: url=${babylonUrl} agentId=${agentId ?? "(none)"}`);
-        return { diagnostics };
-    }
-    if (is2004scapeAppName(appInfo.name)) {
-        const rsSdkServerUrl = resolve2004scapeServerUrl(runtime);
-        const serverUp = await is2004scapeServerReachable(rsSdkServerUrl);
-        if (!serverUp) {
-            logger.info(`[app-manager] 2004scape server is not reachable at ${rsSdkServerUrl} — skipping plugin registration to avoid noisy SDK errors`);
-            return {
-                diagnostics: [
-                    {
-                        code: "2004scape-server-unreachable",
-                        severity: "warning",
-                        message: `2004scape game server is not running at ${rsSdkServerUrl}. Start the server and re-launch the app.`,
-                    },
-                ],
-            };
-        }
-        const routePreparation = typeof routeModule?.prepareLaunch === "function"
-            ? ((await routeModule.prepareLaunch({
-                appName: appInfo.name,
-                launchUrl,
-                runtime,
-                viewer: null,
-            })) ?? {})
-            : {};
-        return {
-            ...routePreparation,
-            diagnostics: [
-                ...(routePreparation.diagnostics ?? []),
-                ...(await prepare2004scapeLaunch(runtime)),
-            ],
-        };
-    }
     if (typeof routeModule?.prepareLaunch === "function") {
-        const preparation = (await routeModule.prepareLaunch({
+        return ((await routeModule.prepareLaunch({
             appName: appInfo.name,
             launchUrl,
             runtime,
             viewer: null,
-        })) ?? {};
-        if (isHyperscapeAppName(appInfo.name)) {
-            await prepareHyperscapeWalletAuthFromRuntime(runtime);
-        }
-        return preparation;
-    }
-    if (isHyperscapeAppName(appInfo.name)) {
-        await prepareHyperscapeWalletAuthFromRuntime(runtime);
-        return {};
+        })) ?? {});
     }
     return {};
 }
@@ -1212,71 +667,19 @@ function getRuntimePluginCandidates(appInfo) {
     ];
     return Array.from(new Set(candidates.filter((candidate) => typeof candidate === "string" && candidate.trim().length > 0)));
 }
-function collect2004scapeLaunchDiagnostics(appInfo, viewer, _session, runtime) {
-    if (!is2004scapeAppName(appInfo.name)) {
-        return [];
-    }
-    const diagnostics = [];
-    const botName = resolve2004scapeCredential(runtime, "RS_SDK_BOT_NAME");
-    const botPassword = resolve2004scapeCredential(runtime, "RS_SDK_BOT_PASSWORD");
-    if (!botName || !botPassword) {
-        diagnostics.push({
-            code: "2004scape-credentials-missing",
-            severity: "warning",
-            message: "2004scape bot credentials are not stored yet. The viewer will load without auto-login until launch provisions them.",
-        });
-    }
-    if (viewer?.postMessageAuth && !viewer.authMessage) {
-        diagnostics.push({
-            code: "2004scape-auth-unavailable",
-            severity: "error",
-            message: "2004scape auto-sign-in could not resolve stored bot credentials for this run.",
-        });
-    }
-    return diagnostics;
-}
-function collectHyperscapeLaunchDiagnostics(appInfo, viewer) {
-    if (!isHyperscapeAppName(appInfo.name)) {
-        return [];
-    }
-    const wantsAuth = Boolean(appInfo.viewer?.postMessageAuth);
-    if (wantsAuth && !viewer?.authMessage) {
-        return [
-            {
-                code: "hyperscape-auth-unavailable",
-                severity: "error",
-                message: "Hyperscape postMessage auth requires HYPERSCAPE_AUTH_TOKEN and a runtime agent id.",
-            },
-        ];
-    }
-    return [];
-}
 async function collectLaunchDiagnostics(appInfo, viewer, session, launchUrl, runtime) {
     const routeModule = await importAppRouteModule(appInfo.name);
     const diagnosticViewer = viewer && appInfo.viewer?.postMessageAuth && !viewer.authMessage
         ? { ...viewer, postMessageAuth: true }
         : viewer;
     if (typeof routeModule?.collectLaunchDiagnostics === "function") {
-        const pluginDiagnostics = await routeModule.collectLaunchDiagnostics({
+        return routeModule.collectLaunchDiagnostics({
             appName: appInfo.name,
             launchUrl,
             runtime,
             viewer: diagnosticViewer,
             session,
         });
-        if (isHyperscapeAppName(appInfo.name)) {
-            return [
-                ...pluginDiagnostics,
-                ...collectHyperscapeLaunchDiagnostics(appInfo, viewer),
-            ];
-        }
-        return pluginDiagnostics;
-    }
-    if (is2004scapeAppName(appInfo.name)) {
-        return collect2004scapeLaunchDiagnostics(appInfo, viewer, session, runtime);
-    }
-    if (isHyperscapeAppName(appInfo.name)) {
-        return collectHyperscapeLaunchDiagnostics(appInfo, viewer);
     }
     return [];
 }
@@ -2021,10 +1424,7 @@ export class AppManager {
         if (resolvedLaunchUrl && !launchUrl) {
             throw new Error(`Refusing to launch app "${appInfo.name}": unsafe launch URL`);
         }
-        // Skip runtime plugin registration when the target service is unreachable
-        // (e.g. 2004scape server down) to avoid error-level logs from the SDK init.
-        const skipPluginRegistration = is2004scapeAppName(appInfo.name) &&
-            launchPreparationDiagnostics.some((d) => d.code === "2004scape-server-unreachable");
+        const skipPluginRegistration = launchPreparation.skipRuntimePluginRegistration === true;
         let runtimePluginRegistered = false;
         if (!skipPluginRegistration) {
             runtimePluginRegistered = await ensureRuntimePluginRegistered(appInfo, _runtime ?? null, isLocal);