Function getSession

src/tools/browser/session.ts:93–140

()

 * Calls are coalesced — concurrent first-time calls share one launch.
 */
export async function getSession(): Promise<BrowserSession> {
  if (session) return session;
  if (initInFlight) return initInFlight;

  initInFlight = (async () => {
    const playwright = await importPlaywright();
    const cdpUrl = resolveBrowserCdpUrl();

    let browser: Browser, context: BrowserContext, page: Page, attached = false;
    if (cdpUrl) {
      // ATTACH to an already-running browser (the user's own, with real logins). Reuse
      // its existing default context + an open tab so cookies/sessions are intact; only
      // open a fresh tab if none exist. We never create our own isolated context here —
      // that would defeat the point (a blank, logged-OUT session).
      browser = await playwright.chromium.connectOverCDP(cdpUrl);
      context = browser.contexts()[0] ?? (await browser.newContext());
      const open = (context.pages() as Page[]).find((p: Page) => !p.isClosed?.());
      page = open ?? (await context.newPage());
      attached = true;
      logger.info('Browser session ATTACHED over CDP', { cdpUrl });
    } else {
      const headed = process.env.QODEX_BROWSER_HEADED === '1';
      browser = await playwright.chromium.launch({
        headless: !headed,
        // --disable-blink-features prevents the "Chrome is being controlled by
        // automated test software" infobar from interfering with element positions.
        args: ['--disable-blink-features=AutomationControlled'],
      });
      context = await browser.newContext({
        viewport: { width: 1280, height: 800 },
        userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 QodeX/0.7',
      });
      page = await context.newPage();
      logger.info('Browser session launched', { headed });
    }

    const s: BrowserSession = { browser, context, page, attached, consoleBuffer: [], requestBuffer: [], errorBuffer: [] };
    wireSessionListeners(s, page);
    session = s;
    return s;
  })();

  try {
    return await initInFlight;
  } finally {
    initInFlight = null;
  }
}

/** Install the console/pageerror/network listeners that fill the read buffers. Tools
 *  read from these rather than installing per-call listeners (avoids missing events). */