Ki; UdZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlmZmZmZmZddlmZddlmZ ddlmZn#e$rdZYnwxYw ddlmZn#e$rd ZYnwxYwdd lmZdd lm Z dd l!m"Z"dd l#m$Z$ ddl%m&Z'n#e($rdZ'YnwxYwej)e*Z+dZ,de-e.fdZ/iZ0e1e.e2fe3d<dZ4dZ5dZ6de7fdZ8dee.fdZ9dee.fdZ:de.de.fdZ;de.fdZfe3d<da?eee3d<d a@d aAdaBeeCe3d!<deefd"ZDdeee.effd#ZEdee.effd$ZFdeCfd%ZGdeCfd&ZHdeCfd'ZIde.fd(ZJiZKee.ee.e.ffe3d)<eLZMeLe3d*<d aNe7ejOPd+d,ZQiZRee.e2fe3d-<daSd aTe jUZVd.ZWejXeWd/ZYd0ZZd1Z[d2Z\d3e.fd4Z]ejXe\d5d6d7d8d9d:d;id8gd<d=d>d?d7d@dAdBd dCigd<d=dDdEd7dFd9dGd;idFgd<d=dHdId7d9dJd;d9dKd;dLdFdMgd<d=dNdOd7dPd9dQdRgdSdTidPgd<d=dUdVd7igd<d=dWdXd7dYd9dZd;idYgd<d=d[d\d7igd<d=d]d^d7igd<d=d_d`d7d9dad;dAd dbdcdddegd<d=dfdgd7dhdAd didcigd<d=g Z^d3e.dee.e.ffdjZ_d3e.de.dee.e.ffdkZ`dd3ee.dee.e.ffdlZade.fdmZbdMe.dee.fdnZc dd3e.doe.dpee.dqee7dee.eff drZd ddse.dtee.de.fduZeddse.dve7de.fdwZfdd8e.d3ee.de.fdxZg dd@eCd3ee.dtee.de.fdyZhddFe.d3ee.de.fdzZiddFe.dMe.d3ee.de.fd{ZjddPe.d3ee.de.fd|Zkdd3ee.de.fd}ZlddYe.d3ee.de.fd~Zmdd3ee.de.fdZnddheCd3ee.de.fdZod3e.fdZpd3e.fdZqdd3ee.de.fdZrddee.deCd3ee.de.fdZsddZtddZudd3ee.ddfdZvddZwdee.ee.e.fffdZxdeCfdZye*dkr= ezdezdeDZ{e{dnde{|dZ}ezde}eyr ezdnzezd ebn!#e~$rezdezdYnwxYwe{@e{s,ezde{|dezdezde^D](Zezdeddedddd)ezdezdezdezdddlmZde^DZejXd5ded5deydejXd>ded>deydejXdDdedDdeydejXdHdedHdeydejXdNdedNdeydejXdUdedUdeydejXdWdedWdeydejXd[ded[deydejXd]ded]deydejXd_ded_deydejXdfdedfdeyddS)u Browser Tool Module This module provides browser automation tools using agent-browser CLI. It supports two backends — **Browserbase** (cloud) and **local Chromium** — with identical agent-facing behaviour. The backend is auto-detected: if ``BROWSERBASE_API_KEY`` is set the cloud service is used; otherwise a local headless Chromium instance is launched automatically. The tool uses agent-browser's accessibility tree (ariaSnapshot) for text-based page representation, making it ideal for LLM agents without vision capabilities. Features: - **Local mode** (default): zero-cost headless Chromium via agent-browser. Works on Linux servers without a display. One-time setup: ``agent-browser install`` (downloads Chromium) or ``agent-browser install --with-deps`` (also installs system libraries for Debian/Ubuntu/Docker). - **Cloud mode**: Browserbase cloud execution with stealth features, proxies, and CAPTCHA solving. Activated when BROWSERBASE_API_KEY is set. - Session isolation per task ID - Text-based page snapshots using accessibility tree - Element interaction via ref selectors (@e1, @e2, etc.) - Task-aware content extraction using LLM summarization - Automatic cleanup of browser sessions Environment Variables: - BROWSERBASE_API_KEY: API key for Browserbase (enables cloud mode) - BROWSERBASE_PROJECT_ID: Project ID for Browserbase (required for cloud mode) - BROWSERBASE_PROXIES: Enable/disable residential proxies (default: "true") - BROWSERBASE_ADVANCED_STEALTH: Enable advanced stealth mode with custom Chromium, requires Scale Plan (default: "false") - BROWSERBASE_KEEP_ALIVE: Enable keepAlive for session reconnection after disconnects, requires paid plan (default: "true") - BROWSERBASE_SESSION_TIMEOUT: Custom session timeout in milliseconds. Set to extend beyond project default. Common values: 600000 (10min), 1800000 (30min) (default: none) Usage: from tools.browser_tool import browser_navigate, browser_snapshot, browser_click # Navigate to a page result = browser_navigate("https://example.com", task_id="task_123") # Get page snapshot snapshot = browser_snapshot(task_id="task_123") # Click an element browser_click("@e5", task_id="task_123") N)DictAnyOptionalListPath)call_llm)check_website_accesscdSNurls //home/ubuntu/hermes-agent/tools/browser_tool.pyrHst) is_safe_urlcdSNFr rs rrrMur)CloudBrowserProvider)BrowserbaseProvider)BrowserUseProvider) normalize_browser_cloud_provider)is_camofox_modecdSrr r rrrrYrrza/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/binreturncg}d}tj|s|S tj|D]r}|dr[|dkrUtj||d}tj|r||sn#t$rYnwxYw|S)a;Find Homebrew versioned Node.js bin directories (e.g. node@20, node@24). When Node is installed via ``brew install node@24`` and NOT linked into /opt/homebrew/bin, the binary lives only in /opt/homebrew/opt/node@24/bin/. This function discovers those paths so they can be added to subprocess PATH. z/opt/homebrew/optnodebin)ospathisdirlistdir startswithjoinappendOSError)dirs homebrew_optentrybin_dirs r_discover_homebrew_node_dirsr-esD&L 7== & &  Z -- ) )E'' )EVOO',,|UEBB7==)))KK(((  )      KsBB// B<;B<_last_screenshot_cleanup_by_dir,@c@ ttjdtjdz }|dz }|rddl}t|5}||pi}dddn #1swxYwY|did}|tt|dSn2#t$r%}t d |Yd}~nd}~wwxYwtS) zReturn the configured browser command timeout from config.yaml. Reads ``config["browser"]["command_timeout"]`` and falls back to ``DEFAULT_COMMAND_TIMEOUT`` (30s) if unset or unreadable. HERMES_HOME.hermes config.yamlrNbrowsercommand_timeoutz.Could not read command_timeout from config: %s)rr!environgethomeexistsyamlopen safe_loadmaxint ExceptionloggerdebugDEFAULT_COMMAND_TIMEOUT) hermes_home config_pathr=fcfgvales r_get_command_timeoutrLsX J2:>>-y9PQQRR !M1      ( KKKk"" .annQ''-2 . . . . . . . . . . . . . . .'')R((,,->??C3s88Q''' JJJ EqIIIIIIIIJ ""s=A-C'/B C'BC'BA C'' D1DDcTtjddpdS)u>Model for browser_vision (screenshot analysis — multimodal).AUXILIARY_VISION_MODELNr!getenvstripr rr_get_vision_modelrSs& 9-r 2 2 8 8 : : BdBrcTtjddpdS)uCModel for page snapshot text summarization — same as web_extract.AUXILIARY_WEB_EXTRACT_MODELrONrPr rr_get_extraction_modelrVs& 92B 7 7 = = ? ? G4Grcdp_urlcz|pd}|sdS|}d|vr|S|}|ds|dr|ddkr|dddd rUd|ddd vr7|drd nd |d ddz}n|S|d r|}n|dd z} tj |d}| | }n6#t$r)}td||||cYd}~Sd}~wwxYwt!| dpd}|rtd|||Std||S)aNormalize a user-supplied CDP endpoint into a concrete connectable URL. Accepts: - full websocket endpoints: ws://host:port/devtools/browser/... - HTTP discovery endpoints: http://host:port or http://host:port/json/version - bare websocket host:port values like ws://host:port For discovery-style endpoints we fetch /json/version and return the webSocketDebuggerUrl so downstream tools always receive a concrete browser websocket instead of an ambiguous host:port URL. rOz/devtools/browser/zws://zwss://:/zhttp://zhttps://z://z /json/version timeoutz,Failed to resolve CDP endpoint %s via %s: %sNwebSocketDebuggerUrlzResolved CDP endpoint %s -> %szKCDP discovery at %s did not return webSocketDebuggerUrl; using raw endpoint)rRlowerr%countrstriprsplitisdigitsplitendswithrequestsr:raise_for_statusjsonrBrCwarningstrinfo) rWrawlowered discovery_url version_urlresponsepayloadexcws_urls r_resolve_cdp_overriderwsM =b   ! !C riikkGw&& M'""g&8&8&B&B 99S>>Q  3::c??#9#9#q#A#A"#E#M#M#O#O TW_b_h_hilno_p_pqs_tTtTt*1*<*F GG<GGc\ttjddS)aReturn a normalized user-supplied CDP URL override, or empty string. When ``BROWSER_CDP_URL`` is set (e.g. via ``/browser connect``), we skip both Browserbase and the local headless launcher and connect directly to the supplied Chrome DevTools Protocol endpoint. BROWSER_CDP_URLrO)rwr!r9r:r rr_get_cdp_overriderzs# !0A2!F!F G GGr) browserbasez browser-use_PROVIDER_REGISTRY_cached_cloud_providerF_cached_allow_private_urlsctrtSda ttjdtjdz }|dz }|rddl}t|5}| |pi}dddn #1swxYwY|di}d}t|tr0d|vr,t|d}|d krdadS|r|tvrt|an2#t$r%}t d |Yd}~nd}~wwxYwt$t%}|r|atS) aWReturn the configured cloud browser provider, or None for local mode. Reads ``config["browser"]["cloud_provider"]`` once and caches the result for the process lifetime. An explicit ``local`` provider disables cloud fallback. If unset, fall back to Browserbase when direct or managed Browserbase credentials are available. Tr3r4r5rNr6cloud_providerlocalz-Could not read cloud_provider from config: %s)_cloud_provider_resolvedr}rr!r9r:r;r<r=r>r? isinstancedictrr|rBrCrDr is_configured) rFrGr=rHrI browser_cfg provider_keyrKfallback_providers r_get_cloud_providerrs &%%#I2:>>-y9PQQRR !M1      L KKKk"" .annQ''-2 . . . . . . . . . . . . . . .'')R00KL+t,, 1A[1P1P?OO$455    7**-1*4 L 0B B B);L)I)K)K& III DaHHHHHHHHI%/11  * * , , 7%6 " !!sCA-D+?B# D+#B''D+*B'+AD+ D++ E5EEcBtS)zFReturn Browserbase direct or managed config, or None when unavailable.)r_get_config_or_noner rr_get_browserbase_config_or_noners  4 4 6 66rcBtS)zUReturn Browserbase config or raise when neither direct nor managed mode is available.)r _get_configr rr_get_browserbase_configr$s  , , . ..rcBtrdStduS)zCReturn True when the browser tool will use a local browser backend.FN)rzrr rr_is_local_moder)s&u  D ((rc>tptduS)uReturn True when the browser runs locally (no cloud provider). SSRF protection is only meaningful for cloud backends (Browserbase, BrowserUse) where the agent could reach internal resources on a remote machine. For local backends — Camofox, or the built-in headless Chromium without a cloud provider — the user already has full terminal and network access on the same machine, so the check adds no security value. N)_is_camofox_moderr rr_is_local_backendr0s!    >!4!6!6$!>>rc@trtSdada ttjdtjdz }|dz }|rxddl}t|5}| |pi}dddn #1swxYwYt|did an2#t$r%}td |Yd}~nd}~wwxYwtS) zReturn whether the browser is allowed to navigate to private/internal addresses. Reads ``config["browser"]["allow_private_urls"]`` once and caches the result for the process lifetime. Defaults to ``False`` (SSRF protection active). TFr3r4r5rNr6allow_private_urlsz1Could not read allow_private_urls from config: %s)_allow_private_urls_resolvedr~rr!r9r:r;r<r=r>r?boolrBrCrD)rFrGr=rHrIrKs r_allow_private_urlsr=sc$*))#' !& M2:>>-y9PQQRR !M1      ` KKKk"" .annQ''-2 . . . . . . . . . . . . . . .)-cggi.D.D.H.HI].^.^)_)_ & MMM H!LLLLLLLLM %%s<A-C'B% C'%B))C',B)-9C'' D1DDcLtjdkrdStjS)ueReturn a short temp directory path suitable for Unix domain sockets. macOS sets ``TMPDIR`` to ``/var/folders/xx/.../T/`` (~51 chars). When we append ``agent-browser-hermes_…`` the resulting socket path exceeds the 104-byte macOS limit for ``AF_UNIX`` addresses, causing agent-browser to fail with "Failed to create socket directory" or silent screenshot failures. Linux ``tempfile.gettempdir()`` already returns ``/tmp``, so this is a no-op there. On macOS we bypass ``TMPDIR`` and use ``/tmp`` directly (symlink to ``/private/tmp``, sticky-bit protected, always available). darwinz/tmp)sysplatformtempfile gettempdirr rr_socket_safe_tmpdirrVs% |xv    r_active_sessions_recording_sessionsBROWSER_INACTIVITY_TIMEOUT300_session_last_activityctrdSdatsdStdt t t n2#t $r%}td|Yd}~nd}~wwxYwt5t t dddn #1swxYwYt dS#t5t t dddn #1swxYwYt wxYw)z Emergency cleanup of all active browser sessions. Called on process exit or interrupt to prevent orphaned sessions. NTz2Emergency cleanup: closing %s active session(s)...zEmergency cleanup error: %s) _cleanup_donerrCrnlencleanup_all_browsersrBerror _cleanup_lockclearrr)rKs r_emergency_cleanup_all_sessionsrs M  KKD$%%'''$ 777 2A666666667 + +  " " $ $ $ " ( ( * * * + + + + + + + + + + + + + + + !!##### + +  " " $ $ $ " ( ( * * * + + + + + + + + + + + + + + + !!####sfAC0 BA<7C0<BC0 3C  CC0E83D7+ E7D; ;E>D; ?Ectj}g}t5ttD](\}}||z t kr||) dddn #1swxYwY|D]} t|t||z }t d||t|t5|tvrt|=dddn #1swxYwY#t$r&}t d||Yd}~d}~wwxYwdS)a7 Clean up browser sessions that have been inactive for longer than the timeout. This function is called periodically by the background cleanup thread to automatically close sessions that haven't been used recently, preventing orphaned sessions (local or Browserbase) from accumulating. NzA> AD'D9 DD D D D ED<<Ectrz tn2#t$r%}td|Yd}~nd}~wwxYwt dD]}tsnt jd txdSdS)z Background thread that periodically cleans up inactive browser sessions. Runs every 30 seconds and checks for sessions that haven't been used within the BROWSER_SESSION_INACTIVITY_TIMEOUT period. zCleanup thread error: %sNr/r\)_cleanup_runningrrBrCrlrangersleep)rK_s r_browser_cleanup_thread_workerrs   : . 0 0 0 0 : : : NN5q 9 9 9 9 9 9 9 9 :r  A#  JqMMMM      s AAAc4t5ttsWdat jt ddatt dtddddS#1swxYwYdS)z;Start the background cleanup thread if not already running.NTzbrowser-cleanup)targetdaemonnamez0Started inactivity cleanup thread (timeout: %ss)) r_cleanup_threadis_aliver threadingThreadrstartrCrnrr rr_start_browser_cleanup_threadrs  p p  "/*B*B*D*D "# '.5&O  ! ! # # # KKJLn o o o p p p p p p p p p p p p p p p p p psA8B  BBcRdattddSdS)z#Stop the background cleanup thread.FNr8r_)rrr&r rr_stop_browser_cleanup_threadrs5"Q'''''#"rrc|t5tjt|<ddddS#1swxYwYdS)z1Update the last activity timestamp for a session.N)rrrrs r_update_session_activityrs} 66*.)++w'666666666666666666s 155browser_navigatea,Navigate to a URL in the browser. Initializes the session and loads the page. Must be called before other browser tools. For simple information retrieval, prefer web_search or web_extract (faster, cheaper). Use browser tools when you need to interact with a page (click, fill forms, dynamic content).objectrstringz4The URL to navigate to (e.g., 'https://example.com'))type description)r propertiesrequired)rr parametersbrowser_snapshota]Get a text-based snapshot of the current page's accessibility tree. Returns interactive elements with ref IDs (like @e1, @e2) for browser_click and browser_type. full=false (default): compact view with interactive elements. full=true: complete page content. Snapshots over 8000 chars are truncated or LLM-summarized. Requires browser_navigate first.fullbooleanzpIf true, returns complete page content. If false (default), returns compact view with interactive elements only.)rrdefault browser_clickzClick on an element identified by its ref ID from the snapshot (e.g., '@e5'). The ref IDs are shown in square brackets in the snapshot output. Requires browser_navigate and browser_snapshot to be called first.refz=The element reference from the snapshot (e.g., '@e5', '@e12') browser_typezType text into an input field identified by its ref ID. Clears the field first, then types the new text. Requires browser_navigate and browser_snapshot to be called first.z5The element reference from the snapshot (e.g., '@e3')zThe text to type into the field)rtextrbrowser_scrollzScroll the page in a direction. Use this to reveal more content that may be below or above the current viewport. Requires browser_navigate to be called first. directionupdownzDirection to scroll)renumr browser_backzdNavigate back to the previous page in browser history. Requires browser_navigate to be called first. browser_presszPress a keyboard key. Useful for submitting forms (Enter), navigating (Tab), or keyboard shortcuts. Requires browser_navigate to be called first.keyz:Key to press (e.g., 'Enter', 'Tab', 'Escape', 'ArrowDown') browser_closez}Close the browser session and release resources. Call this when done with browser tasks to free up Browserbase session quota.browser_get_imageszGet a list of all images on the current page with their URLs and alt text. Useful for finding images to analyze with the vision tool. Requires browser_navigate to be called first.browser_visionaTake a screenshot of the current page and analyze it with vision AI. Use this when you need to visually understand what's on the page - especially useful for CAPTCHAs, visual verification challenges, complex layouts, or when the text snapshot doesn't capture important visual information. Returns both the AI analysis and a screenshot_path that you can share with the user by including MEDIA: in your response. Requires browser_navigate to be called first.zYWhat you want to know about the page visually. Be specific about what you're looking for.zIf true, overlay numbered [N] labels on interactive elements. Each [N] maps to ref @eN for subsequent browser commands. Useful for QA and spatial reasoning about page layout.)rrr)questionannotaterbrowser_consoleaGet browser console output and JavaScript errors from the current page. Returns console.log/warn/error/info messages and uncaught JS exceptions. Use this to detect silent JavaScript errors, failed API calls, and application warnings. Requires browser_navigate to be called first.rz0If true, clear the message buffers after readingcddl}d|jdd}td|||ddddidS)Nrh_r^z,Created local browser session %s for task %srT session_name bb_session_idrWfeaturesuuiduuid4hexrCrn)rrrs r_create_local_sessionrskKKK/ ("-//L KK>g'''%dO   rcddl}d|jdd}td||||d|ddidS) z?Create a session that connects to a user-supplied CDP endpoint.rNcdp_r^u1Created CDP browser session %s → %s for task %s cdp_overrideTrr)rrWrrs r_create_cdp_sessionrsnKKK1$**,,*3B3/11L KKCgw000%#T*   rc|d}tt|t5|tvrt|cdddS dddn #1swxYwYt }|rt ||}n5t }|t|}n||}t5|tvrt|cdddS|t|<dddn #1swxYwY|S)a Get or create session info for the given task. In cloud mode, creates a Browserbase session with proxies enabled. In local mode, generates a session name for agent-browser --session. Also starts the inactivity cleanup thread and updates activity tracking. Thread-safe: multiple subagents can call this concurrently. Args: task_id: Unique identifier for the task Returns: Dict with session_name (always), bb_session_id + cdp_url (cloud only) Nr) rrrrrzrrrcreate_session)rr session_infoproviders r_get_session_infors"###W%%% -- & & &#G,-------- &--------------- %&&L<*7LAA &((  099LL#227;;L 11 & & &#G, 11111111 %1! 111111111111111 s)AA AC:$ C::C>C>ctjd}|r|Sg}dD]6}tj|r||7|tttj dtj dz }t|dz dz }tj|r|||r9tj |}tjd|}|r|Sttjj}|dz d z dz }|rt|Stjd }|s5|r3tjd tj |}|rd St%d ) a@ Find the agent-browser CLI executable. Checks in order: current PATH, Homebrew/common bin dirs, Hermes-managed node, local node_modules/.bin/, npx fallback. Returns: Path to agent-browser executable Raises: FileNotFoundError: If agent-browser is not installed z agent-browser)z/opt/homebrew/binz/usr/local/binr3r4rr )r" node_modulesz.binnpxznpx agent-browserzagent-browser CLI not found. Install it with: npm install -g agent-browser Or run 'npm install' in the repo root to install locally. Or ensure npx is available in your PATH.)shutilwhichr!r"r#r'extendr-rr9r:r;rmpathsepr&__file__parentr<FileNotFoundError) which_result extra_dirsdrFhermes_node_bin extended_path repo_root local_binnpx_paths r_find_agent_browserrs<00LJ 4!! 7==   !   a 244555rz~~mTY[[95LMMNNK+.677O w}}_%%+/***   33 |O-HHH   X%,IN*V3oEI9~~|E""H I I<BJOOJ,G,GHHH#""  3  rc|sdSgd}|D]Y}tj||}|r@|dd}|r|cSZdS)zHExtract a screenshot file path from agent-browser human-readable output.N)z6Screenshot saved to ['\"](?P/[^'\"]+?\.png)['\"]z0Screenshot saved to (?P/\S+?\.png)(?:\s|$)z(?P/\S+?\.png)(?:\s|$)r"z'")researchgrouprR)rpatternspatternmatchr"s r"_extract_screenshot_path_from_textr+s tH  '4((  ;;v&&,,..44U;;D  4rcommandargsr`c &|t}|pg} t}nD#t$r7}td|dt |dcYd}~Sd}~wwxYwddlm}|rdddS t|}nH#t$r;}td||dd t |dcYd}~Sd}~wwxYw| d r d |d g}n d |d g}| |zd|gz|z} tj td|d } tj| ddtd||| t%| itj} t)tj dt)jdz } t | dz dz } | dd}d| dD}| gt-zdt. dDz}t1|D];}tj |r||vr|d|j!| !}tj"|tj"|n-#tj"|tj"|wxYw |#|"nd#t>j$$rR|%|#td#|||| dd$|d%dcYSwxYwt7|d&5}|&}dddn #1swxYwYt7|d&5}|&}dddn #1swxYwY|j'}||fD]'} tj(|#tR$rY$wxYw|ri|*rU|dkr tVj,n tVj-}t.|d'||*dd(|*sK|dkrEtd)|d*| dd+d,z|pddd-|*}|rp t_j0|}|d.krp| d/r[| d0i}| d.s0| d1std2||S#t^j1$r|dd3} td4||| dd(|d5kr|pd*}!d6d7||!fD}"te|"}#|#rFt)|#3r%t4d8|#d|#| d9d:cYSdd;|d<| dcYSwxYw|dkrE|r|*nd=|}$td>|||$dd?d|$dSdid:S#t$r:}td@||dAdt |dcYd}~Sd}~wwxYw)Ba Run an agent-browser CLI command using our pre-created Browserbase session. Args: task_id: Task identifier to get the right session command: The command to run (e.g., "open", "click") args: Additional arguments for the command timeout: Command timeout in seconds. ``None`` reads ``browser.command_timeout`` from config (default 30s). Returns: Parsed JSON response from agent-browser Nzagent-browser CLI not found: %sFsuccessrr)is_interrupted Interruptedz0Failed to create browser session for task=%s: %sz"Failed to create browser session: rWz--cdpz --sessionrz--jsonagent-browser-iT)modeexist_okz/browser cmd=%s task=%s socket_dir=%s (%d chars)r3r4rr PATHrOcg|]}||Sr r .0ps r z(_run_browser_command..s???AQ?a???rrYcg|]}||Sr r r(s rr+z(_run_browser_command..s555Q15q555rAGENT_BROWSER_SOCKET_DIR_stdout__stderr_i)stdoutstderrstdinenvr_z9browser '%s' timed out after %ds (task=%s, socket_dir=%s)zCommand timed out after z secondsrzbrowser '%s' stderr: %siz>browser '%s' returned empty stdout with rc=0. cmd=%s stderr=%s ...snapshotr datarefsz]snapshot returned empty content. Possible stale daemon or CDP connection issue. returncode=%sz1browser '%s' returned non-JSON output (rc=%s): %s screenshot c3K|]}||V dSr r )r)parts r z'_run_browser_command..s;..!%t.......rzO_WRONLYO_CREATO_TRUNC subprocessPopenDEVNULLclosewaitTimeoutExpiredkillread returncodeunlinkr(rRloggingWARNINGDEBUGlogrkloadsJSONDecodeErrorrr<rn)%rrrr` browser_cmdrKr!r backend_args cmd_partstask_socket_dir browser_envrFr existing_path path_partscandidate_dirsr@ stdout_path stderr_path stdout_fd stderr_fdprocrHr0r1rTr*level stdout_textparsed snap_dataro stderr_text combined_textrecovered_path error_msgs% r_run_browser_commandrq@s &&(( :2D3)++ 3338!<<< 3q66222222223/.....~: =999Z(11 ZZZI7TUVVV +XPSTUPVPV+X+XYYYYYYYYZ ""C i!89 $\.%AB !!##l26  I N3',,  ! ! ;\.9 ; ;   O%$???? FgO8L8L N N N%n 2:>>-y9PQQRR kF2U:;;#33 ??!4!4S!9!9???  *,, -55***3//555 6  ^,, + +Dw}}T"" +t:'='=!!!T***!hhz22 F2A ./gll?4Hw4H4HII gll?4Hw4H4HII GKrz)ABJ)NPUVV GKrz)ABJ)NPUVV  #   ( D HY    HY     HY    HY     ] IIgI & & & &( ] ] ] IIKKK IIKKK NNV"GWo G G G$/['/[/[/[\\ \ \ \  ]+s # # qVVXXF                +s # # qVVXXF               _ {+  A  !       Xfllnn X'1QGOOGME JJu7&,,..QURUQUBV W W W||~~ 1*// NN."CHHYrr]$;$;e$C"Lb$3$/ 1 1 1 llnn ' & K00j((VZZ -B-B( & 62 6 6I$==44DY]]6=R=RD(78BDDD '   !%4%(R& CI???l**#)*>*E*E*G*G  Z* (,(6'*%%   %YYYTWYY3 > ??*0^ 6^R\6^6^I NNBEEGGlK]^kKlKl $$Y/// 111!-000001sA0BB21B2 max_charscFt||kr|S|d|dzS)z Simple truncation fallback for snapshots. Args: snapshot_text: The snapshot text to truncate max_chars: Maximum characters to keep Returns: Truncated text with indicator if truncated Nz [... content truncated ...])r)rrrs rrrDs2 =Y&& ) $'H HHrc ddlm}||rtjdddSt s4t s&t|stjdddSt|}|r4tjd|d|d|d |d d d Strdd l m }|||S|pd}t|}| dd}|rd|d<t|t|d|gt!t#d}| drC| di} | dd} | d|} t sPt sB| r@| |kr:t| s+t|ddgdtjdddSd| | d} gd} | t'fd| Dr d| d | d!<|rId"|vrE|d"}d#|D}| d$sd%| d&<|| d'<tj| d(Stjd| d)d*dd(S)+a Navigate to a URL in the browser. Args: url: The URL to navigate to task_id: Task identifier for session isolation Returns: JSON string with navigation result (includes stealth features info on first nav) r) _PREFIX_REFz_Blocked: URL contains what appears to be an API key or token. Secrets must not be sent in URLs.rz2Blocked: URL targets a private or internal addressrhostrulesource)rrr)r rblocked_by_policy)camofox_navigater _first_navTr><r_r r:titlerOrz about:blankr^z6Blocked: redirect landed on a private/internal address)r rr) z access deniedz#access to this page has been deniedblockedz bot detectedzverification requiredz please verifyzare you a robotcaptcha cloudflarezddos protectionzchecking your browserz just a momentzattention requiredc3 K|]}|vV dSr r )r)r title_lowers rrAz#browser_navigate..s(FF'w+%FFFFFFrz Page title 'a0' suggests bot detection. The site may have blocked this request. Options: 1) Try adding delays between actions, 2) Access different pages first, 3) Enable advanced stealth (BROWSERBASE_ADVANCED_STEALTH=true, requires Scale plan), 4) Some sites have very aggressive bot detection that may be unavoidable.bot_detection_warningrcg|] \}}|| Sr r )r)kvs rr+z$browser_navigate..s!CCCTQCqCCCrproxieszRunning WITHOUT residential proxies. Bot detection may be more aggressive. Consider upgrading Browserbase plan for proxy support.stealth_warningstealth_features ensure_asciirzNavigation failed)rrrrkdumpsrr _is_safe_urlr rtools.browser_camofoxrrr:_maybe_start_recordingrqr@rLrbanyr)rrrrreffective_task_idr is_first_navresultr:r final_urlrsblocked_patternsractive_featuresrs @rrrYs(''''' z9         ':'<'< \RUEVEV zI     #3''G zY'*1&/76?^efn^o!p!p     .::::::W---,9%%677L##L$77L2%* \"0111 !"3VcUCPdPfPfhjLkLk l l lF zz)9zz&"%%"%%HHUC(( !"" +>+@+@ Y S\`cScSclxzCmDmDSc !2F]OUW X X X X: Q       kkmm FFFF5EFFF F F \u\\\ , -  ;J,66#J/HCCX^^-=-=CCCO<< ** M*+,;H' (z(7777zZZ)<==   rctrddlm}||||S|pd}g}|s|dgt |d|}|dr|di}|dd}|d i} t |tkr|rt||}n't |tkrt|}d || rt | ndd } tj | d Stj d |dddd S)ag Get a text-based snapshot of the current page's accessibility tree. Args: full: If True, return complete snapshot. If False, return compact view. task_id: Task identifier for session isolation user_task: The user's current task (for task-aware extraction) Returns: JSON string with page snapshot r)camofox_snapshotrz-cr9r r:rOr;T)r r9 element_countFrrzFailed to get snapshotr) rrrrrqr:rSNAPSHOT_SUMMARIZE_THRESHOLDrrrkr) rrrsrrrrr:rrr;rss rrrs :::::::gy999,9 D  TF !"3Z F FF zz)zz&"%%R00 xx## }   < < < <5mYOOMM   "> > >.}==M%*.5SYYYA   z(7777zZZ)ABB   rc^trddlm}|||S|pd}|dsd|}t |d|g}|drt jd|dd St jd |d d |d d S)z Click on an element. Args: ref: Element reference (e.g., "@e5") task_id: Task identifier for session isolation Returns: JSON string with click result r) camofox_clickr@clickr T)r clickedFrrzFailed to click r)rrrr%rqr:rkr)rrrrrs rrrs+777777}S'***,9 >>#  #ii !"3Wse D DF zz) z    zZZ)AC)A)ABB   rcdtrddlm}||||S|pd}|dsd|}t |d||g}|drt jd||dd St jd |d d |d d S)z Type text into an input field. Args: ref: Element reference (e.g., "@e3") text: Text to type task_id: Task identifier for session isolation Returns: JSON string with type result r) camofox_typerrfillr T)r typedelementFrrzFailed to type into r)rrrr%rqr:rkr)rrrrrrs rrr+s0666666|Cw///,9 >>#  #ii""3Vc4[ I IF zz) z     zZZ)E)E)EFF   rcltrddlm}|||S|pd}|dvrtjdd|ddd St |d |g}|d rtjd |d d Stjd|dd|dd S)z Scroll the page. Args: direction: "up" or "down" task_id: Task identifier for session isolation Returns: JSON string with scroll result r)camofox_scrollr)rrFzInvalid direction 'z'. Use 'up' or 'down'.rrscrollr T)r scrolledrzFailed to scroll )rrrrkrrqr:)rrrrrs rrrQs&2888888~i111,9&&zL9LLL    ""3X { K KF zz) z!    zZZ)HY)H)HII   rcttrddlm}||S|pd}t|dg}|drC|di}t jd|dd d d St jd |d ddd S)z Navigate back in browser history. Args: task_id: Task identifier for session isolation Returns: JSON string with navigation result r) camofox_backrbackr r:TrrO)r rFrrzFailed to go backr)rrrrqr:rkr)rrrrr:s rrrws%666666|G$$$,9 !"3VR @ @F zz) zz&"%%z88E2&&    zZZ)<==   rc*trddlm}|||S|pd}t|d|g}|drt jd|dd St jd|d d |d d S) z Press a keyboard key. Args: key: Key to press (e.g., "Enter", "Tab") task_id: Task identifier for session isolation Returns: JSON string with key press result r) camofox_pressrpressr T)r pressedFrrzFailed to press r)rrrrqr:rkr)rrrrrs rrrs+777777}S'***,9 !"3Wse D DF zz) z    zZZ)AC)A)ABB   rctrddlm}||S|pd}t5|tv}dddn #1swxYwYt |ddd}|sd|d<t j|d S) z Close the browser session. Args: task_id: Task identifier for session isolation Returns: JSON string with close result r) camofox_closerNT)r closedz Session may not have been activerlFr)rrrrrrrkr)rrr had_sessionrss rrrs&777777}W%%%,9 <<'+;; <<<<<<<<<<<<<<<%&&&H A@ :hU 3 3 33s AAAc trddlm}|||S|pd}|rdgng}|rdgng}t|d|}t|d|}g}|drn|did gD]C} || d d | d d ddDg} |drY|didgD].} | | dd dd/t jd|| t|t| ddS)aGet browser console messages and JavaScript errors. Returns both console output (log/warn/error/info from the page's JS) and uncaught exceptions (crashes, unhandled promise rejections). Args: clear: If True, clear the message/error buffers after reading task_id: Task identifier for session isolation Returns: JSON string with console messages and JS errors r)camofox_consolerz--clearconsoleerrorsr r:r~rrYrrO)rrrr exception)rrT)r console_messages js_errorstotal_messages total_errorsFr) rrrrqr:r'rkrr) rrrr console_args error_argsconsole_result errors_resultr~msgrerrs rrrs/999999ug...,9"'/I;;RL %-)2J)*;Y UUN():HjQQMH)$$!%%fb1155j"EE  C OO..++#     F## $$VR0044XrBB  C MM779b11%     :$h--F      rc|tvrdS ttjdtjdz }|dz }d}|rlddl}t|5}| |pi}dddn #1swxYwY|didd}|sdS|d z }| d d td ddl }|j d} |d| d|dddz } t|ddt| g} | dr8t|t"d|| dSt"d| ddS#t($r&} t"d| Yd} ~ dSd} ~ wwxYw)z@Start recording if browser.record_sessions is enabled in config.Nr3r4r5Frr6record_sessionsbrowser_recordingsTparentsr%H max_age_hoursz %Y%m%d_%H%M%Ssession_rz.webmrecordrr z'Auto-recording browser session %s to %sz"Could not start auto-recording: %srzAuto-recording setup failed: %s)rrr!r9r:r;r<r=r>r?mkdir_cleanup_old_recordingsrstrftimerqrmaddrCrnrDrB) rrFrGrecord_enabledr=rHrIrecordings_dirr timestamprecording_pathrrKs rrrsZ%%%;2:>>-y9PQQRR !M1       R KKKk"" .annQ''-2 . . . . . . . . . . . . . . . WWY33778I5QQN  F$';;TD999b1111 !DM/22 '*TY*T*T"*T*T*TT%gx'3~CVCV9WXX ::i  T  # #G , , , KKA7N [ [ [ [ [ LL=vzz'?R?R S S S S S ;;; 6:::::::::;sIA/G <B  G B$$G 'B$(/G B?G .G G:G55G:c|tvrdS t|ddg}|drF|didd}td||n3#t $r&}td ||Yd}~nd}~wwxYwt|dS#t|wxYw) z1Stop recording if one is active for this session.Nrstopr r:r"rOz*Saved browser recording for session %s: %sz#Could not stop recording for %s: %s)rrqr:rCrnrBrDdiscard)rrr"rKs r_maybe_stop_recordingr&s)))-%gx&BB ::i  U::fb))--fb99D KKDgt T T T HHH :GQGGGGGGGGH ##G,,,,,##G,,,,s0A-A;:C ; B+B&!C &B++C C&cTtrddlm}||S|pd}d}t|d|g}|dr|di}|dd } t |t rtj|}n|}tj d |t|d d S#tj $rtj d gdddd cYSwxYwtj d |dddd S)z Get all images on the current page. Args: task_id: Task identifier for session isolation Returns: JSON string with list of images (src and alt) r)camofox_get_imagesraJSON.stringify( [...document.images].map(img => ({ src: img.src, alt: img.alt || '', width: img.naturalWidth, height: img.naturalHeight })).filter(img => img.src && !img.src.startsWith('data:')) )evalr r:rz[]T)r imagesrcFrzCould not parse image data)r rrcrlrzFailed to get imagesr) rrrrqr:rrmrkrZrrr[)rrrjs_coderr: raw_resultrs rrr5s+<<<<<<!!'***,9 G""3VgY G GF zz)zz&"%%XXh--  #*c** $J//#: V" ### # # # # #:7  " ### # # # #zZZ)?@@   s:AC *C:9C:rcztrddlm}||||Sddl}ddl}ddlm}|pd}ddlm}|dd} | d | j d z } | d d t| d g} |r| d| d| t| t|d| } | ds_| dd} t#}|dnd|d}t'jdd|d| ddS| did}|r ||} | sJt#}|dnd|d}t'jdd| d |d!ddS| }||d"}d#|}d$|d%}t3}t4d&t9|d'} dd(lm}|}|d)id*id+}|t?|}n#t@$rYnwxYwd*d,d-|d.d/d0|id1gd2gd3d4|d5}|r||d6<tCdBi|}|j"dj#j$pd7%}dd8l&m'}||}d |pd9t| d:}|r:| did;r| dd;|d;<t'j|dS#t@$r}}t4(d<|d =dd>t|d} | rt| | d?<d@| dA<t'j| dcYd}~Sd}~wwxYw)Ca6 Take a screenshot of the current page and analyze it with vision AI. This tool captures what's visually displayed in the browser and sends it to Gemini for analysis. Useful for understanding visual content that the text-based snapshot may not capture (CAPTCHAs, verification challenges, images, complex layouts, etc.). The screenshot is saved persistently and its file path is returned alongside the analysis, so it can be shared with users via MEDIA: in the response. Args: question: What you want to know about the page visually annotate: If True, overlay numbered [N] labels on interactive elements task_id: Task identifier for session isolation Returns: JSON string with vision analysis results and screenshot_path r)camofox_visionNrr)get_hermes_dirzcache/screenshotsbrowser_screenshotsbrowser_screenshot_z.pngTrrz --annotatez--fullr=r rz Unknown errorrcloud ()FzFailed to take screenshot (z mode): rrr:r"z#Screenshot file was not created at z (z mode). This may indicate a socket path issue (macOS /var/folders/), a missing Chromium install ('agent-browser install'), or a stale daemon process.asciizdata:image/png;base64,zCYou are analyzing a screenshot of a web browser. User's question: a" Provide a detailed and helpful answer based on what you see in the screenshot. If there are interactive elements, describe them. If there are verification challenges or CAPTCHAs, describe what type they are and what action might be needed. Focus on answering the user's specific question.z/browser_vision: analysing screenshot (%d bytes)g^@) load_config auxiliaryvisionr`rxr)rr image_urlr)rrryr<r|)r}r~rrr`rrOruz$Vision analysis returned no content.)r analysisscreenshot_path annotationszbrowser_vision failed: %srBzError during vision analysis: rz\Screenshot was captured but vision analysis failed. You can still share it via MEDIA:.noter ))rrrbase64rpathlibrhermes_constantsrrrr_cleanup_old_screenshotsr'rmrqr:r provider_namerkrr< read_bytes b64encodedecoderSrCrDrhermes_cli.configrfloatrBr rrr{rRrrvrl)!rrrrr uuid_modrrrscreenshots_dirrscreenshot_argsr error_detail_cpr$actual_screenshot_path image_data image_base64data_url vision_prompt vision_modelvision_timeoutr_cfg_vtrrsrrv response_datarK error_infos! rrros(;888888~h':::MMM,90/////$n%8:OPPO%(Xhnn>N>N>R(X(X(XXOx:dT::: !CCCC  1  " "< 0 0 0x(((s?33444%      zz)$$ #!::g??L%''C!k77/O9J9J9L9L/O/O/OD: StSS\SS"### # "(FB!7!7!;!;F!C!C ! ;"d#9::O%%'' #%''C!k77/O9J9J9L9L/O/O/OD: 2/22T222"### #%//11 '' 33::7CC :L:: @ ( @ @ @ )**  F__ & & &   5 5 5 5 5 5;==D((;++//"==AA)LLC!&s    D #!'??!,E8;LMM %    0#/K **k**$Q'/7=2DDFF666666((22 J$J"?33   I 62..22=AA I+1&>-+HM- (z-e<<<<  : : : 2AEEE!&1ZRUVWRXRX1Z1Z[[  ! ! # # @,/,@,@J( )!Jv z*5999999999 :sT'C>-y9PQQRR $';;$$&&  F  45$$%566 K KA K6688$v--HHJJJ K K K CQJJJJJJJJ K  K K FFF A1EEEEEEEEEFsHAC6",C61CC6 C1 C,'C6,C11C66 D&D!!D&cH|d}td|tdttt 5t|}dddn #1swxYwY|r|dd}td||t| t|dgd td |n3#t$r&}t d ||Yd}~nd}~wwxYwt 5t |dt |ddddn #1swxYwY|rYt}|I ||n2#t$r%}t d |Yd}~nd}~wwxYw|dd}|rbtjt%d|}tj|rtj||d}tj|r t+t-|}tj|t4jtd||n>#t8t:t<t>f$rtd|YnwxYwtAj!|dtd|dStd|dS)a  Clean up browser session for a task. Called automatically when a task completes or when inactivity timeout is reached. Closes both the agent-browser session and the Browserbase session. Args: task_id: Task identifier to clean up Nrz&cleanup_browser called for task_id: %szActive sessions: %srunknownz+Found session for task %s: bb_session_id=%srOr^r_z1agent-browser close command completed for task %sz*agent-browser close failed for task %s: %sz)Could not close cloud browser session: %srrOr#z.pidzKilled daemon pid %s for %sz?Could not kill daemon pid for %s (already dead or inaccessible)T) ignore_errorsz$Removed task %s from active sessionsz'No active session found for task_id: %s)"rCrDrrkeysrr:rrqrBrlpoprr close_sessionr!r"r&rr<isfilerAr read_textrRrRsignalSIGTERMProcessLookupError ValueErrorPermissionErrorr(rrmtree) rrrrKrr socket_dirpid_file daemon_pids rrr<s  LL97CCC LL&-=-B-B-D-D(E(EFFF 55'++G44 555555555555555.I$(()DD  BG][[[ g&&& U '2r B B B B LLLg V V V V U U U NNGRS T T T T T T T T U 6 6  $ / / / " & &w 5 5 5 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6  S*,,H#S**=9999 SSSNN#NPQRRRRRRRRS$'';;  >&9&;&;=\l=\=\]]Jw~~j)) >7<< |4I4I4IJJ7>>(++vv%(h)A)A)C)C)I)I)K)K%L%L  FN;;; %BJP\]]]]. OWUvvv %fhtuuuuuv j==== ;WEEEEE >HHHHHsg&B  BB.D D<D77D<7F  F F 'F== G,G''G,A;L8MMct5tt}dddn #1swxYwY|D]}t |dS)zX Clean up all active browser sessions. Useful for cleanup on shutdown. N)rrrr.r)task_idsrs rrrs 11(--//00111111111111111!!    !!s ';??cvt5tcdddS#1swxYwYdS)z Get information about active browser sessions. Returns: Dict mapping task_id to session info (session_name, bb_session_id, cdp_url) N)rrcopyr rrget_active_browser_sessionsr@s} ''$$&&''''''''''''''''''s .22ctrdS tn#t$rYdSwxYwt}||sdSdS)az Check if browser tool requirements are met. In **local mode** (no Browserbase credentials): only the ``agent-browser`` CLI must be findable. In **cloud mode** (BROWSERBASE_API_KEY set): the CLI *and* both ``BROWSERBASE_API_KEY`` / ``BROWSERBASE_PROJECT_ID`` must be present. Returns: True if all requirements are met, False otherwise TF)rrr rr)rs rcheck_browser_requirementsrBs{t uu#$$HH$:$:$<$<u 4s ! //__main__u🌐 Browser Tool Modulez(========================================rrrz Mode: u✅ All requirements metu❌ Missing requirements:z - agent-browser CLI not foundzO Install: npm install -g agent-browser && agent-browser install --with-depsz - z credentials not configuredzL Tip: set browser.cloud_provider to 'local' to use free local mode insteadu 📋 Available Browser Tools:u 🔹 rz: rrr7u 💡 Usage:zC from tools.browser_tool import browser_navigate, browser_snapshotzE result = browser_navigate('https://example.com', task_id='my_task')z0 snapshot = browser_snapshot(task_id='my_task'))registryc i|] }|d| S)rr )r)ss r rGsBBBqy!BBBrr6c rt|dd|dS)NrrOr)rr)rr:rkws rrrs2/DHHUB4G4GQSQWQWXaQbQbcccru🌐)rtoolsetschemahandlercheck_fnemojic t|dd|d|dS)NrFrrs)rrrs)rr:rIs rrrsG/ XXfe $ $bffY.?.?266R]K^K^ ` ` `ru📸c rt|dd|dS)NrrOr)rr)rr:rIs rrr.}%1D1DbffU^N_N_```ru👆c t|dd|dd|dS)NrrOrr)rrr)rr:rIs rrrsC|0C0C$((SY[]J^J^hjhnhnoxhyhyzzzru⌨️c rt|dd|dS)Nrrr)rr)rr:rIs rrrs1~f8U8U_a_e_efo_p_pqqqru📜c Ht|dSNrr)rr:rIs rrrs|BFF94E4EFFFru◀️c rt|dd|dS)NrrOr)rr)rr:rIs rrrrRrc Ht|dSrV)rr:rIs rrr's}RVVI5F5FGGGru🚪c Ht|dSrV)rr:rIs rrr/s1"&&:K:KLLLru🖼️c t|dd|dd|dS)NrrOrFr)rrr)rr:rIs rrr7sg~txx B7O7OZ^ZbZbcmotZuZu@B@F@FGP@Q@Q R R Rru👁️c rt|dd|dS)NrFr)rr)rr:rIs rrr?s1TXXgu5M5MWYW]W]^gWhWhiiiru🖥️r )NN)r1)FNN)FN)r)r)rN)__doc__atexitrkrVr!rr3rLrrrrrritypingrrrrr ragent.auxiliary_clientr tools.website_policyr rBtools.url_safetyrrtools.browser_providers.baser#tools.browser_providers.browserbaser#tools.browser_providers.browser_usertools.tool_backend_helpersrrrr ImportError getLogger__name__rCrFrrmr-r.rr__annotations__rEDEFAULT_SESSION_TIMEOUTrrArLrSrVrwrzr|rr}rrr~rrrrrrrrrsetrrr9r:rrrrLockrrregisterrrrrrBROWSER_TOOL_SCHEMASrrrrrrqrrrrrrrrrrrrrrrr rrrr@rBprintrr r$r rrLtools.registryrD_BROWSER_SCHEMA_MAPr rrrrs000d    ,,,,,,,,,,,,++++++,9999999,,,++,%<<<<<<<%%%$$LLL%======CCCCCCBBBBBBGGGGGG %IIIIIII%%%$}%  8 $ $ C d3i.57c5j!1666 $#c####*C8C=CCCC Hx}HHHH .3.3....bH3HHHH'%''DdO :>!56=== $-1HTN111'"X&:;'"'"'"'"T7$sCx.)A7777 /c3h//// ))))) ?4 ? ? ? ?&T&&&&2!S!!!!&/1$sDcN*+000355S  &)S8TV[)\)\%]%]",.S%Z(---   $$$B/000TTT8, p p p (((6c6666,---#F$#Y      #w%$V$     k$#b      E%#Z %#D     &!x$!6N#8%     }   k$#_       W  %M  !s%#~ &$$T  $   ("q%$#U   SX~ 3 4S>      s tCH~    00x}0S#X0000h7S7777tSXc]0! I3I3 I3 I3 s)I3c] I3  #s(^ I3I3I3I3\ $515151}51 51515151pIIcIcISIIII*vv#v vvvvvt!#33 3 c]3}3 3333l  s Xc] c    F##c##x}#####L##c#HSM#S####L(3-3<sXc]c<448C=4C4444:0040(3-030000f ;C ; ; ; ;F -3 - - - -77 77777t[:[:S[:D[:8C=[:\_[:[:[:[:|GGGG0FFFF.CICIXc]CIdCICICICIL ! ! ! !'T#tCH~*=%>''''DF z E $%%% E(OOO    Ck77'G1B1B1D1D'G'G'GD E d  "!## b ()))) )*** e   ! ! ! !  e e e E4 5 5 5 Ec d d d d d e ?3#4#4#6#6? EJ#++--JJJ K K K E` a a a E +,,,&KK IvII&*?*DIIIJJJJ E/ E OPPP E QRRR E <=== $#####BB-ABBB   1 2 c c '     1 2 ` ` '     / ` ` '     ~ . z z '     / 0 q q '     ~ . F F '      / ` ` '      / G G '     3 4 L L '     / 0 R R '     0 1 i i '  sHAA#"A#'A..A98A9BB'&B' SS76S7