ei6TUdZddlmZddlZddlZddlZddlZddlZddlZddl m Z m Z m Z ddl Z ddlmZddlmZddlmZejeZdZd Zdad ed <d ad?dZd@dZd@dZdAdZd@dZ iZ!ded<ej"Z#dBdZ$dCdDdZ%dEdZ&dFdGdZ'efdHd%Z(defdId'Z)defdJd)Z*defdHd*Z+dFdKd+Z, dLdMd.Z-dFdNd0Z.dFdOd2Z/dFdPd4Z0dFdQd5Z1dFdRd7Z2dFdQd8Z3dFdQd9Z4 dSdTd<Z5dSdUd>Z6dS)VuACamofox browser backend — local anti-detection browser via REST API. Camofox-browser is a self-hosted Node.js server wrapping Camoufox (Firefox fork with C++ fingerprint spoofing). It exposes a REST API that maps 1:1 to our browser tool interface: accessibility snapshots with element refs, click/type/scroll by ref, screenshots, etc. When ``CAMOFOX_URL`` is set (e.g. ``http://localhost:9377``), the browser tools route through this module instead of the ``agent-browser`` CLI. Setup:: # Option 1: npm git clone https://github.com/jo-inc/camofox-browser && cd camofox-browser npm install && npm start # downloads Camoufox (~300MB) on first run # Option 2: Docker docker run -p 9377:9377 -e CAMOFOX_PORT=9377 jo-inc/camofox-browser Then set ``CAMOFOX_URL=http://localhost:9377`` in ``~/.hermes/.env``. ) annotationsN)AnyDictOptional) load_config)get_camofox_identity) tool_errori8 Optional[str]_vnc_urlFreturnstrcRtjdddS)z:Return the configured Camofox server URL, or empty string. CAMOFOX_URL/)osgetenvrstrip7/home/div/.hermes/hermes-agent/tools/browser_camofox.pyget_camofox_urlr3s" 9]B ' ' . .s 3 33rboolctjddrdStt S)aqTrue when Camofox backend is configured and no CDP override is active. When the user has explicitly connected to a live Chrome instance via ``/browser connect`` (which sets ``BROWSER_CDP_URL``), the CDP connection takes priority over Camofox so the browser tools operate on the real browser instead of being silently routed to the Camofox backend. BROWSER_CDP_URLrF)rrstriprrrrris_camofox_moder8s> y"B''--//u !! " ""rct}|sdS tj|dd}|jdkrts |}|d}t |tr2d|cxkrdkr%nn"d d lm }||}|j pd }d |d |a n#ttf$rYnwxYwda|jdkS#t$rYdSwxYw)z'Verify the Camofox server is reachable.Fz/healthtimeoutvncPortir)urlparse localhostzhttp://:T)rrequestsget status_code_vnc_url_checkedjson isinstanceint urllib.parser&hostnamer ValueErrorKeyError Exception)urlrespdatavnc_portr&parsedhosts rcheck_camofox_availabler;EsA   C u|sOOOQ777  s " "+; " yy{{88I..h,,;h1G1G1G1G%1G1G1G1G1G555555%Xc]]F!?9kD:::::H)    # 3&& uus6+CA0B10C1CCCC C#"C#c:tsttS)z>Return the VNC URL if the Camofox server exposes one, or None.)r,r;r rrr get_vnc_urlr=^s "!!! Orc tdidi}n3#t$r&}td|Yd}~dSd}~wwxYwt |dS)alReturn whether Hermes-managed persistence is enabled for Camofox. When enabled, sessions use a stable profile-scoped userId so the Camofox server can map it to a persistent browser profile directory. When disabled (default), each session gets a random userId (ephemeral). Controlled by ``browser.camofox.managed_persistence`` in config.yaml. browsercamofoxzF93F>9F>questionannotatec t|}|dstddStd|ddd|di }d d lm}|d z }|d d t |dtjj dddz }t|d5}| |j dddn #1swxYwYtj|j d} d} |rV t!d|ddd|di } d| dddd} n#t$$rYnwxYwd dlm} | | } d dlm} d|| } t/}|didi}t1|dd }t1|d!d"}n#t$$rd#}d"}YnwxYw| d$d%|d&d'd(d)| id*gd+gd||,}|jr+|jd jj pdnd}d dlm} | |}t9jd ||d-S#t$$r(}tt |dcYd}~Sd}~wwxYw).zHJ"H"J"!H""A?J"" K,K KKclearc 8tjdggddddS)uGet console output — limited support in Camofox. Camofox does not expose browser console logs via its REST API. Returns an empty result with a note. Trz|Console log capture is not available with the Camofox backend. Use browser_snapshot or browser_vision to inspect page state.)rconsole_messages js_errorstotal_messages total_errorsnote)r-r)rrHs rcamofox_consolerJs7 :P   r)r r)r r)r r )rHr r rI)r[)rHr r5rr rI)rHr r rf)N)rHr r r)rnrrorpr"r/r rp)rnrrtrpr"r/r rp)rnrrtrpr"r/r ry)r5rrHr r r)FNN)rrrHr rr r r)rrrHr r r)rrrrrHr r r)rrrHr r r)rHr r r)rrrHr r r)FN)rrrrrHr r r)rrrHr r r)7__doc__ __future__rrr-loggingr threadingrUtypingrrrr)hermes_cli.configrtools.browser_camofox_statertools.registryr getLogger__name__rBrb_SNAPSHOT_MAX_CHARSr __annotations__r,rrr;r=rFrGLockrTrZrerjrmrsrxr{r~rrrrrrrrrrrrrrrs,#"""""   &&&&&&&&&&))))))<<<<<<%%%%%%  8 $ $ 4444 # # # #28888*(* ))))!!<*,,,,     (1A$(8H(,