prismcast 1.10.1 → 1.10.3

package/dist/browser/tabNetworkObserver.js

@@ -0,0 +1,140 @@
+import { LOG } from "../utils/index.js";
+// Default target filter: attach to every target except the browser-level one. The browser target emits no Network events relevant to a tab consumer, and
+// attaching to it pollutes the session set. Defining the default at module scope makes it shareable across calls and trivially testable.
+const defaultTargetFilter = (info) => info.type !== "browser";
+/**
+ * Installs a tab-wide network observer on the given page. The returned handle delivers every response observed across every target accepted by the targetFilter
+ * predicate (top page, iframes including OOPIFs, workers, service workers by default) to the supplied callback. Disposal is the caller's responsibility; the
+ * returned handle supports both an explicit dispose() call and the "using" keyword via Symbol.dispose.
+ *
+ * Returns null when the page is already closed, the root CDP session could not be created, or the puppeteer Connection backing the session is not available
+ * (e.g., the session detached during construction).
+ *
+ * @param page - The puppeteer page to observe.
+ * @param options - Observer options including the response callback and optional target-type predicate.
+ * @returns The observer handle, or null if installation failed.
+ */
+export async function observeTabResponses(page, options) {
+    if (page.isClosed()) {
+        return null;
+    }
+    let rootSession;
+    try {
+        rootSession = await page.createCDPSession();
+    }
+    catch (error) {
+        LOG.debug("browser:tabObserver", "Failed to create root CDP session: %s.", String(error));
+        return null;
+    }
+    // Connection lookup. With flatten=true, child sessions multiplex onto the parent connection and are reachable by sessionId via connection.session(). Puppeteer
+    // types CDPSession.connection() as `Connection | undefined`; the undefined case indicates the session has been detached or is otherwise unusable. We bail out
+    // cleanly rather than risking a TypeError on first child attach.
+    const connection = rootSession.connection();
+    if (!connection) {
+        LOG.debug("browser:tabObserver", "Root CDP session has no connection - aborting observer install.");
+        try {
+            await rootSession.detach();
+        }
+        catch (_error) {
+            // Cleanup best-effort.
+        }
+        return null;
+    }
+    const targetFilter = options.targetFilter ?? defaultTargetFilter;
+    // Track every session we attach to so disposal can tear them all down deterministically. The root session is included so it is cleaned up alongside children
+    // by one code path. A Set is used because the same session is never registered twice (sessionIds are unique per connection) but membership tests are needed
+    // during detach handling.
+    const sessions = new Set([rootSession]);
+    let disposed = false;
+    // Installs Network domain + response listener + recursive auto-attach on a freshly-attached session. Called for the root session synchronously below and for
+    // every child target as it attaches. Order matters: the Target.attachedToTarget listener has to be registered before setAutoAttach is sent, because
+    // setAutoAttach retroactively fires attachedToTarget for currently-attached children and we cannot miss those events. The Network.responseReceived and
+    // Target.detachedFromTarget listeners are insensitive to ordering relative to setAutoAttach; only the attach listener carries the retroactive-fire constraint.
+    const attachToSession = async (session, sessionId) => {
+        if (disposed) {
+            return;
+        }
+        sessions.add(session);
+        // Listen for responses on this session. The handler captures sessionId by closure so the consumer can identify the originating target.
+        session.on("Network.responseReceived", (params) => {
+            if (disposed) {
+                return;
+            }
+            options.onResponse({ headers: params.response.headers ?? {}, sessionId, url: params.response.url });
+        });
+        // Propagate the attach policy down this subtree. Without this, grandchildren of the root (iframes inside iframes, workers spawned by an OOPIF) would attach
+        // but their Target.attachedToTarget events would fire on the intermediate session, not the root - and we would not be listening there. Recursive setAutoAttach
+        // ensures every descendant session reaches our handler.
+        session.on("Target.attachedToTarget", (params) => { void onChildAttached(params); });
+        session.on("Target.detachedFromTarget", (params) => { onChildDetached(params); });
+        try {
+            await session.send("Target.setAutoAttach", { autoAttach: true, flatten: true, waitForDebuggerOnStart: false });
+            await session.send("Network.enable");
+            LOG.debug("browser:tabObserver", "Attached to session %s.", sessionId || "<root>");
+        }
+        catch (error) {
+            // Session may have detached between attach and our init - benign during page navigations and shutdown. Logging at debug rather than warn because the
+            // observer's job is to be resilient to lifecycle churn, not to alert on every churn event.
+            LOG.debug("browser:tabObserver", "Setup failed for session %s: %s.", sessionId || "<root>", String(error));
+        }
+    };
+    // Handler for Target.attachedToTarget. Resolves the freshly-attached sessionId to a CDPSession via the parent connection, applies the target-type predicate,
+    // and forwards to attachToSession. The filter is the consumer's policy lever; the default skips only the browser-level target.
+    const onChildAttached = async (params) => {
+        if (disposed) {
+            return;
+        }
+        if (!targetFilter({ type: params.targetInfo.type })) {
+            return;
+        }
+        const childSession = connection.session(params.sessionId);
+        if (!childSession) {
+            // Race: the child detached between the attach event and our lookup. Not actionable.
+            return;
+        }
+        await attachToSession(childSession, params.sessionId);
+    };
+    // Handler for Target.detachedFromTarget. Removes the detached session from tracking and clears its listeners. We do not call detach() on the session here -
+    // Chrome has already torn down the underlying target, and an explicit detach would race with the framework's internal cleanup. removeAllListeners is sufficient
+    // because we no longer want events from this session and the session object will be garbage-collected once the framework releases it.
+    const onChildDetached = (params) => {
+        if (disposed) {
+            return;
+        }
+        const childSession = connection.session(params.sessionId);
+        if (!childSession) {
+            return;
+        }
+        sessions.delete(childSession);
+        childSession.removeAllListeners("Network.responseReceived");
+        childSession.removeAllListeners("Target.attachedToTarget");
+        childSession.removeAllListeners("Target.detachedFromTarget");
+        LOG.debug("browser:tabObserver", "Detached from session %s.", params.sessionId);
+    };
+    // Install on the root session. The empty sessionId is the CDP convention for "root" - flattened child sessions get real sessionIds. Doing this synchronously
+    // before returning the handle means by the time the caller awaits the returned promise, all currently-attached children have already fired their retroactive
+    // Target.attachedToTarget events and been onboarded.
+    await attachToSession(rootSession, "");
+    const dispose = () => {
+        if (disposed) {
+            return;
+        }
+        disposed = true;
+        for (const session of sessions) {
+            try {
+                session.removeAllListeners("Network.responseReceived");
+                session.removeAllListeners("Target.attachedToTarget");
+                session.removeAllListeners("Target.detachedFromTarget");
+                void session.send("Network.disable").catch(() => { });
+                void session.detach().catch(() => { });
+            }
+            catch (_error) {
+                // Disposal is best-effort; a failed session teardown does not block teardown of the others. The Set iteration continues regardless.
+            }
+        }
+        sessions.clear();
+        LOG.debug("browser:tabObserver", "Tab network observer disposed.");
+    };
+    return { dispose, [Symbol.dispose]: dispose };
+}
+//# sourceMappingURL=tabNetworkObserver.js.map

package/dist/browser/tabNetworkObserver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabNetworkObserver.js","sourceRoot":"","sources":["../../src/browser/tabNetworkObserver.ts"],"names":[],"mappings":"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"}

package/dist/browser/tuning/hbo.js

@@ -1,16 +1,17 @@
 import { LOG, evaluateWithAbort, formatError } from "../../utils/index.js";
 import { CONFIG } from "../../config/index.js";
 import { logAvailableChannels } from "./shared.js";
-// Base URL for HBO Max watch page navigation and tab URL construction.
+// Base URL for HBO Max watch page navigation. Used to build full watch URLs by concatenating with the relative /channel/watch/<uuid>/<uuid> path read from the
+// rail. Kept as a separate constant from HBO_CHANNELS_URL so the two roles (path-concatenation base vs. landing-URL constant) stay distinct.
 const HBO_MAX_BASE_URL = "https://play.hbomax.com";
+// The /channels hub URL where HBO Max surfaces all live linear channels. PrismCast lands here directly via provider.guideUrl rather than chasing brand-page links
+// out of the homepage menu - HBO's site restructure (late 2025/early 2026) consolidated brand tabs into the /channels hub, deprecating the previous menu-bar
+// driven navigation entirely. This is now the single landing URL for both tuning and discovery.
+const HBO_CHANNELS_URL = "https://play.hbomax.com/channels";
 // Unified channel cache for HBO Max. Maps lowercased channel names (e.g., "hbo", "hbo hits") to their combined discovery and tuning data. Populated during the
 // first tune (when the strategy reads all channels from the channel rail) or the first discovery call. Both tuning (via resolveHboDirectUrl) and discovery (via
 // getCachedChannels / discoverHboChannels) read from this single cache. Cleared on browser disconnect via clearHboCache().
 const hboChannelCache = new Map();
-// Module-level cache for the HBO tab page URL discovered from the homepage menu bar. Cleared on browser disconnect (via clearHboCache) and inline when the
-// cached URL turns out to be stale (the channel rail is not found at the cached URL). Separate from the channel cache because it's a navigation target, not
-// channel data.
-let hboTabUrl = null;
 /**
  * Returns a cached HBO Max watch URL for the given channel selector, or null if no cached URL exists.
  * @param channelSelector - The channel selector string (e.g., "HBO", "HBO Hits").
@@ -32,12 +33,11 @@ function invalidateHboDirectUrl(channelSelector) {
     hboChannelCache.delete(channelSelector.toLowerCase());
 }
 /**
- * Clears all HBO caches: the unified channel cache and the tab URL. Called by clearChannelSelectionCaches() in the coordinator when the browser restarts, since
- * cached state may be stale in a new browser session.
+ * Clears the unified HBO channel cache. Called by clearChannelSelectionCaches() in the coordinator when the browser restarts, since cached watch URLs may be
+ * stale in a new browser session.
  */
 function clearHboCache() {
     hboChannelCache.clear();
-    hboTabUrl = null;
 }
 /**
  * Derives a DiscoveredChannel array from the unified channel cache. HBO does not create alias entries (resolveHboDirectUrl does exact-match only, no
@@ -60,43 +60,15 @@ function populateHboChannelCache(rawChannels) {
     }
 }
 /**
- * Reads the HBO tab URL from the homepage menu bar. The HBO brand page is linked via an `a[aria-label="H B O"]` element in the top navigation. The href attribute
- * contains a relative path like `/channel/c0d1f27a-...` which we combine with the base URL to form the full page URL.
- * @param page - The Puppeteer page object, expected to be on the HBO Max homepage.
- * @returns The full HBO tab page URL, or null if the tab link was not found.
- */
-async function readHboTabUrl(page) {
-    // Wait for the HBO tab link to appear in the menu bar. The homepage is a single-page application that renders the navigation dynamically after the initial HTML
-    // shell loads. Without this wait, the evaluate call below would run against an incomplete DOM and fail to find the tab link.
-    const HBO_TAB_SELECTOR = "a[aria-label=\"H B O\"]";
-    try {
-        await page.waitForSelector(HBO_TAB_SELECTOR, { timeout: 5000 });
-    }
-    catch {
-        return null;
-    }
-    const href = await evaluateWithAbort(page, (selector) => {
-        const tab = document.querySelector(selector);
-        if (!tab) {
-            return null;
-        }
-        return tab.getAttribute("href");
-    }, [HBO_TAB_SELECTOR]);
-    if (!href) {
-        return null;
-    }
-    return HBO_MAX_BASE_URL + href;
-}
-/**
- * Reads all channels from the HBO Channels tile rail on the HBO tab page. The rail section contains tiles for each live channel, each with a backup text
- * `<p aria-hidden="true">` element containing the channel name and an `<a>` with href pointing to the watch page. Returns all discovered channels so the caller
+ * Reads all channels from the "Everything You Love From HBO" rail on the /channels hub. The rail section contains tiles for each live linear channel, each with
+ * a `<p aria-hidden="true">` element containing the channel name and an `<a>` whose href points to the watch page. Returns all discovered channels so the caller
  * can populate the cache in bulk.
- * @param page - The Puppeteer page object, expected to be on the HBO tab page.
+ * @param page - The Puppeteer page object, expected to be on https://play.hbomax.com/channels.
  * @returns Object with `railFound` indicating whether the rail section was present, and `channels` containing all discovered channel names and watch paths.
  */
 async function readHboChannelRail(page) {
-    const HBO_RAIL_SELECTOR = "section[data-testid=\"hbo-page-rail-distribution-channels-us_rail\"]";
-    // Wait for the distribution channels rail section to appear. If it doesn't appear, the tab URL may be stale or the page structure changed.
+    const HBO_RAIL_SELECTOR = "section[data-testid=\"channels-hub-page-everything-you-love-hbo-rail-us_rail\"]";
+    // Wait for the HBO channel rail section to appear. If it doesn't appear, the page structure may have changed or the user's HBO Max subscription may not be active.
     try {
         await page.waitForSelector(HBO_RAIL_SELECTOR, { timeout: CONFIG.streaming.videoTimeout });
     }
@@ -142,74 +114,23 @@ async function readHboChannelRail(page) {
     return { channels, railFound: true };
 }
 /**
- * HBO grid strategy: discovers the HBO channels tab URL from the homepage menu bar, navigates to the tab page, reads the live channel rail for all channel
- * watch URLs, and navigates to the target channel's URL. All discovered channels are cached so that subsequent tunes to any HBO channel resolve via resolveDirectUrl
- * without loading the tab page.
+ * HBO grid strategy: reads the live channel rail on the /channels hub for all channel watch URLs, then navigates to the target channel's URL. All discovered
+ * channels are cached so subsequent tunes resolve via resolveDirectUrl without re-reading the rail.
  *
- * The strategy handles three navigations per tune:
- * 1. Homepage (already loaded by navigateToPage) -> read menu bar for tab URL (or use cache)
- * 2. Tab page -> read channel rail for all watch URLs
- * 3. Watch page -> video playback begins
+ * The strategy handles two phases per tune:
+ *   1. Channel rail (page is already on /channels, navigated by the coordinator via provider.guideUrl) -> read all watch URLs.
+ *   2. Watch page -> video playback begins.
  *
- * When the cached tab URL is stale (rail section not found), the strategy clears the cache, navigates back to the homepage, rediscovers the tab URL, and retries.
- * This fallback triggers at most once per tune attempt.
- * @param page - The Puppeteer page object, expected to be on the HBO Max homepage.
+ * @param page - The Puppeteer page object, expected to be on https://play.hbomax.com/channels.
  * @param profile - The resolved site profile with a non-null channelSelector (channel name, e.g., "HBO", "HBO Hits").
  * @returns Result object with success status and optional failure reason.
  */
 async function hboGridStrategy(page, profile) {
     const channelName = profile.channelSelector;
-    let usedCache = false;
-    // Phase 1: Navigate to the HBO tab page. Use cached URL if available, otherwise discover it from the homepage menu bar.
-    if (hboTabUrl) {
-        usedCache = true;
-        LOG.debug("tuning:hbo", "Using cached HBO tab URL: %s.", hboTabUrl);
-    }
-    else {
-        const discovered = await readHboTabUrl(page);
-        if (!discovered) {
-            return { reason: "HBO tab not found in homepage menu bar. HBO Max subscription may not be active.", success: false };
-        }
-        hboTabUrl = discovered;
-        LOG.debug("tuning:hbo", "Discovered HBO tab URL: %s.", hboTabUrl);
-    }
-    try {
-        await page.goto(hboTabUrl, { timeout: CONFIG.streaming.navigationTimeout, waitUntil: "load" });
-    }
-    catch (error) {
-        return { reason: "Failed to navigate to HBO tab page: " + formatError(error) + ".", success: false };
-    }
-    // Phase 2: Read the channel rail for all channel watch URLs.
-    let railResult = await readHboChannelRail(page);
-    // Fallback: if the rail was not found and we used a cached URL, the cache may be stale. Clear it, navigate back to the homepage, rediscover the tab URL, and retry.
-    if (!railResult.railFound && usedCache) {
-        LOG.debug("tuning:hbo", "HBO channel rail not found at cached URL. Rediscovering tab URL from homepage.");
-        hboTabUrl = null;
-        try {
-            await page.goto(HBO_MAX_BASE_URL, { timeout: CONFIG.streaming.navigationTimeout, waitUntil: "load" });
-        }
-        catch (error) {
-            return { reason: "Failed to navigate back to HBO Max homepage: " + formatError(error) + ".", success: false };
-        }
-        const rediscovered = await readHboTabUrl(page);
-        if (!rediscovered) {
-            return { reason: "HBO tab not found in homepage menu bar after cache invalidation.", success: false };
-        }
-        hboTabUrl = rediscovered;
-        LOG.debug("tuning:hbo", "Rediscovered HBO tab URL: %s.", hboTabUrl);
-        try {
-            await page.goto(hboTabUrl, { timeout: CONFIG.streaming.navigationTimeout, waitUntil: "load" });
-        }
-        catch (error) {
-            return { reason: "Failed to navigate to rediscovered HBO tab page: " + formatError(error) + ".", success: false };
-        }
-        railResult = await readHboChannelRail(page);
-        if (!railResult.railFound) {
-            return { reason: "HBO channel rail not found at rediscovered URL. Site structure may have changed.", success: false };
-        }
-    }
+    // Phase 1: Read the channel rail. The coordinator has already navigated the page to provider.guideUrl (the /channels hub), so we read the rail in place.
+    const railResult = await readHboChannelRail(page);
     if (!railResult.railFound) {
-        return { reason: "HBO channel rail not found on tab page.", success: false };
+        return { reason: "HBO channel rail not found on /channels. HBO Max may have restructured the page, or the subscription may not be active.", success: false };
     }
     // Populate the unified channel cache with all discovered channels. Always repopulate rather than skipping when the cache has entries, because invalidated
     // entries (deleted by invalidateHboDirectUrl) need to be restored with fresh watch URLs from the rail.
@@ -221,12 +142,12 @@ async function hboGridStrategy(page, profile) {
         logAvailableChannels({
             availableChannels: railResult.channels.map((ch) => ch.name).sort(),
             channelName,
-            guideUrl: "https://play.hbomax.com",
+            guideUrl: HBO_CHANNELS_URL,
             providerName: "HBO Max"
         });
         return { reason: "Channel " + channelName + " not found in HBO channel rail.", success: false };
     }
-    // Phase 3: Navigate to the watch URL to start playback.
+    // Phase 2: Navigate to the watch URL to start playback.
     LOG.debug("tuning:hbo", "Navigating to HBO Max watch URL for %s.", channelName);
     try {
         await page.goto(watchUrl, { timeout: CONFIG.streaming.navigationTimeout, waitUntil: "load" });
@@ -249,9 +170,8 @@ async function resolveHboDirectUrlAsync(channelSelector, _page) {
 }
 /**
  * Discovers all channels from the HBO Max channel rail. Returns cached results if the unified channel cache is populated from a prior tune or discovery call.
- * Otherwise, extracts the HBO tab URL from the homepage menu bar, navigates to the tab page, reads all channels from the distribution channels rail, and
- * populates the cache (unless empty, to allow retries on transient failures or missing HBO subscription).
- * @param page - The Puppeteer page object, already on the HBO Max homepage (navigated by the route handler).
+ * Otherwise reads the rail in place - the route handler has already navigated the page to provider.guideUrl (the /channels hub).
+ * @param page - The Puppeteer page object, already on https://play.hbomax.com/channels (navigated by the route handler).
  * @returns Array of discovered channels.
  */
 async function discoverHboChannels(page) {
@@ -259,19 +179,7 @@ async function discoverHboChannels(page) {
     if (hboChannelCache.size > 0) {
         return buildHboDiscoveredChannels();
     }
-    // Discover the HBO tab URL from the homepage menu bar.
-    const tabUrl = await readHboTabUrl(page);
-    if (!tabUrl) {
-        return [];
-    }
-    // Navigate to the HBO tab page.
-    try {
-        await page.goto(tabUrl, { timeout: CONFIG.streaming.navigationTimeout, waitUntil: "load" });
-    }
-    catch {
-        return [];
-    }
-    // Read the channel rail.
+    // Read the channel rail directly. The coordinator has already landed the page on /channels.
     const railResult = await readHboChannelRail(page);
     if (!railResult.railFound || (railResult.channels.length === 0)) {
         return [];
@@ -292,11 +200,11 @@ function getHboCachedChannels() {
 export const hboProvider = {
     discoverChannels: discoverHboChannels,
     getCachedChannels: getHboCachedChannels,
-    guideUrl: "https://play.hbomax.com",
+    guideUrl: HBO_CHANNELS_URL,
     label: "HBO Max",
-    // Profile for HBO Max live channels (play.hbomax.com). The HBO brand page contains a "Distribution Channels" rail showing all 5 live linear channels (HBO, HBO
-    // Hits, HBO Drama, HBO Comedy, HBO Movies) as tiles. The hboGrid strategy discovers the HBO tab URL from the homepage menu bar, navigates to it, then reads the
-    // channel rail for the watch URL matching the channelSelector name. Extends fullscreenApi for requestFullscreen() behavior inherited by the watch page.
+    // Profile for HBO Max live channels (play.hbomax.com/channels). The /channels hub contains an "Everything You Love From HBO" rail showing all 5 live linear
+    // channels (HBO, HBO Hits, HBO Drama, HBO Comedy, HBO Movies) as tiles. The hboGrid strategy reads the rail for the watch URL matching the channelSelector name
+    // and navigates to it. Extends fullscreenApi for requestFullscreen() behavior inherited by the watch page.
     profile: {
         category: "multiChannel",
         channelSelection: { strategy: "hboGrid" },

package/dist/browser/tuning/hbo.js.map

@@ -1 +1 @@
-{"version":3,"file":"hbo.js","sourceRoot":"","sources":["../../../src/browser/tuning/hbo.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hbo.js","sourceRoot":"","sources":["../../../src/browser/tuning/hbo.ts"],"names":[],"mappings":"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"}

package/dist/browser/tuning/hulu.js

@@ -554,6 +554,63 @@ async function releaseHeldPlaylist(page) {
         }
     });
 }
+/**
+ * Hulu surfaces a "Who's Watching?" profile-selector modal when an account has more than one profile, and re-prompts intermittently across sessions. The modal
+ * blocks all guide and channel UI until a profile is chosen, so PrismCast's tuning logic (#CHANNELS click, guide-grid binary search) never gets a chance to run.
+ * This helper detects the modal and clicks the first profile, restoring the normal /live page flow. Both the tuning path (guideGridStrategy) and the discovery
+ * path (discoverHuluChannels) call this immediately after navigation so they share one source of truth for the profile-selector workaround.
+ *
+ * Selection policy: always the first profile. We do not expose a configurable name because the typical PrismCast deployment has a single primary profile, and an
+ * operator who wants a different one can reorder profiles in Hulu's account settings. The selected profile name is captured in the audit log so the operator
+ * always knows which one was picked.
+ *
+ * The probe is cheap when no modal is present (one DOM evaluate) and best-effort when it is: any failure between detection and post-click navigation is logged
+ * and returns silently. The downstream #CHANNELS-wait timeout becomes the failure signal of last resort, so the existing error path stays intact.
+ * @param page - The Puppeteer page object.
+ */
+async function handleProfileSelectorIfPresent(page) {
+    const probe = await page.evaluate(() => {
+        const modal = document.querySelector("[data-testid=\"ProfileSelectorModal\"]");
+        if (!modal) {
+            return { present: false };
+        }
+        const tile = modal.querySelector("a.ProfileList__profile-item--modal");
+        if (!tile) {
+            return { present: true };
+        }
+        const rect = tile.getBoundingClientRect();
+        const ariaLabel = tile.getAttribute("aria-label") ?? "";
+        // "Switch profile to <name>" is the format Hulu emits today; we strip the prefix to surface the name in the log. A future relabel falls through to the
+        // literal "(unnamed)" rather than failing, so a Hulu UX rename never blocks tuning - it only loses the friendly name in the audit line.
+        const match = (/^Switch profile to (.+)$/).exec(ariaLabel);
+        return {
+            name: match ? match[1] : "(unnamed)",
+            present: true,
+            tile: { x: rect.left + (rect.width / 2), y: rect.top + (rect.height / 2) }
+        };
+    });
+    if (!probe.present) {
+        return;
+    }
+    if (!probe.tile) {
+        LOG.warn("Hulu prompted for profile selection but no profile tile was found. Tuning may fail; sign into Hulu in this browser to investigate.");
+        return;
+    }
+    LOG.info("Hulu prompted for profile selection. Defaulting to the first profile, \"%s\".", probe.name ?? "(unnamed)");
+    try {
+        // Coordinate-based click. Synthetic element.click() inside page.evaluate() does not reliably reach React's handlers on Hulu's SPA; the project's tuning code
+        // standardizes on page.mouse.click() with computed centers for this reason.
+        await page.mouse.click(probe.tile.x, probe.tile.y);
+        // Wait for the URL to leave /profiles, indicating the navigation triggered by the profile click has begun. The caller's downstream wait for #CHANNELS picks
+        // up the rest of the page settling; we only need to confirm the picker is out of the way before yielding back. The 5s timeout is a "post-click settle"
+        // budget - longer than a synchronous URL update needs, shorter than CONFIG.streaming.videoTimeout (which is sized for page-render waits); a real failure
+        // bubbles up via the catch and the downstream #CHANNELS-wait becomes the final timeout.
+        await page.waitForFunction(() => !window.location.pathname.startsWith("/profiles"), { timeout: 5000 });
+    }
+    catch (error) {
+        LOG.warn("Hulu profile selection click did not complete cleanly: %s.", formatError(error));
+    }
+}
 /**
  * Guide grid strategy: finds a channel in a virtualized, alphabetically sorted channel grid by scrolling the page to the target row using binary search, then
  * clicking the on-now program cell to open the playback overlay. This strategy works for sites like Hulu Live TV where the channel guide is rendered as a
@@ -566,13 +623,14 @@ async function releaseHeldPlaylist(page) {
  * 3. Linear scan fallback - safety net for raw call sign searches or any channel the binary search cannot find (~2.4 seconds)
  *
  * The selection process:
- * 1. If listSelector is provided, click the tab/button to reveal the channel list (e.g., a "Channels" tab)
- * 2. Wait for the channel grid rows to render in the DOM
- * 3. Check the unified cache for a row number direct-scroll shortcut
- * 4. Binary search: scroll to the midpoint row, read rendered channels (caching row numbers), check for exact match or infer local affiliate
- * 5. If binary search fails, linear scan from top to bottom as a universal fallback
- * 6. Click the on-now program cell (`.LiveGuideProgram--first`) in the target channel's row to open the playback overlay
- * 7. If playSelector is provided, wait for and click the play button to start live playback
+ * 1. Clear any "Who's Watching?" profile-selector modal that intercepts before guide interaction (see handleProfileSelectorIfPresent)
+ * 2. If listSelector is provided, click the tab/button to reveal the channel list (e.g., a "Channels" tab)
+ * 3. Wait for the channel grid rows to render in the DOM
+ * 4. Check the unified cache for a row number direct-scroll shortcut
+ * 5. Binary search: scroll to the midpoint row, read rendered channels (caching row numbers), check for exact match or infer local affiliate
+ * 6. If binary search fails, linear scan from top to bottom as a universal fallback
+ * 7. Click the on-now program cell (`.LiveGuideProgram--first`) in the target channel's row to open the playback overlay
+ * 8. If playSelector is provided, wait for and click the play button to start live playback
  * @param page - The Puppeteer page object.
  * @param profile - The resolved site profile with a non-null channelSelector (channel name) and channelSelection config.
  * @returns Result object with success status and optional failure reason.
@@ -580,6 +638,9 @@ async function releaseHeldPlaylist(page) {
 async function guideGridStrategy(page, profile) {
     const { channelSelection, channelSelector: channelName } = profile;
     const { listSelector, playSelector } = channelSelection;
+    // Clear the "Who's Watching?" profile-selector modal before any guide interaction. Hulu prompts for profile selection intermittently across sessions; without
+    // this step, all downstream selectors (#CHANNELS, live-guide-row) fail because the picker overlay blocks them.
+    await handleProfileSelectorIfPresent(page);
     // Ensure the guide is open and on the correct tab. We wait for the tab button to become VISIBLE (not just present in the DOM) because the guide overlay may exist
     // in the DOM structure while still hidden during page initialization or animation. Clicking a hidden button dispatches a DOM event but has no visual effect - the
     // guide remains hidden and the virtualizer never populates rows. We use $eval for the click because overlapping elements (spinners, overlays) can intercept
@@ -1357,6 +1418,8 @@ async function discoverHuluChannels(page) {
     catch {
         return [];
     }
+    // Clear the "Who's Watching?" profile-selector modal before any guide interaction (same logic guideGridStrategy uses on the tuning path).
+    await handleProfileSelectorIfPresent(page);
     // Click the Channels tab to reveal the channel list and trigger full API expansion. Matches the tuning path's retry logic - if guide rows don't appear after
     // the first tab click, retry once with a longer delay in case the first click fired during a transitional state before the guide was fully interactive.
     const listSelector = "#CHANNELS";