+ lHj.Rt^RIt^RIt^RIt^RIHtHt^RIH t ^RI H t ^RI Ht^RI Ht]P$!^R7RR l4tR R ltR"R R lltRRltRRltRR/RRlltR#RRlltRRltRRltRRltRRltR R!ltR#)$uPM-owned agent-browser / Chromium discovery, acquisition and readiness. Split out of ``tools/browser_tool.py``. Facade-owned state is read through ``_bt`` (``tools.browser_tool``, resolved per call) — no import cycle.N)agent_browser_runnable is_termux) origin_module)browser_tool_cdp)browser_tool_cloud) browser_tool_lightpanda_fallback)maxsizec>V^8dQhR\\R3,/#)return.)tuplestr)formats"?/home/ubuntu/.hermes/hermes-agent/tools/browser_tool_install.py __annotate__rs  eCHo caaRo\PPS4'd\P!S4M.p\ ;QJd.VV3RlV4FNK 5#!VV3RlV44# \d.pLCi;i)zbHomebrew versioned Node bin dirs (node@20, ...) that ``brew`` may not link into /opt/homebrew/bin.z/opt/homebrew/optc3<"TFqpVPR4'gKVR8wgK%\PP\PP SVR4;o4'gKmSxKs R#5i)nodebinN) startswithospathisdirjoin).0entrybin_dir homebrew_opts& r /_discover_homebrew_node_dirs..saE   F # (-  77==BGGLLue$LL M sA<A<AA<2 A<)rrrlistdirOSErrorr )entriesrrs @@r_discover_homebrew_node_dirsr$s{'L.0ggmmL.I.I"**\*r 555  s$A7A77 BBc:V^8dQhR\\,/#r r )listr )rs"rrr sCCd3iCrcF\4p.\4OVPO#)z;System PATH fallbacks for externally owned browser helpers.)_originr$_SANE_PATH_DIRS)_bts r_browser_candidate_path_dirsr, s# )C B ) + Bc.A.A BBrc0V^8dQhR\R\/#)r existing_pathr r )rs"rrr&s66s6C6rcT;'gRP\P4Uu.uFq'gK VNK pp.p\4FUpV'gK WB9gKWC9gK\PP V4'gKDVP V4KW \PPW2,4#uupi)zLPrepend browser-specific PATH fallbacks without reordering existing entries.)splitrpathsepr,rrappendr)r.p path_parts prefix_partsparts& r_merge_browser_pathr9&s+11r88DJD!!DJJ L,. 4D*t/GBGGMMZ^L_L_    %/ ::??<4 55 Ks C C c$V^8dQhR\/#r&r/)rs"rrr0sffsfrc*\4'dR#R#)z5npm install -g agent-browser && agent-browser installzXhermes pm install agent-browser (system libraries: npx playwright install-deps chromium))_is_termux_environmentrr_browser_install_hintr>0sF erc>V^8dQhR\R,R\/#)r rNr )r bool)rs"rrr6s"RR3:R$RrcV'gR#\PPV4;'dA\PR8H;'g&\P!V\P 4#)Fnt)rrisfilenameaccessX_OKrs&r _agent_browser_candidate_presentrH6sB  77>>$  Q QRWW_%P%P $8PQrvalidateTc0V^8dQhR\R\/#)r rIr )r@r )rs"rrr<s""T"S"rc^RIp\4pV'g=VPR4pV'd$VPe\ VP4#V'd\ M\ pR\R43F@pVR8XdK \P!RVR7pV'gK.V!V4'gK>Vu# R\4 2pV'dWV'gOVPR4TPR4pT'd$TPe\ TP4#\V4h TP\3dp\T RT 24ThRp?ii;i)adSelect PM's exact binary, then an external PATH/Homebrew installation. Termux owns its browser installation. Elsewhere PM may acquire a missing CLI at execution time, subject to its lazy-install policy. Readiness checks (``validate=False``) never execute or install anything. Selection is not cached: a new PM fact or profile must be visible immediately. Nz agent-browserr1rGz.agent-browser CLI not found. Install it with:  )pmr<installed_packagebinaryr rrHr9shutilwhichr>ensure InstallErrorr"FileNotFoundError) rIrMtermux installedusable search_path candidatehintexcs $ r_find_agent_browserr\<s) # %F ((9 ))5y''( ('/ #5UF1"56 "  LL{C 9 **  7 < ?sD..EEEc0V^8dQhR\R\/#)r timeoutr )floatr@)rs"rrr^s%4rcR#)zFrozen old-updater surface names this module too (the extraction-era home); tools.browser_tool carries the permanent definition. No npx work is performed; relaunch instead.Fr=)r^s&rwarm_agent_browser_npx_cachera^s rc$V^8dQhR\/#r&r@)rs"rrrdsPPTPrc^RIHpV!4p\T;'d>\PP V4;'g\ P!V44#)zEAn explicit browser executable or PM's selected full Chromium exists.)chromium_executable)hermes_cli.browser_runtimerer@rrrCrPrQ)reab_paths r_chromium_installedrhds>>!#G NNRWW^^G4MM W8M OOrc$V^8dQhR\/#r&rc)rs"rrrls!!T!rc\4pVP'd \4#RVn\4'g6\ 4'g&\ P PR4'dR#^RIH pH pH pV!4'gR#VPPR4V!R4\4# T\3d(pTPPRT4Rp?R#Rp?ii;i) zInstall only PM's pinned full Chromium, never the upstream browser pair. Docker supplies the binary. Other installs require lazy-install consent. TAGENT_BROWSER_EXECUTABLE_PATHF)rSrRlazy_installs_allowedz(browser: installing PM's pinned Chromiumchromiumz)browser: Chromium auto-install failed: %sN)r)_chromium_autoinstall_attemptedrh_running_in_dockerr<renvirongetrMrSrRrlloggerinfor"warning)r+rSrRrlr[s r_maybe_autoinstall_chromiumruls )C ***"$$*.C'5772::>>Ji;j;j>> " "JJOO>?z    ' " FLs*B<< C0 C++C0c$V^8dQhR\/#r&rc)rs"rrrsDrc\PPR4'dR#\RRRR7;_uu_4pRVP 49uuRRR4# +'giR#;i \ dR #i;i) zABest-effort detection of whether we're inside a Docker container.z /.dockerenvTz/proc/1/cgrouprtzutf-8)encodingdockerNF)rrexistsopenreadr")fps rroros] ww~~m$$ "D7 ; ;rrwwy(< ; ; ; s.A1A A1 A. (A1.A11 B?Bc$V^8dQhR\/#r&rc)rs"rrrs!!D!rc\4pVP4'dR#VP4'dR#\P!4'dR#\ RR7\P!4pTeTP4#\P!4'dR#\4# \ dR#i;i)zWhether the browser tools should be advertised. Local mode needs the ``agent-browser`` CLI plus a Chromium build (except Lightpanda-only text workflows); cloud mode needs the CLI plus provider credentials (the provider hosts its own Chromium). FT)rI) r)_is_browser_use_cli_mode_is_camofox_mode_cdp_get_cdp_override_rawr\rT_cloud_get_cloud_provider is_available_lp_using_lightpanda_enginerh)r+providers rcheck_browser_requirementsrs )C ##%%  !!##U+ ))+H$$&& ##%%    s B55 CCc$V^8dQhR\/#r&rc)rs"rrrs ' '4 'rc@\4'gR#^RIHpV!4#)aDAdvertise ``browser_vision`` only with BOTH a working browser AND a vision backend. Without the vision check, the tool stays in the model's tool list even when no vision provider is configured, then fails at call time with a cryptic provider-side error like ``unknown variant `image_url`, expected `text``` (issue #31179). Fcheck_vision_requirements)rtools.vision_toolsrrs r!check_browser_vision_requirementsrs & ' '< $ &&r)r1)gN@)__doc__ functoolsrrPhermes_constantsrrr<tools.browser_tool_originrr)toolsrrrrrr lru_cacher$r,r9r>rHr\rarhrurorrr=rrrsW X>*.9 Q   C 6f R "D"D P!.!B 'r