KiOUdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z mZmZddlZddlmZddlmZejeZdZd Zdad ed <d ad@dZdAdZdAdZdBdZ dAdZ!iZ"ded<ej#Z$dCdZ%dDdEdZ&dFdZ'efdGd$Z(defdHd&Z)defdId(Z*defdGd)Z+dJdKd*Z, dLdMd-Z-dJdNd/Z.dJdOd1Z/dJdPd3Z0dJdQd4Z1dJdRd6Z2dJdQd7Z3dJdQd8Z4 dSdTd;Z5dSdUd=Z6dVd?Z7dS)WuACamofox 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)Path)AnyDictOptional load_config)get_camofox_identityi8 Optional[str]_vnc_urlFreturnstrcRtjdddS)z:Return the configured Camofox server URL, or empty string. CAMOFOX_URL/)osgetenvrstrip2/home/ubuntu/hermes-agent/tools/browser_camofox.pyget_camofox_urlr4s" 9]B ' ' . .s 3 33rboolc8ttS)z(True when Camofox backend is configured.)rrrrris_camofox_moder9s !! " ""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:>sA   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<Ws "!!! Orc tdidi}n#t$rYdSwxYwt|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. browsercamofoxFmanaged_persistence)r r)r3r) camofox_cfgs r_managed_persistence_enabledrB^so!mm'' 266::9bII uu   566 7 77s69 AAzDict[str, Dict[str, Any]] _sessionstask_idDict[str, Any]cp|pd}t5|tvrt|cdddStr#t|}|dd|ddd}n3dt jjdddd |dd d d}|t|<|cdddS#1swxYwYdS) zGet or create a camofox session for the given task. When managed persistence is enabled, uses a deterministic userId derived from the Hermes profile so the Camofox server can map it to the same persistent browser profile across restarts. defaultNuser_id session_keyT)rHtab_idrImanagedhermes_ task_F)_sessions_lockrCrBr uuiduuid4hex)rDidentitysessions r _get_sessionrVvsG"G  i  W% ( ) ) +G44H#I.' 6 GG=TZ\\%5crc%:<<5wss|55 G % ''sB+A/B++B/2B/ about:blankr4c2t|}|dr|St}tj|d|d|d|dt}||}|d|d<|S)z>>>>>>>?s6B-B00E?CE9E E"#E E Efull user_taskc t|}|dstjdddStd|ddd|di }|d d }|d d }d dlm}m}m} t||kr|r |||}n | |}tjd||dS#t$r.} tjdt| dcYd} ~ Sd} ~ wwxYw)z-Get accessibility tree snapshot from Camofox.rJF0No browser session. Call browser_navigate first.rry /snapshotrYrHrlsnapshotr refsCountr)SNAPSHOT_SUMMARIZE_THRESHOLD_extract_relevant_content_truncate_snapshotT)r|r element_countN) rVr,rrpr)tools.browser_toolrrrlenr3r) rrDrrUr6r refs_countrrrrs rcamofox_snapshotrs~ ?w''x  o:%:lmmnn n 1WX& 1 1 1gi01    88J++XXk1--           x==7 7 7 844XyII--h77z '     ???zec!ff==>>>>>>>>?s#-CBC D#D;DDrefc t|}|dstjdddS|d}t d|dd|d|d }tjd ||d d d S#t $r.}tjdt|dcYd}~Sd}~wwxYw)z$Click an element by ref via Camofox.rJFrr@ryz/clickrH)rYrTr4r)r|clickedr4N)rVr,rlstriprkr)r3r)rrDrU clean_refr6rs r camofox_clickr's?w''x  o:%:lmmnn nJJsOO  .WX& . . .y)) < <  z 88E2&&     ???zec!ff==>>>>>>>>?s#-BA#B C #CC C textcx t|}|dstjdddS|d}t d|dd|d||d tjd ||d S#t $r.}tjdt |dcYd }~Sd }~wwxYw) z-Type text into an element by ref via Camofox.rJFrrrryz/typerH)rYrrT)r|typedelementN)rVr,rrrkr3r)rrrDrUrrs r camofox_typer>s?w''x  o:%:lmmnn nJJsOO  -WX& - - -y))T J J   z      ???zec!ff==>>>>>>>>?s#-BAB B9 #B4.B94B9 directioncJ t|}|dstjdddStd|dd|d|dtjd |d S#t$r.}tjdt |dcYd }~Sd }~wwxYw) zScroll the page via Camofox.rJFrrryz/scrollrH)rYrT)r|scrolledNrVr,rrkr3r)rrDrUrs rcamofox_scrollrTs ?w''x  o:%:lmmnn n /WX& / / /y) B B   zd BBCCC ???zec!ff==>>>>>>>>?"-A*9A** B"4#BB"B"cp t|}|dstjdddStd|ddd|di}tjd |d d d S#t $r.}tjdt |dcYd }~Sd }~wwxYw)zNavigate back via Camofox.rJFrrryz/backrYrHTr4r)r|r4N)rVr,rrkr)r3r)rDrUr6rs r camofox_backrds ?w''x  o:%:lmmnn n -WX& - - - wy) *  zd488E23F3FGGHHH ???zec!ff==>>>>>>>>?s#-A=A A== B5#B0*B50B5keycJ t|}|dstjdddStd|dd|d|dtjd |d S#t$r.}tjdt |dcYd }~Sd }~wwxYw) z!Press a keyboard key via Camofox.rJFrrryz/pressrH)rYrT)r|pressedNr)rrDrUrs r camofox_pressrts ?w''x  o:%:lmmnn n .WX& . . .y)# 6 6   zds;;<<< ???zec!ff==>>>>>>>>?rc* t|}|stjdddStd|dtjdddS#t$r/}tjddt |dcYd}~Sd}~wwxYw)z&Close the browser session via Camofox.T)r|closed /sessions/rH)r|rwarningN)rer,rrvr3r)rDrUrs r camofox_closers P(( A:$$??@@ @ -+ - -   zdd;;<<< PPPzdds1vvNNOOOOOOOOPs"'A.A B#$B B Bc t|}|dstjdddSddl}t d|ddd |d i }|d d }g}|d}t|D]\}}|} | ds| dr| d| } | r| dnd } d } |dzt|krH| d||dz} | r| d} | s| r| | | dtjd|t|dS#t$r.}tjdt|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. rJFrrrNryrrYrHrrr z- img zimg zimg\s+"([^"]*)"r$z /url:\s*(\S+))srcaltT)r|imagescount)rVr,rrerpr)split enumeratestrip startswithsearchgrouprappendr3r)rDrUrr6rrlinesilinestripped alt_matchrr url_matchrs rcamofox_get_imagesrs' &?w''x  o:%:lmmnn n  1WX& 1 1 1gi01   88J++ t$$ '' < >>>>>>>?s#-F'E6F'' G1#GGGquestionannotatecz t|}|dstjdddStd|ddd|di }d d lm}|d z }|d d t|dtj j dddz }t|d5}| |j dddn #1swxYwYtj|j d} d} |rV t#d|ddd|di } d| dddd} n#t&$rYnwxYwd dlm} | | } d dlm} d|| } d dlm}|}t5|didid d!}n#t&$rd!}YnwxYw| d"d#|d$d%d&d'| id(gd)gd|*}|jr+|jd jj pdnd}d dlm} | |}tjd ||d+S#t&$r.}tjdt|dcYd}~Sd}~wwxYw),z>>>>>>>?s-JBJC( J(C,,J/C,03J$AE)(J) E63J5E66!JAG43J4 HJHA>J J: #J5/J:5J:clearc 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.)r|console_messages js_errorstotal_messages total_errorsnote)r,r)rrDs rcamofox_consolers7 :P   rNonecdt5tt}dddn #1swxYwY|D].\}} t d|d#t $rY+wxYwt5tddddS#1swxYwYdS)z"Close all active camofox sessions.NrrH)rPlistrCitemsrvr3r)sessionsrDrUs rcleanup_all_camofox_sessionsr1sF ++ ))**+++++++++++++++$  5!355 6 6 6 6    D  s1';??A'' A43A4>B%%B),B))rr)rr)rr )rDr rrE)rW)rDr r4rrrE)rDr rrb)rfrrgrhr!r.rrh)rfrrlrhr!r.rrh)rfrrlrhr!r.rrq)N)r4rrDr rr)FNN)rrrDr rr rr)rrrDr rr)rrrrrDr rr)rrrDr rr)rDr rr)rrrDr rr)FN)rrrrrDr rr)rrrDr rr)rr)8__doc__ __future__rrr,loggingr threadingtimerQpathlibrtypingrrrr(rr tools.browser_camofox_stater getLogger__name__loggerr^_SNAPSHOT_MAX_CHARSr __annotations__r+rrr:r<rBrCLockrPrVrarerkrprsrvrrrrrrrrrrrrrrrrs,#"""""   &&&&&&&&&&))))))<<<<<<  8 $ $ 4444 #### 2 8 8 8 8((* ))))!!<*,,,,1A$(8H(,