§ ,Vj4 ãór—dZddlmZddlmZmZddlmZmZm Z Gd„de¦«Z Gd„de¦«Z d S) z3Abstract base classes for web capability providers.é)Ú annotations)ÚABCÚabstractmethod)ÚAnyÚDictÚListcó\—eZdZdZedd„¦«Zedd„¦«Zeddd „¦«Zd S)ÚWebSearchProvideraŠInterface for web search backends (Firecrawl, Tavily, Exa, etc.). Implementations live in sibling modules. The user selects a provider via ``hermes tools``; the choice is persisted as ``config["web"]["search_backend"]`` (falling back to ``config["web"]["backend"]``). Search providers return results in a normalized format:: { "success": True, "data": { "web": [ {"title": str, "url": str, "description": str, "position": int}, ... ] } } On failure:: {"success": False, "error": str} ÚreturnÚstrcó—dS©z9Short, human-readable name shown in logs and diagnostics.N©©Úselfs ú6/root/.hermes/hermes-agent/tools/web_providers/base.pyÚ provider_namezWebSearchProvider.provider_name"ó€€€óÚboolcó—dS©u¶Return True when all required env vars / credentials are present. Called at tool-registration time to gate availability. Must be cheap — no network calls. Nrrs rÚ is_configuredzWebSearchProvider.is_configured&rréÚqueryÚlimitÚintúDict[str, Any]có—dS)z3Execute a web search and return normalized results.Nr)rrrs rÚsearchzWebSearchProvider.search.rrN©r r ©r r)r)rr rrr r)Ú__name__Ú __module__Ú __qualname__Ú__doc__rrrr rrrr r sŽ€€€€€ððð0ðHðHðHñ„^ðHðð ð ð ñ„^ð ððBðBðBðBñ„^ðBðBðBrr cóZ—eZdZdZed d„¦«Zed d„¦«Zedd „¦«Zd S)ÚWebExtractProviderahInterface for web content extraction backends. Implementations live in sibling modules. The user selects a provider via ``hermes tools``; the choice is persisted as ``config["web"]["extract_backend"]`` (falling back to ``config["web"]["backend"]``). Extract providers return results in a normalized format:: { "success": True, "data": [ {"url": str, "title": str, "content": str, "raw_content": str, "metadata": dict}, ... ] } On failure:: {"success": False, "error": str} r r có—dSrrrs rrz WebExtractProvider.provider_nameKrrrcó—dSrrrs rrz WebExtractProvider.is_configuredOrrÚurlsú List[str]rc ó—dS)zBExtract content from the given URLs and return normalized results.Nr)rr+Úkwargss rÚextractzWebExtractProvider.extractWrrNr!r")r+r,r r)r#r$r%r&rrrr/rrrr(r(3sˆ€€€€€ððð.ðHðHðHñ„^ðHðð ð ð ñ„^ð ððQðQðQñ„^ðQðQðQrr(N) r&Ú __future__rÚabcrrÚtypingrrrr r(rrrúr3sÄðØ9Ð9à"Ð"Ð"Ð"Ð"Ð"à#Ð#Ð#Ð#Ð#Ð#Ð#Ð#Ø"Ð"Ð"Ð"Ð"Ð"Ð"Ð"Ð"Ð"ð'Bð'Bð'Bð'Bð'B˜ñ'Bô'Bð'BðT&Qð&Qð&Qð&Qð&Q˜ñ&Qô&Qð&Qð&Qð&Qr