Function createWindow

apps/desktop/src/main/index.ts:585–610

(conn: SidecarConnection)

};

const createWindow = async (conn: SidecarConnection) => {
  installBearerAuthHeader(conn.baseUrl, conn.authToken);

  const existingWindow = liveMainWindow();
  const window = existingWindow ?? createMainBrowserWindow({ show: false });

  // A supervised daemon can pass the health probe and still disappear before
  // navigation begins. Treat that as a failed connection instead of leaving the
  // user with a visible BrowserWindow that only shows the black background.
  // oxlint-disable-next-line executor/no-try-catch-or-throw -- boundary: Electron navigation rejects when the sidecar vanishes during startup
  try {
    await window.loadURL(webUrlForConnection(conn));
    if (!window.isDestroyed() && !window.isVisible()) window.show();
  } catch (error) {
    // The window was closed (or the app is quitting) while this navigation was
    // in flight. Nothing failed — there is just nowhere left to navigate.
    if (isTeardownNavigationError(error, window)) {
      log.info("Executor web UI load aborted while the window was closing");
      return;
    }
    log.error("Failed to load Executor web UI", error);
    if (!existingWindow) destroyWindow(window);
    // oxlint-disable-next-line executor/no-try-catch-or-throw -- boundary: caller decides whether to fall back or surface startup failure
    throw error;
  }
};

const showPortInUseDialog = async (port: number) => {
  await dialog.showMessageBox({