Jj/dZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl m Z m Z ddl mZejeZdZdeZdZd Zed eDZed eDZd Zed eDZedeDZd2dZd3dZd4dZd5d6dZedfd7dZ d8d!Z! d9d:d'Z"d(Z#d)Z$e Gd*d+Z%e Gd,d-Z&d;d/Z'edfdzHShared helpers for attaching Hermes to a local Chromium-family CDP port.) annotationsN) dataclassfield)get_hermes_homei$http://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#*K|]\}}|D]}|VdSN.0names_names @/home/rurouni/.hermes/hermes-agent/hermes_cli/browser_connect.py r 's4ZZHE1TYZZD4ZZZZZZZc#*K|]\}}|D]}|VdSrr)rrgrouppartss rr r (s5``EZ_``QVu```````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#*K|]\}}|D]}|VdSrrrs rr r Js4VV(%PUVVVVVVVVVr!c#*K|]\}}|D]}|VdSrr)rrpathspaths rr r Ks4ZZhaTYZZDTZZZZZZZr!systemstrreturn list[str]c  g t d fd d fd }|d krtD] } | S|d krtjd tjdtjdf}t D]_\}}|D]} t j| td|D]'}|D]"} tj j |g|R#(` StD]7\}} |D]} t j| | D] }  | 8|dt  S)Nr( str | Noner+Nonec&|sdStjtj|}|vstj|sdS||dSr)osr(normcasenormpathisfileappendadd)r( normalized candidatesseens rr6z(get_chrome_debug_candidates..addRs  FW%%bg&6&6t&<&<==   RW^^D%9%9  F$ r!basestuple[str | None, ...]install_groups?tuple[tuple[tuple[str, ...], tuple[tuple[str, ...], ...]], ...]c |D]=\}}td|D]'}|D]"}tjj|g|R#(>dSr)filterr1r(join)r:r<rr#baser$r6s radd_windows_install_pathsz>get_chrome_debug_candidates..add_windows_install_paths[s{' 4 4HAutU++ 4 4"44EC T2E22233334 4 4 4r!DarwinWindows ProgramFileszProgramFiles(x86) LOCALAPPDATA)z/mnt/c/Program Filesz/mnt/c/Program Files (x86))r(r.r+r/)r:r;r<r=r+r/) set _DARWIN_APPSr1environget_WINDOWS_BROWSER_GROUPSshutilwhichr?r(r@_LINUX_BROWSER_GROUPS)r)rBapp install_basesr install_partsrrAr$r'r(r6r8r9s @@@rget_chrome_debug_candidatesrRNsJUUD444444  C CHHHH  JNN> * * JNN. / / JNN> * * %< 4 4 E= ( (FL&&''''t]33 4 4*44EC T2E22233334 4- u $ $D C T"" # # # #  D CIIII TVmnnn r!c>ttdz S)Nz chrome-debug)r*rrr!rchrome_debug_data_dirrTs   >1 2 22r!portintc2d|dtddgS)Nz--remote-debugging-port=z--user-data-dir=z--no-first-runz--no-default-browser-check)rT)rUs r_chrome_debug_argsrXs/)4))402244$  r!?urltimeoutfloatboolc$ddl}ddl}ddlm}|d|vr|nd|} |jp |jdvrdnd}n#t $rYd SwxYw|jd vrn|jd rT|j sd S | |j |f| 5 dddd S#1swxYwYn#t$rYd SwxYwddd |j|j}|dvs|j sd S|d|j d}|d|dfD]u} |j| | 5} dt#| ddcxkrdkrnn dddd Sdddn #1swxYwYf#t$$rYrwxYwd S)zFReturn True when ``url`` exposes a reachable Chrome DevTools endpoint.rN)urlparsez://zhttp://>wsshttpsiPF>wsr`z/devtools/browser/r[Thttpra)rcr`>rera/z /json/versionz/jsonstatusi,)socketurllib.request urllib.parser_rUscheme ValueErrorr( startswithhostnamecreate_connectionOSErrorrJnetlocrstriprequesturlopengetattr Exception) rZr[riurllibr_parsedrUrlrootproberesps ris_browser_debug_readyr}sMMM%%%%%% XUc\\cc ? ?F{Pfm7G&G&GssR uu} %%&+*@*@AU*V*V% 5 ))6?D*A7)SS                      55 7 + + / / v} M MF &&&fm&u ( ( ( ( / / 4 4D(((T...9 ''w'?? 4'$#66<<<<<<<<<                            H  5s9 AA7B0B$ B0$B((B0+B(,B00 B>=B>F9!E4 F( F4E8 8F;E8 <F F  F r.c|ptj}t|}|rF|dgt|}|dkrt j|nt j|S|dkrt}d|d|dSdS)NrrDrCz7open -a "Google Chrome" --args --remote-debugging-port=z --user-data-dir="z+" --no-first-run --no-default-browser-check) platformr)rRrX subprocess list2cmdlineshlexr@rT)rUr)r8argvdata_dirs rmanual_chrome_debug_commandrs  (x((F,V44JZ1 9 24 8 8906)0C0Cz&t,,,TXIYIYY (** Vd V V ( V V V 4r!dictc|dkrddiSttddttddz}|rd|iniS)NrDstart_new_sessionTDETACHED_PROCESSrCREATE_NEW_PROCESS_GROUP creationflags)rvr)r)flagss r_detach_kwargsrsZ #T** J 2A 6 6.:: E(- 4OU # #"4r!@皙?procsubprocess.Popenintervalc.d|}tj|z}tj|krbt|t|drdS|dStj|tj|kbdS)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. rg?rdreadyNexitedstarting)time monotonicr}minpollsleep)rrUr[rcdp_urldeadlines r%_wait_for_browser_debug_ready_or_exitrs)$((G~')H .  X % % !'3x3E3E F F F 7 99;; "8 8 .  X % % :r!zlaunch-stderr.logicDeZdZUdZded<ded<dZded<dZded <dS) LaunchAttemptz/Outcome of one candidate-binary launch attempt.r*binarystateNz int | None returncode stderr_tail)__name__ __module__ __qualname____doc____annotations__rrrr!rrrsL99KKKJJJ!J!!!!Kr!rc\eZdZUdZdZded<eeZded<e d d Z d S) 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. Fr]launched)default_factoryzlist[LaunchAttempt]attemptsr+r.c|jD]F}|jdkr9|jdkr.tj|j}|d|dcSG|jD]n}|jdkra|jrZtj|jd|jd cSodS)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) rrrr1r(basenamerr splitlinesstrip)selfattemptrs rhintzChromeDebugLaunch.hints}  G}((W-?1-D-Dw''7722222 }  G}((W-@(w''77FF*5577;AACCFFtr!N)r+r.) rrrrrrrlistrpropertyrrr!rrrsoH$)E$$?$?$?H???? Xr!rr(c  t|d5}|}dddn #1swxYwY|t dddS#t $rYdSwxYw)Nrbzutf-8replace)errorsr)openread_STDERR_TAIL_LIMITdecoderrq)r(fhdatas r_read_stderr_tailrs $   7799D               ''(()000KKQQSSS rrs,A53 A57A579A55 BBc x|ptj}t}t|}|std||St }tj|dtj |t}|D]} t|d5}tj|gt|ftj|dt#|}dddn #1swxYwYn\#t$$rO} |jt+|dtd || Yd} ~ d} ~ wwxYwtd |t-|d d|t/||} t+|| } |j| | d kr d|_|cSt-|d d| _t5|| _td|| j|| jr d| jnd|S)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)rr)rrRloggerinforTr1makedirsr(r@_LAUNCH_STDERR_LOGrrPopenrXDEVNULLrrwrr5rrvrrrrrwarning) rUr)resultr8r stderr_path candidate stderr_filerexcrrs rlaunch_chrome_debugrs (x((F  F,V44J  WY_``` $&&HK4((((',,x);<>>w''' H  "FOMMM$T<>>/ << O    7>7J R 3g1 3 3 3PR      Ms=!D1=C:. D:C> >DC> D EAEEc,t||jSr)rr)rUr)s rtry_launch_chrome_debugr\s tV , , 55r!)r)r*r+r,)r+r*)rUrVr+r,)rY)rZr*r[r\r+r])rUrVr)r.r+r.)r)r*r+r)rr) rrrUrVr[r\rr\r+r*)r(r*r+r*)rUrVr)r.r+r)rUrVr)r.r+r])*r __future__rloggingr1rrrLrr dataclassesrrhermes_constantsr getLoggerrrDEFAULT_BROWSER_CDP_PORTDEFAULT_BROWSER_CDP_URLrHrKtuple_WINDOWS_BIN_NAMES_WINDOWS_INSTALL_PARTSrN_LINUX_BIN_NAMES_LINUX_INSTALL_PATHSrRrTrXr}rrrrrrrrrrrr!rrsNN""""""   ((((((((,,,,,,  8 $ $ H.FHH UZZ0GZZZZZ``5L`````@5VV.CVVVVVuZZ2GZZZZZ////d3333!!!!!H-E[_$5555 2)    B)t;;;;;|)AW[6666666r!