Poi(dZddlmZmZmZddlZddlmZddlmZddl m Z ddl m Z m Z ddlmZdd lmZGd d ee ZdS) a. Browser Navigator Hub for Browser Operations This module provides the BrowserNavigator class that serves as a central orchestrator for all browser operations, hosting core browser management while providing access to specialized/scripted operations through primitive operations and executor methods. )OptionalDictAnyN)datetime)BrowserContext)PersistentBrowserBase)IntelligentPagePool ManagedPage)PrimitiveBrowserOps)llmc 6eZdZdZddededeffd Zdd eed efd Z e dd e dedefdZ fdZ dZd ee fdZd eefdZdd eed eeeffdZd ed eeeffdZdded eed eeeffdZxZS)BrowserNavigatoraI Central hub for all browser operations. The BrowserNavigator consolidates browser management and provides primitive operations for scraping and fingerprinting. It serves as the main entry point for all browser automation tasks while maintaining a shared browser context and page pool. Core Responsibilities: - Browser context lifecycle management (initialize, maintain, cleanup) - Page pool management and coordination - Providing factory methods for specialized operations - Exposing primitive/atomic operations for custom workflows  user_data_dirslowmo max_pagesct||||_d|_t dt d|t d|dt d|dS)a  Initialize the BrowserNavigator with full browser setup. Args: user_data_dir (str): Path to Firefox profile directory for persistence slowmo (int): Delay in milliseconds between browser actions (default: 500) Nu 🧭 BrowserNavigator configuredu📁 Profile directory: ⏱️ Slowmo delay: ms📄 Max pages: )super__init__r _page_poolprint)selfrrr __class__s :/home/byschii/byschiidev/penelope/lib/browser_navigator.pyrzBrowserNavigator.__init__$s ///"9= 1222 888999 1v111222 ,,,-----Npage_idreturncK|jstd|r5|jj|}|std|dn2|jdd{V}|std|S)z Helper method to get a managed page to use. Args: page_id (str, optional): Specific page ID to use, or None for any available page Returns: ManagedPage: The managed page to use Page pool not initializedzPage z not found) wait_timeoutNzNo pages available)r Exceptionpagesgetget_available_page)rr managed_pages r_get_page_to_usez!BrowserNavigator._get_page_to_use6s 9788 8  6?044W==L = ; ; ; ;<<< ="&!C!CQS!C!T!TTTTTTTL 6 4555rbrowser_contextc$K||}d|_||_||_d|_||_d|_|d{Vtdtd|dtd||S)a Create BrowserNavigator from an existing browser context. Args: browser_context (BrowserContext): Existing Playwright browser context slowmo (int): Delay in milliseconds between browser actions (default: 1000) max_pages (int): Maximum number of pages in the pool (default: 3) Returns: BrowserNavigator: Instance using the shared browser context external_contextNu7🧭 BrowserNavigator initialized from existing contextrrr) __new__rrr playwrightr-r_initialize_page_poolr)clsr-rrinstances rfrom_existing_contextz&BrowserNavigator.from_existing_contextOs;;s##"4 &"#2 ",,......... HIII 1v111222 ,,,---rcKtd{V|d{VdS)z-Initialize the browser context and page pool.N)r initializer2)rrs rr7zBrowserNavigator.initializeps]gg  """""""""((***********rcK|jstdt|j|j|_|jdd{Vt d|jddS)z9Initialize the page pool with the active browser context.z4Browser context must be initialized before page pool)r-r) initial_pagesNu✅ Page pool initialized with z max pages)r-r&r rrr7rrs rr2z&BrowserNavigator._initialize_page_poolxs# TRSS S- 0n    o((q(999999999 JJJJKKKKKrc|jS)z Get the current browser context.)r-r;s rget_browser_contextz$BrowserNavigator.get_browser_contexts ##rc|jS)zGet the current page pool.)rr;s r get_page_poolzBrowserNavigator.get_page_pools rcK|jsddiS td|pd|j|d{V}d|jd|jd|jj|jjt|jj d }td |j|S#t$r2}d t|}td |d|icYd}~Sd}~wwxYw) z Create a new page/tab in the browser. Args: page_id (str, optional): Custom page ID. If None, auto-generated ID will be used. Returns: Dict[str, Any]: Result containing page information errorr#u 🆕 Creating new page with ID: zauto-generatedNTPage 'z' created successfully)successr messageurlstate total_pagesu✅ Page created successfully: zFailed to create page: ❌ ) rr create_pager pagerErFvaluelenr'r&strrr r*resulte error_msgs rrIzBrowserNavigator.create_pages5 :89 9 ( RW5P@PRR S S S!%!'!>!>!>???09L#))++ + + + + + + +%g. "EGEEE"4?#899 F ?g?? @ @ @M ( ( (;3q66;;I $$$ % % %Y' ' ' ' ' ' ' (s#'B+A3B++ C'5'C"C'"C' descriptionc dKtj}||d{V} |d|d{Vt d|t d|jd{V}tj| d}t dtj ||}tj}||z } t d|j d |jd ||j|j|j d |j d ||| d |d{VS#t&$rw} t d| |t+| d{Vd||jt+| dcYd} ~ |d{VSd} ~ wwxYw#|d{VwxYw)ai Search for an object on the page based on description using vision AI. Args: description (str): Description of the object to search for page_id (str, optional): Specific page ID to use, or None for any available page Returns: Dict containing search result with bounding box and coordinates Nzsearching for object: u🔍 Searching for object: u📸 Taking screenshotzutf-8u🤖 Calling Gemini vision API)object_description image_base64u✅ Object found at center: z, bounding box: Txy) rCrUr bounding_boxcenter_xcenter_y tokens_used costs_usdduration_secondsu❌ Object search failed: F)rCrUr rA)rnowr+set_busyrrJ screenshotbase64 b64encodedecoder detect_bounding_boxes total_secondscenterr[r token_total cost_totalset_idler& set_errorrM) rrUr start_timer*screenshot_bytesscreenshot_base64rOend_timedurationrPs rdo_search_objectz!BrowserNavigator.do_search_objects\^^ !227;;;;;;;; . *''(N(N(NOO O O O O O O O = == > > > * + + +%1%6%A%A%C%CCCCCCC  & 01A B B I I' R R  2 3 3 3.#..F  |~~H :-<<>>H eeePVPcee f f f*'/ & 3"M#."M#.%1133#..00$,  .'')) ) ) ) ) ) ) ) )    2q22 3 3 3((Q00 0 0 0 0 0 0 0 *'/Q      '')) ) ) ) ) ) ) ) ) '')) ) ) ) ) ) ) ) )s1EF HAH +H,H HHH/)rr)N)r,r)__name__ __module__ __qualname____doc__rMintrrr r+ classmethodrr5r7r2r=r r?rrrIrTrs __classcell__)rs@rrrs  ..c.3.......$hsm{2.RUil[@+++++ L L L$Xn%=$$$$x(;< ( (# ($sCx. ( ( ( (D)(#)($sCx.)()()()(V<*<*#<* <*Y]^acf^fYg<*<*<*<*<*<*<*<*rr)rwtypingrrrrdrpatchright.async_apirlib.browser_baserlib.page_managementr r lib.browser_primitivesr r rrrrs'&&&&&&&&& 000000222222@@@@@@@@666666C*C*C*C*C**,AC*C*C*C*C*r