iDTUdZddlmZddlZddlZddlZddlZddlZddlZddl m Z m Z m Z ddl Z ddlmZmZddlmZddlmZejeZdZd Zdad ed <d ad?dZd@dZd@dZdAdZ d@dZ!iZ"ded<ej#Z$dBdZ%dCdDdZ&dEdZ'dFdGdZ(efdHd%Z)defdId'Z*defdJd)Z+defdHd*Z,dFdKd+Z- dLdMd.Z.dFdNd0Z/dFdOd2Z0dFdPd4Z1dFdQd5Z2dFdRd7Z3dFdQd8Z4dFdQd9Z5 dSdTd<Z6dSdUd>Z7dS)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)cfg_get load_config)get_camofox_identity) tool_errori8 Optional[str]_vnc_urlFreturnstrcRtjdddS)z:Return the configured Camofox server URL, or empty string. CAMOFOX_URL/)osgetenvrstrip:/home/ubuntu/.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. browsercamofoxzrytools.browser_toolrrlenr5r.dumpsr* HTTPErrorr ConnectionErrorrr) r6rIrZr8resultvnc snap_data snapshot_textrres rcamofox_navigaters71w''x !'3//Gs++DD5*555"9-c::D 88E3''XXgr**   mm   #F9 T :   5*555 ')"45I&MM*b99M        =!!$@@@ 2 2= A A !.F: &/mmK&C&CF? # #    D z&!!!  DDD333UCCCCCCCCC  #   z__5F5F___       111#a&&%0000000001s[BD?A=DD? D(%D?'D((D??GE'!G'9G" G+GGGfull user_taskc t|}|dstddStd|ddd|di }|d d }|d d }d dlm}m}m} t||kr|r |||}n | |}tj d||dS#t$r(} tt| dcYd} ~ Sd} ~ wwxYw)z-Get accessibility tree snapshot from Camofox.rO0No browser session. Call browser_navigate first.Frrrr^rMrrrrr)r_extract_relevant_contentrT)rrrN) r[r ryr+rrrrrr.rr5r) rrIrrZr8r refs_countrrrrs rcamofox_snapshotr,su 1w''x  aPZ_``` ` 1WX& 1 1 1gi01    88J++XXk1--           x==7 7 7 844XyII--h77z '     111#a&&%0000000001s#'CBC C:C5/C:5C:refc t|}|dstddS|d}td|dd|d|d }t jd ||d d d S#t$r(}tt|dcYd}~Sd}~wwxYw)z$Click an element by ref via Camofox.rOrFr@rz/clickrM)r^rTr6r)rclickedr6N) r[r lstriprtr.rr+r5r)rrIrZ clean_refr8rs r camofox_clickrRs1w''x  aPZ_``` `JJsOO  .WX& . . .y)) < <  z 88E2&&     111#a&&%0000000001s#'BA#B CB;5C;Ctextc` t|}|dstddS|d}td|dd|d||d t jd ||d S#t $r(}tt|dcYd }~Sd }~wwxYw) z-Type text into an element by ref via Camofox.rOrFrrrz/typerM)r^rrT)rtypedelementN)r[r rrtr.rr5r)rrrIrZrrs r camofox_typeris1w''x  aPZ_``` `JJsOO  -WX& - - -y))T J J   z      111#a&&%0000000001s#'A;AA;; B-B("B-(B- directionc2 t|}|dstddStd|dd|d|dtjd |d S#t $r(}tt |dcYd }~Sd }~wwxYw) zScroll the page via Camofox.rOrFrrz/scrollrM)r^rT)rscrolledNr[r rtr.rr5r)rrIrZrs rcamofox_scrollrs 1w''x  aPZ_``` ` /WX& / / /y) B B   zd BBCCC 111#a&&%0000000001"'A$9A$$ B.B BBcX t|}|dstddStd|ddd|di}tjd |d d d S#t $r(}tt|dcYd }~Sd }~wwxYw)zNavigate back via Camofox.rOrFrrz/backr^rMTr6r)rr6N)r[r rtr.rr+r5r)rIrZr8rs r camofox_backrs 1w''x  aPZ_``` ` -WX& - - - wy) *  zd488E23F3FGGHHH 111#a&&%0000000001s#'A7A A77 B)B$B)$B)keyc2 t|}|dstddStd|dd|d|dtjd |d S#t $r(}tt |dcYd }~Sd }~wwxYw) z!Press a keyboard key via Camofox.rOrFrrz/pressrM)r^rT)rpressedNr)rrIrZrs r camofox_pressrs 1w''x  aPZ_``` ` .WX& . . .y)# 6 6   zds;;<<< 111#a&&%0000000001rc* t|}|stjdddStd|dtjdddS#t$r/}tjddt |dcYd}~Sd}~wwxYw)z&Close the browser session via Camofox.T)rclosedz /sessions/rM)rrrDN)rkr.rrr5r)rIrZrs r camofox_closers P(( A:$$??@@ @ -+ - -   zdd;;<<< PPPzdds1vvNNOOOOOOOOPs"'A.A B#$B B Bc t|}|dstddSddl}td|ddd |d i }|d d }g}|d}t |D]\}}|} | dr| d| } | r| dnd } d } |dzt|krH| d||dz} | r| d} | s| r| | | dtjd|t|dS#t$r(}tt!|dcYd}~Sd}~wwxYw)zGet images on the current page via Camofox. Extracts image information from the accessibility tree snapshot, since Camofox does not expose a dedicated /images endpoint. rOrFrrNrrr^rMrrr )z- img zimg zimg\s+"([^"]*)"r&z /url:\s*(\S+))srcaltT)rimagescount)r[r reryr+split enumerater startswithsearchgrouprappendr.rr5r)rIrZrr8rrlinesilinestripped alt_matchrr url_matchrs rcamofox_get_imagesrs  &1w''x  aPZ_``` `  1WX& 1 1 1gi01   88J++ t$$ '' < F93F>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/}t1|ddi}t3|d d!}t3|d"d#}n#t$$rd$}d#}YnwxYw| d%d&|d'd(d)d*| id+gd,gd||-}|jr+|jd jj pdnd}d dlm} | |}t;jd ||d.S#t$$r(}tt |dcYd}~Sd}~wwxYw)/zrGrHLockrUr[rfrkrnrtryr|rrrrrrrrrrrr rrrrs,#"""""   &&&&&&&&&&22222222<<<<<<%%%%%%  8 $ $ 4444 # # # #28888*(* ))))!!<*,,,,     (1A$(8H(,