+ iHjtRt^RIHt^RIt^RIt^RIHtHtHt^RI H t RRlt RRlt !R R ] 4t R#) ayWeb Search Provider ABC. The single plugin-facing surface every web provider (brave-free, ddgs, searxng, exa, parallel, tavily, keenable, firecrawl) implements; registered via ``PluginContext.register_web_search_provider()`` and selected by ``web.search_backend`` / ``web.extract_backend`` / ``web.backend``. Response shapes (legacy contract, the tool wrapper does not translate):: search: {"success": True, "data": {"web": [{"title", "url", "description", "position"}, ...]}} extract: {"success": True, "data": [{"url", "title", "content", "raw_content", "metadata"}, ...]} failure: {"success": False, "error": str} ) annotationsN)AnyDictList) ProviderBasec V^8dQhRRRR/#)namestrreturn)formats">/home/ubuntu/.hermes/hermes-agent/agent/web_search_provider.py __annotate__rs33c^RIHpV!V4p\4wrVVf%V'dV'g^RIHpV!VRV: R24hVf V'g\P!VR4pT;'gRP4# \d:p^RIHpM \ dRpMi;i\ Y44'dhRpRp?LRp?ii;i)uWConfig-aware env lookup (``os.environ`` first, then ``~/.hermes/.env``) so credentials set through the config layer are visible in gateway sessions / delegate children / subprocess runs. Stripped value, or ``""`` when unset. Falls back to a bare ``os.getenv`` when the config module is unavailable (stripped installs, early import contexts). See #40190. Never when a profile secret scope is bound: a scoped miss means the served profile has no key, and ``os.environ`` holds the LAUNCH profile's — a routed profile without an Exa/Parallel key must be refused, not search on another profile's key. ) get_env_value)UnscopedSecretErrorNzget_provider_env(z%) called with no active profile scoper ) hermes_cli.configr Exceptionagent.secret_scoper ImportError isinstance_secret_scope_stateosgetenvstrip)r rvalexcr scope_boundmultiplex_actives& rget_provider_envr"s 3D!%8$9!K {' :!$*;D8Ch(ijj {;iib! II2     % > %"$  % c / / s5B C BC B$!C#B$$CCcV^8dQhRR/#)rr ztuple[bool, bool]r )r s"rrr8sEE.ErcZ^RIHpHpT!4RJT!43# \dRu#i;i)current_secret_scopeis_multiplex_activeN)FF)rr'r(rr&s rrr8s:P ! -/B/D DD s  **c]tRt^@tRt]P RRl4tRRltRRlt RR lt RR R llt R R lt Rt R#)WebSearchProviderzAbstract base class for a web search/extract backend: implement :meth:`is_available` and at least one of :meth:`search` / :meth:`extract`; the ``supports_*`` flags route each capability.cV^8dQhRR/#rr boolr )r s"rrWebSearchProvider.__annotate__Esmmdmrc R#)uTrue when this provider can service calls. Cheap check only (env var, importable dep, instance URL) — NO network; runs at tool registration and on every ``hermes tools`` paint.Nr selfs&r is_availableWebSearchProvider.is_availableDsrcV^8dQhRR/#r,r )r s"rrr.Isrc R#)z0True if this provider implements :meth:`search`.Tr r0s&rsupports_search!WebSearchProvider.supports_searchIsrcV^8dQhRR/#r,r )r s"rrr.Msdrc R#)aHTrue when this provider can serve calls WITHOUT credentials (public anonymous free tiers such as Exa / Parallel MCP); used only when NO provider is configured or keyed. Must never make :meth:`is_available` True, or the legacy preference walk would route keyed users onto a higher-priority backend's free tier. Cheap, no network.Fr r0s&ris_keyless_available&WebSearchProvider.is_keyless_availableMs rcV^8dQhRR/#r,r )r s"rrr.Ts$rc R#)uwTrue if this provider implements :meth:`extract` (sync or ``async def`` — the dispatcher awaits coroutine functions).Fr r0s&rsupports_extract"WebSearchProvider.supports_extractTsrc$V^8dQhRRRRRR/#)rqueryr limitintr zdict[str, Any]r )r s"rrr.Ys!  C  N rc 2\VP R24h)z>Execute a web search. Callers gate on :meth:`supports_search`.z3 does not support search (override supports_search)NotImplementedErrorr )r1rArBs&&&rsearchWebSearchProvider.searchYs!yykL M  rc$V^8dQhRRRRRR/#)rurlsz list[str]kwargsrr r )r s"rrr._s!  I   rc 2\VP R24h)aExtract content from URLs (callers gate on :meth:`supports_extract`); may be ``async def``. Returns ``[{"url", "title", "content", "raw_content", "metadata"?, "error"?}, ...]`` (``error`` only on per-URL failure). Ignore unknown ``kwargs`` (``format``, ``include_raw``, ``max_chars``).z5 does not support extract (override supports_extract)rE)r1rJrKs&&,rextractWebSearchProvider.extract_s "yykN O  rr N))__name__ __module__ __qualname____firstlineno____doc__abcabstractmethodr2r6r:r>rGrM__static_attributes__r rrr*r*@sBm mm    rr*)rT __future__rrUrtypingrrragent.provider_baserr"rr*r rrr[s6 # "",@E% % r