PL jdZddlmZddlZddlZddlmZmZddlm 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 C/home/kuhnn/.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$$rboolcjttjddS)zFReturn True when ``BRAVE_SEARCH_API_KEY`` is set to a non-empty value.BRAVE_SEARCH_API_KEY)rosgetenvstripr s r is_availablez'BraveFreeWebSearchProvider.is_available2s)BI4b99??AABBBrcdS)NTr r s rsupports_searchz*BraveFreeWebSearchProvider.supports_search6strcdS)NFr r s rsupports_extractz+BraveFreeWebSearchProvider.supports_extract9surquerylimitintDict[str, Any]cddl}tjdd}|sdddSt dt t |d } |t||d |d d d }| ny#|j $r7}t d|dd|j jdcYd}~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)titlerurl descriptionr))r5r6r7position)r get).0irs r z5BraveFreeWebSearchProvider.search..is   1 QUU7B//00155++,,"155#;#;<<E      rz5Brave Search '%s': %d results (from %d raw, limit %d)T)r'data)httpxrrrmaxminr$r9_BRAVE_ENDPOINTraise_for_statusHTTPStatusErrorloggerwarningresponse status_code RequestErrorjson Exception enumerateinfolen) rr"r#r?api_keyr,respexcr> raw_results truncated web_resultss rsearchz!BraveFreeWebSearchProvider.search<s  )2B77==?? 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             %)=>>>sN8B D",CD D!"D D DD'' E1EEEcdddddddgdS) 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_schema}s4)F2@:   rN)r r )r r)r!)r"r r#r$r r%)r r%) __name__ __module__ __qualname____doc__propertyrrrrr rUr]r rrrr!s X %%%X%CCCC??????????B       rr)ra __future__rloggingrtypingrragent.web_search_providerr getLoggerr^rErBrr rrrhs&#""""" 777777  8 $ $Bh h h h h !2h h h h h r