agent-orchestrator/tests/e2e/helpers/actions.ts

/**
 * Reusable test actions — common UI operations used across spec files.
 *
 * All actions use browser.execute() for DOM queries with fallback selectors
 * to support both Tauri and Electrobun UIs (WebKitGTK reliability pattern).
 */

import { browser } from '@wdio/globals';
import * as S from './selectors.ts';

/**
 * Wait for a TCP port to accept connections. Used by CDP-based E2E configs
 * to wait for the debugging port before connecting WebDriverIO.
 *
 * Polls `http://localhost:{port}/json` (CDP discovery endpoint) every 500ms.
 */
export async function waitForPort(port: number, timeout: number): Promise<void> {
  const start = Date.now();
  while (Date.now() - start < timeout) {
    try {
      const res = await fetch(`http://localhost:${port}/json`);
      if (res.ok) return;
    } catch {
      // Port not ready yet — retry
    }
    await new Promise(r => setTimeout(r, 500));
  }
  throw new Error(`CDP port ${port} not ready after ${timeout}ms`);
}

/** Open settings panel via gear icon click */
export async function openSettings(): Promise<void> {
  // Try clicking settings button — may need multiple attempts on WebKitGTK
  await browser.execute(() => {
    const btn = document.querySelector('[data-testid="settings-btn"]')
      ?? document.querySelector('.sidebar-icon')
      ?? document.querySelector('.rail-btn');
    if (btn) (btn as HTMLElement).click();
  });
  await browser.pause(300);

  // Check if panel opened; if not, try keyboard shortcut (Ctrl+,)
  const opened = await browser.execute(() =>
    document.querySelector('.sidebar-panel, .settings-drawer, .settings-panel') !== null,
  );
  if (!opened) {
    await browser.keys(['Control', ',']);
    await browser.pause(300);
  }

  // Wait for either settings panel class (Tauri: .sidebar-panel, Electrobun: .settings-drawer)
  await browser.waitUntil(
    async () =>
      browser.execute(() =>
        document.querySelector('.sidebar-panel, .settings-drawer, .settings-panel') !== null,
      ) as Promise<boolean>,
    { timeout: 5_000 },
  );
}

/** Close settings panel */
export async function closeSettings(): Promise<void> {
  await browser.execute(() => {
    const btn = document.querySelector('.settings-close')
      ?? document.querySelector('.panel-close');
    if (btn) (btn as HTMLElement).click();
  });
  await browser.pause(400);
}

/** Switch to a settings category by index (0-based) */
export async function switchSettingsCategory(index: number): Promise<void> {
  await browser.execute((idx: number) => {
    // Tauri: .settings-sidebar .sidebar-item  |  Electrobun: .settings-tab or .cat-btn
    const tabs = document.querySelectorAll('.settings-sidebar .sidebar-item, .settings-tab, .cat-btn');
    if (tabs[idx]) (tabs[idx] as HTMLElement).click();
  }, index);
  await browser.pause(300);
}

/** Switch active group by clicking the nth group button (0-based) */
export async function switchGroup(index: number): Promise<void> {
  await browser.execute((idx: number) => {
    const groups = document.querySelectorAll('.group-btn:not(.add-group-btn)');
    if (groups[idx]) (groups[idx] as HTMLElement).click();
  }, index);
  await browser.pause(300);
}

/** Type text into the agent prompt input */
export async function sendPrompt(text: string): Promise<void> {
  const textarea = await browser.$(S.CHAT_INPUT_TEXTAREA);
  if (await textarea.isExisting()) {
    await textarea.setValue(text);
    return;
  }
  const input = await browser.$(S.CHAT_INPUT_ALT);
  if (await input.isExisting()) {
    await input.setValue(text);
  }
}

/** Open command palette via Ctrl+K */
export async function openCommandPalette(): Promise<void> {
  await browser.keys(['Control', 'k']);
  await browser.pause(400);
}

/** Close command palette via Escape */
export async function closeCommandPalette(): Promise<void> {
  await browser.keys('Escape');
  await browser.pause(300);
}

/** Open search overlay via Ctrl+Shift+F */
export async function openSearch(): Promise<void> {
  await browser.keys(['Control', 'Shift', 'f']);
  await browser.pause(400);
}

/** Close search overlay via Escape */
export async function closeSearch(): Promise<void> {
  await browser.keys('Escape');
  await browser.pause(300);
}

/** Add a new terminal tab by clicking the add button */
export async function addTerminalTab(): Promise<void> {
  await browser.execute(() => {
    const btn = document.querySelector('.tab-add-btn');
    if (btn) (btn as HTMLElement).click();
  });
  await browser.pause(500);
}

/** Click a project-level tab (model, docs, files, etc.) */
export async function clickProjectTab(tabName: string): Promise<void> {
  await browser.execute((name: string) => {
    // Tauri: .ptab  |  Electrobun: .project-tab or .tab-btn
    const tabs = document.querySelectorAll('.ptab, .project-tab, .tab-btn');
    for (const tab of tabs) {
      if ((tab as HTMLElement).textContent?.toLowerCase().includes(name.toLowerCase())) {
        (tab as HTMLElement).click();
        return;
      }
    }
  }, tabName);
  await browser.pause(300);
}

/** Wait until an element with given selector is displayed */
export async function waitForElement(selector: string, timeout = 5_000): Promise<void> {
  const el = await browser.$(selector);
  await el.waitForDisplayed({ timeout });
}

/** Check if an element exists and is displayed (safe for optional elements) */
export async function isVisible(selector: string): Promise<boolean> {
  return browser.execute((sel: string) => {
    const el = document.querySelector(sel);
    if (!el) return false;
    const style = getComputedStyle(el);
    return style.display !== 'none' && style.visibility !== 'hidden';
  }, selector);
}

/** Get the display CSS value for an element (for display-toggle awareness) */
export async function getDisplay(selector: string): Promise<string> {
  return browser.execute((sel: string) => {
    const el = document.querySelector(sel);
    if (!el) return 'not-found';
    return getComputedStyle(el).display;
  }, selector);
}

/** Open notification drawer by clicking bell */
export async function openNotifications(): Promise<void> {
  await browser.execute(() => {
    // Tauri: .bell-btn  |  Electrobun: .notif-btn
    const btn = document.querySelector('.notif-btn')
      ?? document.querySelector('.bell-btn')
      ?? document.querySelector('[data-testid="notification-bell"]');
    if (btn) (btn as HTMLElement).click();
  });
  await browser.pause(400);
}

/** Close notification drawer */
export async function closeNotifications(): Promise<void> {
  await browser.execute(() => {
    // Tauri: .notification-center .backdrop  |  Electrobun: .notif-backdrop
    const backdrop = document.querySelector('.notif-backdrop')
      ?? document.querySelector('.notification-center .backdrop');
    if (backdrop) (backdrop as HTMLElement).click();
  });
  await browser.pause(300);
}