Method connect

webui/js/websocket.js:390–438

()

  }

  async connect() {
    if (this.connected) return;
    if (this.connectPromise) return this.connectPromise;

    this._manualDisconnect = false;
    this.connecting = true;
    this.connectPromise = (async () => {
      if (!this.socket) {
        this.initializeSocket();
      }

      if (this.socket.connected) return;

      // Ensure the current runtime-bound session + CSRF cookies exist before initiating
      // the Engine.IO handshake. This is required for seamless reconnect after backend
      // restarts that rotate runtime_id and session cookie names.
      try {
        await getCsrfToken();
      } catch (error) {
        this.debugLog("csrf prefetch failed - continuing", {
          error: error instanceof Error ? error.message : String(error),
        });
      }

      await new Promise((resolve, reject) => {
        const onConnect = () => {
          this.socket.off("connect_error", onError);
          resolve();
        };
        const onError = (error) => {
          this.socket.off("connect", onConnect);
          reject(error instanceof Error ? error : new Error(String(error)));
        };

        this.socket.once("connect", onConnect);
        this.socket.once("connect_error", onError);
        this.socket.connect();
      });
    })()
      .catch((error) => {
        throw new Error(`WebSocket connection failed: ${error.message || error}`);
      })
      .finally(() => {
        this.connecting = false;
        this.connectPromise = null;
      });

    return this.connectPromise;
  }

  async disconnect() {
    if (!this.socket) return;