`gj9dZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl m Z m Z ddl mZejeZdZdeZdZd Zed eDZed eDZd Zed eDZedeDZd%dZd&dZd'dZd(d)dZdZ dZ!d(d*dZ"d+d,dZ#edfd-dZ$edfd.dZ%d/dZ& d0 d1dZ'dZ(dZ)e GddZ*e Gd d!Z+d2d"Z,edf d3d#Z-edfd4d$Z.y)5zHShared helpers for attaching Hermes to a local Chromium-family CDP port.) annotationsN) dataclassfield)get_hermes_homei$zhttp://127.0.0.1:)z/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge))) chrome.exechrome))GoogleChrome Applicationr)) chromium.exechromium))Chromiumr r)rr r )) brave.exebrave)) BraveSoftwarez Brave-Browserr r)) msedge.exemsedge)) MicrosoftEdger rc#4K|]\}}|D]}|ywN.0names_names M/root/.hermes/venv/lib/python3.12/site-packages/hermes_cli/browser_connect.py r's!ZHE1TYZD4Z4Zc#4K|]\}}|D]}|ywrr)rrgrouppartss rrr(s"`EZ_`QVu`u`r )))z google-chromezgoogle-chrome-stable)z/opt/google/chrome/chromez/usr/bin/google-chromez/usr/bin/google-chrome-stable))zchromium-browserr )z/usr/bin/chromium-browserz/usr/bin/chromium))z brave-browserzbrave-browser-stabler)z/usr/bin/brave-browserz/usr/bin/brave-browser-stablez/usr/bin/bravez/snap/bin/bravez"/opt/brave.com/brave/brave-browserz/opt/brave.com/brave/bravez/opt/brave-bin/brave))zmicrosoft-edgezmicrosoft-edge-stabler)z/usr/bin/microsoft-edgez/usr/bin/microsoft-edge-stablez$/opt/microsoft/msedge/microsoft-edgez/opt/microsoft/msedge/msedgec#4K|]\}}|D]}|ywrrrs rrrJs!V(%PUVVVr c#4K|]\}}|D]}|ywrr)rrpathspaths rrrKs!ZhaTYZDTZTZr c  g t d fd d fd }|dk(rtD] } |  S|dk(rtjj dtjj dtjj df}t D]e\}}|D]} t j|td|D]/}|D](} tjj|g|*1g StD]6\}} |D]} t j|| D] }  |  8|dt  S) Nc|sytjjtjj|}|vstjj |syj |j |yr)osr'normcasenormpathisfileappendadd)r' normalized candidatesseens rr/z(get_chrome_debug_candidates..addRs` WW%%bgg&6&6t&<=  RWW^^D%9 $ c |D]C\}}td|D]/}|D](}tjj|g|*1Eyr)filterr*r'join)basesinstall_groupsrr"baser#r/s radd_windows_install_pathsz>get_chrome_debug_candidates..add_windows_install_paths[sW' 4HAutU+ 4"4E T2E234 4 4r3DarwinWindows ProgramFileszProgramFiles(x86) LOCALAPPDATA)z/mnt/c/Program Filesz/mnt/c/Program Files (x86))r' str | NonereturnNone)r7ztuple[str | None, ...]r8z?tuple[tuple[tuple[str, ...], tuple[tuple[str, ...], ...]], ...]r@rA) set _DARWIN_APPSr*environget_WINDOWS_BROWSER_GROUPSshutilwhichr5r'r6_LINUX_BROWSER_GROUPS)systemr:app install_basesr install_partsrr9r#r&r'r/r1r2s @@@rget_chrome_debug_candidatesrNNssJUD4%4W4 4 C H   JJNN> * JJNN. / JJNN> * %< 4 E= (FLL&' (t]3 4*4E T2E234 4 4 - u $D  T" # $ D I  TVmn r3c.ttdz S)Nz chrome-debug)strrrr3rchrome_debug_data_dirrQs  >1 22r3c*d|dtddgS)Nz--remote-debugging-port=z--user-data-dir=z--no-first-runz--no-default-browser-check)rQ)ports r_chrome_debug_argsrTs+ "4&) 0234$  r3c:ddl}ddl}ddlm}|d|vr|nd|} |jxs|j dvrdnd}|j d vrS|jjd r8|jsy |j|j|f| 5 dddy dddj|j |j }|dvs |jsy |d|jjd}|d|dfD]M} |jj!| | 5} dt#| ddcxkrdkrnn dddy dddOy #t $rYy wxYw#1swYnxYw#t$rYy wxYw#1swY7xYw#t$$rYwxYw)zFReturn True when ``url`` exposes a reachable Chrome DevTools endpoint.rN)urlparsez://http://>wsshttpsiPF>wsrXz/devtools/browser/timeoutThttprY)r[rX>r^rY/z /json/versionz/jsonstatusi,)socketurllib.request urllib.parserVrSscheme ValueErrorr' startswithhostnamecreate_connectionOSErrorrEnetlocrstriprequesturlopengetattr Exception) urlr]rburllibrVparsedrSrerootproberesps ris_browser_debug_readyrws% Uc\c ?F{{Pfmm7G&GsR}} %&++*@*@AU*V ))6??D*A7)S    7 + / / v}} MF &&fmmXS ( / / 4DF-(TF%.9 ''w'? 4'$#6<<    1           sk E8E3E&E3 F'FF F E#"E#&E/+E33 E?>E?F F FF) 127.0.0.1z[::1])rx::1cLtD]}d|d|}t||s|cSy)ayReturn the first loopback URL (IPv4 first, then IPv6) speaking CDP. Dual-stack discovery: when another application squats the IPv4 loopback on ``port``, a debug browser launched with ``--remote-debugging-port`` may bind only ``[::1]``. Probing both literals finds it either way. Returns ``None`` when neither loopback exposes a CDP discovery endpoint. rW:r\N)_LOOPBACK_PROBE_HOSTSrw)rSr]hostrqs rdiscover_local_cdp_urlr~s9&vQtf% !#w 7J r3cddl}tD]#} |j||f|5 dddyy#1swYnxYw4#t$rY?wxYw)aReturn True when either loopback accepts TCP on ``port``. Callers use this AFTER a failed CDP probe to distinguish "port is free, we can launch a browser on it" from "another application (IDE debugger, dev server) is squatting the port and a launch would fight it". rNr\TF)rb_LOOPBACK_SOCKET_HOSTSrirj)rSr]rbr}s rlocal_port_in_usersk& ))4,)H           s?2?; ? A  A  cddl}t|dz|dz|zD]}d}|jdf|jdffD]e\}} |j||j5}|j |j |jd|j||fdddg|s|cS|dzS#1swYxYw#t$rd}Y'wxYw)a|Return the first port after ``preferred`` bindable on both loopbacks. Used when ``preferred`` is occupied by a non-CDP application: rather than launching a browser into a bind conflict, pick a nearby free port. Falls back to ``preferred + 1`` if nothing binds (the launch will then fail with a clear browser-side error instead of silently doing nothing). rNTrxryF) rbrangeAF_INETAF_INET6 SOCK_STREAM setsockopt SOL_SOCKET SO_REUSEADDRbindrj) preferredattemptsrbrSbindablefamilyr}socks rfind_free_debug_portrsi!mY]X%=> $nnk:V__e,$OOF$5$5v7J7JANIItTl+,  K  q=,,   s*B<;B0B<0B9 5B<< C  C c|xstj}t|}|r@|dgt|}|dk(rt j |St j|S|dk(rt}d|d|dSy)Nrr<r;z7open -a "Google Chrome" --args --remote-debugging-port=z --user-data-dir="z+" --no-first-run --no-default-browser-check) platformrJrNrT subprocess list2cmdlineshlexr6rQ)rSrJr1argvdata_dirs rmanual_chrome_debug_commandrs  (x(F,V4J1 9 24 8906)0Cz&&t,YTXIYY (*EdVL (z)T V r3cj|dk7rddiSttddttddz}|rd|iSiS)Nr<start_new_sessionTDETACHED_PROCESSrCREATE_NEW_PROCESS_GROUP creationflags)ror)rJflagss r_detach_kwargsrsL #T** J 2A 6.: E(-OU #4"4r3c tj|z}tj|krVt|t|dry|j ytj |tj|krVy)a+Classify a launched browser as ready, exited, or still starting. We only need to wait long enough to catch the common failure mode where a candidate binary exists but exits immediately before exposing the CDP port. Slower browsers can still finish starting after this grace window. g?r\readyexitedstarting)time monotonicr~minpollsleep)procrSr]intervaldeadlines r%_wait_for_browser_debug_ready_or_exitrsk~~')H .. X % "$Hc0B C 99; " 8 .. X % r3zlaunch-stderr.logicBeZdZUdZded<ded<dZded<dZded <y) LaunchAttemptz/Outcome of one candidate-binary launch attempt.rPbinarystateNz int | None returncode stderr_tail)__name__ __module__ __qualname____doc____annotations__rrrr3rrr/s#9 K J!J !Kr3rcNeZdZUdZdZded<eeZded<e d dZ y ) ChromeDebugLaunchaLStructured result of ``launch_chrome_debug``. ``launched`` mirrors the legacy boolean contract: a launch command was executed and the browser is ready or still starting (it does NOT guarantee the CDP port ever opens). ``attempts`` carries per-candidate diagnostics so callers can explain *why* nothing came up. Fboollaunched)default_factoryzlist[LaunchAttempt]rc|jD]T}|jdk(s|jdk(s#tjj |j }|d|dcS|jD]w}|jdk(s|js tjj |j d|jjdjcSy)z>Best user-facing explanation for a failed/soft launch, if any.rruJ exited immediately without opening the debug port — an already-running z instance likely absorbed the launch (Chromium's single-instance behavior). Close ALL of its processes (including background/tray instances) and retry /browser connect.z& exited before the debug port opened: N) rrrr*r'basenamerr splitlinesstrip)selfattemptrs rhintzChromeDebugLaunch.hintFs}} G}}(W-?-?1-Dww''7fff22 }} G}}(W-@-@ww''788^**557;AACDF  r3N)r@r?) rrrrrrrlistrpropertyrrr3rrr9s5Hd$)$$?H!? r3rc t|d5}|j}dddt djddj S#1swY2xYw#t $rYywxYw)Nrbzutf-8replace)errorsr)openread_STDERR_TAIL_LIMITdecoderrj)r'fhdatas r_read_stderr_tailr[sq $  779D ''()000KQQSS   s' AA0AAA A('A(c "|xstj}t}t|}|stj d||St }tj|dtjj|t}|D]} t|d5}tj|gt|ftj |dt#|}dddtj d |t-d d|t/||} t+|| } |j&j)| | d k7r d|_|cSt-|d d| _t5|| _tj9d|| j2|| j6rd| j6nd|S#1swYxYw#t$$rH} |j&j)t+|dtj d || Yd} ~ zd} ~ wwxYw)uVLaunch a Chromium-family browser with remote debugging, with diagnostics. Tries each detected candidate binary in turn. A candidate that exits before the CDP port opens (crash, singleton forward to an existing instance, bad profile dir) is logged — with exit code and a stderr tail — and the next candidate is tried. zAbrowser debug launch: no Chromium-family binary found (system=%s)T)exist_okwb)stdoutstderrNz spawn-failed)rrz,browser debug launch: failed to spawn %s: %szIbrowser debug launch: spawned %s (pid=%s) with --remote-debugging-port=%dpidrrzAbrowser debug launch: %s exited (code=%s) before port %d opened%sz; stderr tail: r)rrJrrNloggerinforQr*makedirsr'r6_LAUNCH_STDERR_LOGrrPopenrTDEVNULLrrprr.rrorrrrrwarning) rSrJresultr1r stderr_path candidate stderr_filerexcrrs rlaunch_chrome_debugrds (x(F  F,V4J  WY_` $&HKK4('',,x);w' H "FOM$T<>/ < O     7>7J7Jog112 3PR  =$ L MI    OO " "= #X Y KKF SV W  s0 F= =F1F=1F: 6F== H=H  Hc.t||jSr)rr)rSrJs rtry_launch_chrome_debugrs tV , 5 55r3)rJrPr@ list[str])r@rP)rSintr@r)g?)rqrPr]floatr@r)rSrr]rr@r?)g?)rSrr]rr@r)rrrrr@r)rSrrJr?r@r?)rJrPr@dict)g@g?) rzsubprocess.PopenrSrr]rrrr@rP)r'rPr@rP)rSrrJr?r@r)rSrrJr?r@r)/r __future__rloggingr*rrrGrr dataclassesrrhermes_constantsr getLoggerrrDEFAULT_BROWSER_CDP_PORTDEFAULT_BROWSER_CDP_URLrCrFtuple_WINDOWS_BIN_NAMES_WINDOWS_INSTALL_PARTSrI_LINUX_BIN_NAMES_LINUX_INSTALL_PATHSrNrQrTrwr|rr~rrrrrrrrrrrrrr3rrsN"   (,   8 $ -.F-GH Z0GZZ`5L``@V.CVVZ2GZZ/d3!P/-  &+CTV4-E[_$5      4)    B)t; ;2<;;|)AW[6r3