`gjH~dZddlmZddlZddlZddlmZmZddlm Z eje Z dZ Gdde Zy) 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/searchc^eZdZdZed dZed dZd dZd dZd dZ d d dZ ddZ y )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``. cy)Nz brave-freeselfs R/root/.hermes/venv/lib/python3.12/site-packages/plugins/web/brave_free/provider.pynamezBraveFreeWebSearchProvider.name(scy)NBrave Search (Free)r r s r display_namez'BraveFreeWebSearchProvider.display_name.s$rc0ddlm}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_providerrbool)r rs r is_availablez'BraveFreeWebSearchProvider.is_available2s>$%;<==rcy)NTr r s r supports_searchz*BraveFreeWebSearchProvider.supports_search8srcy)NFr r s r supports_extractz+BraveFreeWebSearchProvider.supports_extract;src ddl}ddlm}|d}|sdddStdt t |d } |j t||d |d d d }|j |j} | j dxsij dgxsg} | d|} t#| D cgc]Z\} } t%| j ddt%| j ddt%| j dd| dzd\}} } tj'd|t)|t)| |dd|idS#|j$r<}tjd|dd|jjdcYd}~Sd}~w|j$r(}tjd|dd|dcYd}~Sd}~wwxYw#t $r%}tjd|dddcYd}~Sd}~wwxYwcc} } w)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 JSONwebresultstitleurl description)r,r.r/positionz5Brave Search '%s': %d results (from %d raw, limit %d)T)rdata)httpxrrmaxminintget_BRAVE_ENDPOINTraise_for_statusHTTPStatusErrorloggerwarningresponse status_code RequestErrorjson Exception enumeratestrinfolen)r querylimitr2rapi_keyr$respexcr1 raw_results truncatedir web_resultss r searchz!BraveFreeWebSearchProvider.search>s >"#9:$/PQ QAs3u:r*+ W99"U3,30D  ! ! # `99;D xx,"11)R@FB ' "), 1 QUU7B/0155+,"155#;<E      C         %)=>>K$$  NN8# > 6s||7O7O6PQ !! W NN;S A$1OPSu/UV V W  ` NNBC H$/^_ _ ` sT/E *G 6AG> G 1F G G "G?G G  G;G60G;6G;cdddddddgdS) Nrfreeu1Free-tier API key — 2k queries/mo, search only.rz Brave Search API key (free tier)zhttps://brave.com/search/api/)keypromptr.)rbadgetagenv_varsr r s r get_setup_schemaz+BraveFreeWebSearchProvider.get_setup_schemas*)F2@:  rN)returnrB)rXr))rErBrFr5rXDict[str, Any])rXrZ) __name__ __module__ __qualname____doc__propertyrrrrrrOrWr rr rr!sJ  %%> A?F  rr)r^ __future__rloggingostypingrrrr getLoggerr[r:r7rr rr resA&# 7   8 $Bl !2l r