+ lHj4RaR:t70tRt^RIt^RIt^RIt^RIt^RIt^RIt^RIt^RI t ^RI t ^RI H t ^RI Ht^RIHtHtHt^RIHt]P*!]4tRtR] R2tR tR tR t/t]^k] P<!4t] !R R 44t RRlt!RRlt"RRlt#RRlt$RRlt%Rt&]PN!^R7RRl4t(RRlt)RRlt*R;R R!llt+R"R#lt,RBBc:V^8dQhR\\,/#r )rr)rs"rrr@s ] ] ]rc\PR8Xd\PR4R#\PP RR4p^RIHpV!V4p\P!RVR 7;'g\R \44R4# \d!p\PRT4Rp?LaRp?ii;i) zReturn the lightpanda executable, or None. Order: PATH (with agent-browser's Homebrew/managed-node fallbacks), then installer/agent-browser locations, then ``$HERMES_HOME/bin``. No Windows build.ntzLightpanda has no Windows buildNPATH)_merge_browser_pathz"browser PATH merge unavailable: %sr9pathc3"TFTqP4'gK\P!V\P4'gKG\ V4xKV R#5ir!)is_fileosaccessX_OKr).0cs& r )find_lightpanda_binary..Ms3U+Ayy{ryyBGG?TQ+sA(A A) rPnamerArBenvirongettools.browser_tool_installrKr@shutilwhichnextrE)path_envrKrDs rfind_lightpanda_binaryr_@s ww$ 67zz~~fb)H>B&x0 << 8 4 ] ]U)+UW[9]] > 91==>sB C"B==Cc$V^8dQhR\/#r r*)rs"rrrPs**#*rcv\P!\P\P4;_uu_4pVP\P\P ^4VP R4\VP4^,4uuRRR4# +'giR#;i)N) 127.0.0.1) socketAF_INET SOCK_STREAM setsockopt SOL_SOCKET SO_REUSEADDRbindr* getsockname)socks r_pick_free_loopback_portroPsm v~~v'9'9 : :d ))6+>+>B "#4##%a() ; : : :s A B'' B8 c$V^8dQhR\/#r r)rs"rrrWsDrc^RIHp\V!44R, R, R, pVPRRR7V#)rer;cachez browser-user9Tparentsexist_ok)r>r<rmkdir)r<rMs r _state_dirrwWs60 ! "W ,} <| KDJJtdJ+ Krc$V^8dQhR\/#r r)rs"rrr^s   rcN\4R, pVPRRR7V#)aHFilesystem HTTP cache shared by every Lightpanda this Hermes spawns. Shared rather than per-session so a cached asset survives session churn. Lightpanda holds it in sqlite (WAL) with a best-effort write path, and ``--http-cache-entry-limit`` (upstream default 1000, not passed here) bounds it without Hermes managing eviction. z http-cacheTrs)rwrvrLs r_http_cache_dirrz^s% <, &DJJtdJ+ Krz--http-cache-dir)maxsizec0V^8dQhR\R\/#)r binaryr)rr)rs"rrrosrc .\P!VR.RRRRR\PRR7p\VP;'gRVP ;'gR,9# \ d"p\PR T4R p?R#R p?ii;i) aKTrue if ``lightpanda serve`` accepts ``--http-cache-dir``. The flag landed upstream in 0.3.x; older binaries fatally reject it ("unknown argument"), which would break every launch. Probing ``help`` output keeps working across future flag additions without parsing versions, and the lru_cache keeps it once per binary per process. helpTutf-8replaceg@F)capture_outputtextencodingerrorstimeoutstdincheckrJz4lightpanda http-cache probe failed (%s); assuming noN) r+runDEVNULL_HTTP_CACHE_FLAGstdoutstderrr@rArB)r}r"rDs& r_binary_supports_http_cacherns ~~ V dWYX[$$    T[[%6%6B4;;;L;L"$MNN  KQOs$AA(A( A(( B3BBc0V^8dQhR\R\/#r r'r)rr)rs"rrrs11s1t1rc*\4V R2, #).json)rwr's&r _record_pathrs <\N%0 00rc$V^8dQhR\/#r )dict)rs"rrrs!!d!rc^RIHpV!4# \d?p\P RT4\ P P4uRp?#Rp?ii;i)re)_build_browser_envz/credential-scrubbed browser env unavailable: %sN)tools.browser_toolrr@rArBrPrXcopy)rrDs r _browser_envrsC!9!## ! FJzz  !s  A3A AAc<V^8dQhR\R\R\/#)r urlrr)rfloatr)rs"rrrs!C%$rc^RIHpV!WR7# \d"p\P RY4Rp?R#Rp?ii;i)re)is_browser_debug_readyrz%CDP readiness probe failed for %s: %sNF)hermes_cli.browser_connectrr@rArB)rrrrDs&& r _cdp_readyrs7E%c;;  .sPAXXZAs( () r read_bytes_STDERR_TAIL_LIMITdecodeOSErrorr]reversedr splitlines)rMrs& r_read_log_tailrstDz$$&(:':';<CCGT]C^ Phtzz|'>'>'@APRT UU s2A,, A;:A;cHV^8dQhR\PR\RR/#)r r"whatrN)r+r,r)rs"rrrs' 9 9Z%% 9S 9D 9rcVP4f&VP4VP^R7R#R# \dTP 4R#i;i \d"p\ P RY4Rp?R#Rp?ii;i)zRpoll -> terminate -> wait(5) -> kill; shared with the real-profile Chrome cleanup.Nrz%s terminate failed: %s)r# terminatewaitr@killrArB)r"rrDs&& r _terminatersp9 99;  NN   ! $     9 .889s2"A;AAAA B (BB cFV^8dQhR\R\\,/#r pidr)r*r)rs"rrrs#(3-rcV^RIHpVPV4# \dR#i;i)reProcessRegistryN)tools.process_registryr_safe_host_start_timer@)rrs& r_safe_start_timers-:44S99 s  ((c(V^8dQhR\RR/#)r rrNra)rs"rrrsLLCLDLrc6^RIHpVPWR7R#)zFTree-kill ``pid`` via ProcessRegistry, verifying its start time first.r)expected_startN)rr_terminate_host_pid)rrrs&& r _tree_killrs6'''Krc(V^8dQhR\RR/#)r serverrN)r )rs"rrrs]]*]t]rc RVPPRVPR\P!4RVP R\ P !4/p\\4VP R2, VRR7R# \d-p\PRTPT4Rp?R#Rp?ii;i) rr owner_pidr) started_atrN)indentz,could not write lightpanda record for %s: %s) r"rrrPgetpidr)timerrwr'rrArB)rrecordrDs& r _write_recordrsV[[__ffkk; F--|TYY[JF] *,F,?,?+@)FFW[\ ] CVEXEXZ[\\]s*B B?!B::B?block_private_networksFc V^8dQhR\R\R\\\,\\,3,/#)r r'rr)rrtuplerr )rs"rrrsJ..C.D.UZ[cdt[uwADxE\EVF.rc \4pV'g$\PR8XdR#RR\ R23#\ 4pVRRRR\ V4.p\ V4'd!V\\ \44., pV'dVPR 4\ \4V R 2, 4p\VR 4;_uu_4p\P!V\P\PV\4R R 7pRRR4RT 2p \$P&!4\(,p XP+4p T e)\-T4p RRT RT RT 'd RT 2 23#R 23#\/T 4'dMv\$P&!4T 8dA\1T4\-T4p T 'dRT R2MRp RRT R\3\(4 RT 23#\$P4!\64K\9YYu\;TP<44p\?T4\@;_uu_4T\BT&RRR4\DPGRTP<Y04TR3# +'giELk;i \ \P"3dpRRT RT 23uRp?#Rp?ii;i +'giL{;i)zStart ``lightpanda serve`` on a free loopback port; ``(server, None)`` once ``/json/version`` answers, else ``(None, error)``. stderr goes to ``/.log`` so a chatty child never blocks on a pipe.rHNzjbrowser.engine is 'lightpanda' but no lightpanda binary was found on PATH, ~/.lightpanda or ~/.local/bin. z , or set browser.engine to auto.servez--hostrdz--portz--block-private-networksz.logwbT)rrrenvstart_new_sessionz#Failed to launch lightpanda serve (z): rz"lightpanda serve exited with code z before z/json/version answeredz: rJz (last stderr line: )z lightpanda serve did not expose z/json/version within sz9Started lightpanda serve (pid %s, port %s) for session %s)Nzzbrowser.engine is 'lightpanda' but Lightpanda has no Windows build. Set browser.engine to auto (or run Hermes under WSL2).)$r_rPrWLIGHTPANDA_INSTALL_HINTrorrrrzr?rwopenr+r,rrrSubprocessErrorr monotonic_READY_TIMEOUT_Sr#rrrr*sleep_POLL_INTERVAL_Sr rrr _servers_lock_serversrAinfo)r'rr}rargvr(log_filer"rDrdeadlinerctaildetailrs&$ rlaunch_lightpandars$ %F  77d?[ [**A)BBbde e $ %D GX{Hc$i HD"6** !3'8#9:: ./:<\N$"778HJ (D ! !X##D 0B0B:K]K]+3[_aD" dV $C~~"22H  YY[ >!(+D=bT#NdtxgijnioepeBCC CAeBCC C c??  >> x ' t !(+D7;+D63F;C5@UVYZjVkUllmntmuvv v #$ l$BRSWS[S[B\ ]F& !'  KKKTXXW[j 4<7" ! ! Z// 0J:6(#aSIIIJ* sI9J AI0J9 J60 J ;JJJ3 J.(J3.J36 K cFV^8dQhR\R\\,/#r)rrr )rs"rrrs **S*X.>%?*rc\;_uu_4\PV4uuRRR4# +'giR#;ir!)rrrYrs&r get_serverrs ||L) s / A c(V^8dQhR\RR/#)r r'rNr)rs"rrrsNN#N$Nrc\;_uu_4\PVR4pRRR4Xe_VP4'dI\ VP P VP4VP P^R7\4V R2, PRR7Ve\PRV4R#R# +'giL;i \dAp\PRTPT4\TP 4Rp?LRp?ii;i \d\TP 4Li;i \ d!p\PRY4Rp?LRp?ii;i) zaStop the server for ``session_name`` (tree-kill, plain terminate on failure) and drop its record.Nz&lightpanda tree-kill failed for %s: %srrT missing_okz-could not remove lightpanda record for %s: %sz'Stopped lightpanda serve for session %s)rrpopr$rr"rr)r@rArBr'rrrwunlinkr)r'rrDs& rstop_lightpandars' lD1  foo// $ v{{(9(9 : $ KK  Q  'W <.. .66$6G > M!   $ LLA6CVCVXY Z v{{ # # $  $ v{{ # $ W DlVVWsMC *C&4D4$E C# & D116D,,D14 EE F%FFcV^8dQhRR/#)r rNr-)rs"rrrsGGTGrc\;_uu_4\\4pRRR4XFp\V4K R# +'giL';i \d"p\ P RY4Rp?KORp?ii;i)zEStop every server this process started. Idempotent; safe from atexit.Nz!lightpanda stop failed for %s: %s)rr7rrr@rArB)namesrWrDs rstop_all_lightpandarsZ X  G D !   G LL A A  A=A88A=c0V^8dQhR\R\/#r)r*r)rs"rrr s$rc&^RIpVPV4pRVP4P49dR#VP 4pRV9g\ V4V9dR#V'd^RIHpV!V4V8H#R# \dR#i;i)zJTrue only when ``pid`` is verifiably the ``lightpanda serve`` we recorded.Nr9Fr)get_process_start_timeT) psutilProcessrWlowercmdlinergateway.statusrr@)rrr)rr"rrs&&& r_is_lightpanda_processr s ~~c" tyy{002 2,,. ' !SYg%=  =)#.*< <   s"8B'B%B-B BBc$V^8dQhR\/#r ra)rs"rrr2s''#'rc\4p^RIHp^p\ TPR44EFpTPp\P!TPRR74p\T\4'g"\R\T4P 24hTP'R 4pT\(P*!48Xd0\,;_uu_4T\.9d RRR4KRRR4M!T'dT!\1T44'dKTP'R 4pT'd\3\1T4TP'R 4TP'R 44'dE\5\1T4TP'R 44T^, p\P7RY4TP%RR 7EK T# \d"p\PRT4Rp?^#Rp?ii;i \d^#i;i \"\3dTP%RR 7EKi;i +'giEL-;i \d!p\PRY4Rp?LRp?ii;i)zKill ``lightpanda serve`` processes whose owning Hermes is gone; return the count. A live owner is never touched; a PID is only signalled after psutil confirms it is still ``lightpanda serve`` on the recorded port.z$lightpanda state dir unavailable: %sN) _pid_existsz*.jsonz utf-8-sig)rzexpected a JSON object, got Trrrrr)z4Reaped orphaned lightpanda serve pid %s (session %s)z,orphan lightpanda kill failed for pid %s: %s)rwr@rArBrrsortedglobstemjsonloads read_text isinstancer ValueErrortyper.rrrYrPrrrr*rrr) state_dirrDrreaped record_pathr'rrrs rreap_orphaned_lightpandar2sL .FinnX67 "''  ZZ 5 5{ 5 KLFfd++ #?V @U@U?V!WXX, JJ{+  #8++;s9~66 jj )#c(FJJv4F S_H`aa U3s8VZZ %=>!  RTWf d+182 ME  ;Q? $    $  /    U KSTT Us` G G8AH  H5-AI  G5G00G58 HH #H21H25 I I4I//I4c8V^8dQh/^\9dR;R&#)r zdict[str, LightpandaServer]r__conditional_annotations__)rs"rrrs!@-, ',Ar)g?)r9)8r__doc__ functoolsrloggingrPr[rfr+ threadingr dataclassesrpathlibrtypingrrrutilsr getLoggerr.rALIGHTPANDA_INSTALL_URLrrrrrLockrr rEr_rorwrzr lru_cacherrrrrrrrrrrrrrrrrs@rr!s2   !((#   8 $X45K4LLvv*,,   ( (  ( ] * & Q *1!V 9L ].5.b* N,G$'r