nSjHdZddlmZddlZddlZddlmZmZddlm Z ej e Z dZ Gdde ZdS) uBBrave Search (free tier) — plugin form. Subclasses :class:`agent.web_search_provider.WebSearchProvider` (the plugin-facing ABC). The legacy in-tree module ``tools.web_providers.brave_free`` was removed in the same commit that moved this code under ``plugins/``; this file is now the canonical implementation. Config keys this provider responds to:: web: search_backend: "brave-free" # explicit per-capability backend: "brave-free" # shared fallback Auth env var:: BRAVE_SEARCH_API_KEY=... # https://brave.com/search/api/ (free tier) ) annotationsN)AnyDict)WebSearchProviderz.https://api.search.brave.com/res/v1/web/searchcleZdZdZeddZeddZddZddZdd Z dddZ ddZ dS)BraveFreeWebSearchProvideruSearch-only Brave provider using the free-tier Data-for-Search API. Free tier is 2,000 queries/month (1 qps). No content-extraction capability — users pair this with Firecrawl/Tavily/Exa for ``web_extract``. returnstrcdS)Nz brave-freeselfs A/home/ice/.hermes/hermes-agent/plugins/web/brave_free/provider.pynamezBraveFreeWebSearchProvider.name(s |cdS)NBrave Search (Free)r r s r display_namez'BraveFreeWebSearchProvider.display_name.s$$rboolc>ddlm}t|dS)zFReturn True when ``BRAVE_SEARCH_API_KEY`` is set to a non-empty value.rget_provider_envBRAVE_SEARCH_API_KEY)agent.web_search_providerrr)rrs r is_availablez'BraveFreeWebSearchProvider.is_available2s/>>>>>>$$%;<<===rcdS)NTr r s rsupports_searchz*BraveFreeWebSearchProvider.supports_search8strcdS)NFr r s rsupports_extractz+BraveFreeWebSearchProvider.supports_extract;surquerylimitintDict[str, Any]cddl}ddlm}|d}|sdddStdt t |d } |t||d |d d d }|ny#|j $r7}t d|dd|j j dcYd}~Sd}~w|j$r-}t d|dd|dcYd}~Sd}~wwxYw |} n7#t $r*}t d|dddcYd}~Sd}~wwxYw| dpidgpg} | d|} dt#| D} td|t'| t'| |dd| idS)zExecute a search against the Brave Search API. Returns ``{"success": True, "data": {"web": [{"title", "url", "description", "position"}]}}`` on success, or ``{"success": False, "error": str}`` on failure. rNrrFzBRAVE_SEARCH_API_KEY is not set)successerror)qcountzapplication/json)zX-Subscription-TokenAccept)paramsheaderstimeoutzBrave Search HTTP error: %szBrave Search returned HTTP zBrave Search request error: %szCould not reach Brave Search: z%Brave Search response parse error: %sz-Could not parse Brave Search response as JSONwebresultsc g|]r\}}t|ddt|ddt|dd|dzdsS)titleurl descriptionr()r4r6r7position)r get).0irs r z5BraveFreeWebSearchProvider.search..ms   1 QUU7B//00155++,,"155#;#;<<E      rz5Brave Search '%s': %d results (from %d raw, limit %d)T)r&data)httpxrrmaxminr#r9_BRAVE_ENDPOINTraise_for_statusHTTPStatusErrorloggerwarningresponse status_code RequestErrorjson Exception enumerateinfolen) rr!r"r?rapi_keyr+respexcr> raw_results truncated web_resultss rsearchz!BraveFreeWebSearchProvider.search>s  >>>>>>""#9:: R$/PQQ QAs3u::r**++ W99"U33,30D  ! ! # # # #$    NN8# > > > Qs|7OQQ      ! W W W NN;S A A A$/UPS/U/UVV V V V V V V W `99;;DD ` ` ` NNBC H H H$/^__ _ _ _ _ _ _ `xx,"11)R@@FB '   "),,     C             %)=>>>sN 8B C8 ,B>8C8> C8 "C3-C83C8<D EE:EEcdddddddgdS) Nrfreeu1Free-tier API key — 2k queries/mo, search only.rz Brave Search API key (free tier)zhttps://brave.com/search/api/)keypromptr6)rbadgetagenv_varsr r s rget_setup_schemaz+BraveFreeWebSearchProvider.get_setup_schemas4)F2@:   rN)r r )r r)r )r!r r"r#r r$)r r$) __name__ __module__ __qualname____doc__propertyrrrrrrUr]r rrrr!s X %%%X%>>>> A?A?A?A?A?F       rr)ra __future__rloggingostypingrrrr getLoggerr^rErBrr rrrhs&#""""" 777777  8 $ $Bl l l l l !2l l l l l r