Pmj:DdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z m Z ddlmZejeZdZdeZdZd Zed eDZed eDZd Zed eDZedeDZd;dZdd?dZ dZ!dZ"d>d@d!Z#dAdBd#Z$ed$fdCd'Z%edfdDd(Z&dEd*Z' dFdGd0Z(d1Z)d2Z*e Gd3d4Z+e Gd5d6Z,dHd8Z-edfdId9Z.edfdJd:Z/dS)KzHShared 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#*K|]\}}|D]}|VdSN.0names_names @/home/thesage/.hermes/hermes-agent/hermes_cli/browser_connect.py r(s4ZZHE1TYZZD4ZZZZZZZc#*K|]\}}|D]}|VdSrr)rrgrouppartss rrr)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 rrrKs4VV(%PUVVVVVVVVVr c#*K|]\}}|D]}|VdSrr)rrpathspaths rrrLs4ZZhaTYZZDTZZZZZZZr 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 rr5z(get_chrome_debug_candidates..addSs  FW%%bg&6&6t&<&<==   RW^^D%9%9  F$ r basestuple[str | None, ...]install_groups?tuple[tuple[tuple[str, ...], tuple[tuple[str, ...], ...]], ...]c ~|D]8\}}td|D]"}|D]}tj|g|R#9dSr)filter posixpathjoin)r9r;rr"baser#r5s radd_windows_install_pathsz>get_chrome_debug_candidates..add_windows_install_paths\s{' 6 6HAutU++ 6 6"66EC t4e4445555 6 6 6 6r DarwinWindows ProgramFileszProgramFiles(x86) LOCALAPPDATA)z/mnt/c/Program Filesz/mnt/c/Program Files (x86))r'r-r*r.)r9r:r;r<r*r.) set _DARWIN_APPSr0environget_WINDOWS_BROWSER_GROUPSshutilwhichr>r'r@_LINUX_BROWSER_GROUPS)r(rBapp install_basesr install_partsrrAr#r&r'r5r7r8s @@@rget_chrome_debug_candidatesrROsJUUD 6 6 6 6 6 6  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://http://>wsshttpsiPF>wsraz/devtools/browser/r[Thttprb)rdra>rfrb/z /json/versionz/jsonstatusi,)socketurllib.request urllib.parser_rUscheme ValueErrorr' startswithhostnamecreate_connectionOSErrorrJnetlocrstriprequesturlopengetattr Exception) rZr[rjurllibr_parsedrUrmrootproberesps 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 ) 127.0.0.1z[::1])r::1r-cTtD]}d|d|}t||r|cS dS)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. r`:reN)_LOOPBACK_PROBE_HOSTSr~)rUr[hostrZs rdiscover_local_cdp_urlrsP&%%%t%% !#w 7 7 7 JJJ  4r ?cddl}tD]G} |||f|5 ddddS#1swxYwY8#t$rYDwxYwdS)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". rNreTF)rj_LOOPBACK_SOCKET_HOSTSrqrr)rUr[rjrs rlocal_port_in_usersMMM& ))4,)HH                        H  5s-A8 A< A< A AA preferredattemptscddl}t|dz|dz|zD]}d}|jdf|jdffD]\}} |||j5}||j|jd|||fdddn #1swxYwYr#t$rd}YnwxYw|r|cS|dzS)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). rNTrrF) rjrangeAF_INETAF_INET6 SOCK_STREAM setsockopt SOL_SOCKET SO_REUSEADDRbindrr)rrrjrUbindablefamilyrsocks rfind_free_debug_portrsJMMMi!mY]X%=>>  $nk:V_e>,$OOF$5v7JANNNIItTl+++,,,,,,,,,,,,,,,       KKK  q=s5B&9B B&B B&!B "B&& B65B6c|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(r7argvdata_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)rwr)r(flagss r_detach_kwargsr sZ #T** J 2A 6 6.:: E(- 4OU # #"4r @皙?procsubprocess.Popenintervalc$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. g?rereadyNexitedstarting)time monotonicrminpollsleep)rrUr[rdeadlines r%_wait_for_browser_debug_ready_or_exitrs~')H .  X % % "$Hc0B0B C C C 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 rrr3sL99KKKJJJ!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]rr*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) rrrr0r'basenamerr splitlinesstrip)selfattemptrs rhintzChromeDebugLaunch.hintJs}  G}((W-?1-D-Dw''7722222 }  G}((W-@(w''77FF*5577;AACCFFtr N)r*r-) rrrrrrrlistrpropertyrrr rrr=soH$)E$$?$?$?H???? Xr rr'c  t|d5}|}dddn #1swxYwY|t dddS#t $rYdSwxYw)Nrbzutf-8replace)errorsr)openread_STDERR_TAIL_LIMITdecoderrr)r'fhdatas r_read_stderr_tailr_s $   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(rrRloggerinforTr0makedirsr'r@_LAUNCH_STDERR_LOGrrPopenrXDEVNULLrrxrr4rrwrrrrrwarning) rUr(resultr7r stderr_path candidate stderr_filerexcrrs rlaunch_chrome_debugrhs (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_debugrs tV , , 55r )r(r)r*r+)r*r))rUrVr*r+)rY)rZr)r[r\r*r])rUrVr[r\r*r-)r)rUrVr[r\r*r])rrVrrVr*rV)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])0r __future__rloggingr0rr?rrLrr dataclassesrrhermes_constantsr getLoggerrrDEFAULT_BROWSER_CDP_PORTDEFAULT_BROWSER_CDP_URLrHrKtuple_WINDOWS_BIN_NAMES_WINDOWS_INSTALL_PARTSrN_LINUX_BIN_NAMES_LINUX_INSTALL_PATHSrRrTrXr~rrrrrrrrrrrrrrrrr rrsBNN""""""   ((((((((,,,,,,  8 $ $ H.FHH UZZ0GZZZZZ``5L`````@5VV.CVVVVVuZZ2GZZZZZ2222j3333!!!!!P/-      &+CTV4-E[_$5555 4)    B)t;;;;;|)AW[6666666r