PL jvdZddlmZddlZddlmZmZddlmZej e Z GddeZ dS)u DuckDuckGo search — plugin form (via the ``ddgs`` package). Subclasses the plugin-facing :class:`agent.web_search_provider.WebSearchProvider`. The legacy in-tree module ``tools.web_providers.ddgs`` was removed in the same commit that moved this code under ``plugins/``; this file is now the canonical implementation. The ``ddgs`` package is an optional dependency. ``is_available()`` reflects whether the package is importable; the plugin still registers either way so ``hermes tools`` can prompt the user to install it. ) annotationsN)AnyDict)WebSearchProvidercleZdZdZeddZeddZddZddZdd Z dddZ ddZ dS)DDGSWebSearchProvideraDuckDuckGo HTML-scrape search provider. No API key needed. Rate limits are enforced server-side by DuckDuckGo; the provider surfaces ``DuckDuckGoSearchException`` and other ddgs errors as ``{"success": False, "error": ...}`` rather than raising. returnstrcdS)Nddgsselfs =/home/kuhnn/.hermes/hermes-agent/plugins/web/ddgs/provider.pynamezDDGSWebSearchProvider.namesvcdS)NDuckDuckGo (ddgs)r rs r display_namez"DDGSWebSearchProvider.display_name#s""rboolc2 ddl}dS#t$rYdSwxYw)uReturn True when the ``ddgs`` package is importable. Probes the import once; cheap because Python caches the import. Must NOT perform network I/O — runs at tool-registration time and on every ``hermes tools`` paint. rNTF)r ImportError)rr s r is_availablez"DDGSWebSearchProvider.is_available's7  KKK4   55 s  cdS)NTr rs rsupports_searchz%DDGSWebSearchProvider.supports_search5strcdS)NFr rs rsupports_extractz&DDGSWebSearchProvider.supports_extract8surquerylimitintDict[str, Any]c , ddlm}n#t$rdddcYSwxYwtdt |} g}|5}t |||D]\}}||krnt|dp|d pd } | t|d d | t|d d |dzd dddn #1swxYwYn:#t$r-} t d| dd| dcYd} ~ Sd} ~ wwxYwt d|t||dd|idS)z:Execute a DuckDuckGo search and return normalized results.r)DDGSFu8ddgs package is not installed — run `pip install ddgs`)successerror) max_resultshrefurltitlebody)r,r* descriptionpositionNzDDGS search error: %szDuckDuckGo search failed: z'DDGS search '%s': %d results (limit %d)Tweb)r%data)r r$rmaxr! enumeratetextr getappend Exceptionloggerwarninginfolen) rrr r$ safe_limit web_resultsclientihitr*excs rsearchzDDGSWebSearchProvider.search;s5  ! ! ! ! ! ! !    S    CJJ''  SK 6' Ez (R(RSS  FAsJcggfooEE2FFC&&%(")=)=%>%>#&+.swwvr/B/B+C+C()A                 S S S NN2C 8 8 8$/QC/Q/QRR R R R R R R S  =uc+FVFVX]^^^%)=>>>sN  D+C D D+D##D+&D#'D++ E"5"EE"E"cdddgddS)Nrufree · no key · search onlyuRSearch via the ddgs Python package — no API key (pair with any extract provider)r )rbadgetagenv_vars post_setupr rs rget_setup_schemaz&DDGSWebSearchProvider.get_setup_schema_s"'4g!   rN)r r )r r)r)rr r r!r r")r r") __name__ __module__ __qualname____doc__propertyrrrrrrBrHr rrrrsX###X#    "?"?"?"?"?H       rr) rL __future__rloggingtypingrragent.web_search_providerr getLoggerrIr8rr rrrSs  #"""""777777  8 $ $Q Q Q Q Q -Q Q Q Q Q r