+ kHj7Rt^RIHt^RIt^RIt^RIt^RIHtHtH t H t ^RI H t H tHtHtHt^RIHtHtHt]P.!]4tRt^Zt^t]P:!R]P<4tRR lt R R lt!R R lt"!RR] 4t#R#)uxAI Web Search — search-only provider backed by Grok's server-side ``web_search`` tool on the Responses API (https://docs.x.ai/developers/tools/web-search); Grok is asked for structured JSON so rows match every other Hermes web provider. Config: ``web.backend: "xai"``; optional ``web.xai``: ``model`` (default grok-build-0.1), ``allowed_domains`` / ``excluded_domains`` (max 5, mutually exclusive), ``timeout`` (default 90s). Auth: Grok OAuth via ``hermes auth``, else XAI_API_KEY. ) annotationsN)AnyDictListOptional)BaseWebSearchProvider search_fail search_ok setup_schema title_hit)has_xai_credentialshermes_xai_user_agentresolve_xai_http_credentialszgrok-build-0.1z \{[\s\S]*\}cV^8dQhRR/#returndict[str, Any])formats"=/home/ubuntu/.hermes/hermes-agent/plugins/web/xai/provider.py __annotate__rs  n c^RIHpV!4pRF,p\V\4'dVP V4MRpK. \V\4'dV#/# \ d#p\ PRT4/uRp?#Rp?ii;i)z7Read ``web.xai`` from config.yaml (returns {} on miss).) load_configNz!Could not load web.xai config: %s)webxai)hermes_cli.configr isinstancedictget Exceptionloggerdebug)rcfgkeyexcs r_load_xai_web_configr'sq1m!C",S$"7"7#''#,TC" d++s33  8#> s$AAA B&B=BBc V^8dQhRRRR/#)rvaluerrz list[str]r)rs"rrr)sOOsOyOrc\V\4'dXVUu.uFCp\V\4'gKVP4'gK3VP4NKE upR\#.#uupiN)rliststrstrip_MAX_DOMAIN_FILTERS)r)items& r_coerce_domain_listr1)shoyzBFpGpGU UUTjs.CL LDJJLU UVjWj kOMOO UsA0A0A0c$V^8dQhRRRRRR/#)rr)rdefaultrr)rs"rrr-s!ssrcFV!V4# \\3dTu#i;ir+) TypeError ValueError)castr)r3s&&&r_coercer8-s*E{ z "s    c]tRt^4tRtRtRtRRltRRRllt] RR l4t ] R R l4t ] R R l4t ] RRl4t] RRl4t] RRl4t] RRl4tRRltRtR#)XAIWebSearchProvideruSends a structured prompt with ``tools=[{"type": "web_search"}]`` and parses the JSON Grok returns; falls back to message annotations, then ``citations``. Trust model: Grok *generates* the URLs/titles/descriptions and is steerable by the query text — validate before fetching.rxAI Web Search (Grok)cV^8dQhRR/#)rrboolr)rs"rr!XAIWebSearchProvider.__annotate__<s%%d%rc \4#)zCheap probe (env var OR auth-store tokens). Deliberately NOT ``resolve_xai_http_credentials``: must never refresh tokens or take the auth-store lock, since this runs on every ``hermes tools`` repaint.)r selfs&r is_available!XAIWebSearchProvider.is_available<s #$$rc$V^8dQhRRRRRR/#)rqueryr-limitintrrr)rs"rrr>Bs&)C)CC)C)CN)Crc  ^RIHpV!4'd \R4#\ 4p\ VP R4;'gR4P4p\ VP R4;'gR4P4PR4pV'g \R4#\^\\\V^4^d44p\4p\VP R 4\ 4'dVR ,P4MR;'g\pVP!V4p V f \R 4#R VR R RRVP#W4/.RV .RR./p ^R Ip \(P+RYaY(4TP-YjT\\.TP R\04\04TP R4R8HR7wrT 'dT #\T \24'dT P R4MR p\T\24'dYTP R4;'gTP R4;'gRp\(P5RT4\RT 24#\7TP9YR74# \dELi;i \&d\R4u#i;i) )is_interrupted Interruptedapi_keybase_urlzhttps://api.x.ai/v1/z_No xAI credentials found. Run `hermes auth` to sign in with xAI Grok OAuth, or set XAI_API_KEY.modelNzZweb.xai.allowed_domains and web.xai.excluded_domains cannot both be set (xAI restriction).inputroleusercontenttoolsincludeno_inline_citationsz4httpx is not installed (required for xAI web search)z0xAI web search via %s: '%s' (limit=%d, model=%s)timeoutproviderz xai-oauth) is_oauth_patherrormessagecodez unknown errorz*xAI web search returned error envelope: %szxAI returned an error: rF)tools.interruptrJ_failr!rr-r r.rstripmaxminr8rGr'r DEFAULT_MODEL_web_search_tool _build_prompthttpx ImportErrorr"info_post_responsesfloatDEFAULT_TIMEOUTrwarningr _extract_results)rArErFrJcredsrLrNr$rPweb_search_toolpayloadrgdatar[ api_errorerr_msgs&&& rsearchXAIWebSearchProvider.searchBs  6]++ -.eii *00b1779uyy,EE0EFLLNUUVYZz{ {As73q1378"$)3CGGG4Dc)J)JW##%PRddWd//4  "uv v#*E7ffiY]YkYklqYy=z<{~EHWGXZcf{e|#} Q   FY^f** wswwy/7Z\k(l 99Z0K?+  L*4D$)?)?DHHW%T i & &mmI.ZZ)--2GZZ?G NNG Q27)<= =..t.ABBI   & QOP P Qs(J J-J& J#"J#&J?>J?c V^8dQhRRRR/#)rr$rrzOptional[dict[str, Any]]r)rs"rrr>nsaana1Iarc  RUu/uFq\VPV44bK ppVP4UUu/uFwrV'gKWbK ppp\V4^8XdR#V'dRRRV/#RR/#uupiuuppi)z``web_search`` tool spec with optional domain filters; None when both allowed and excluded are set (xAI rejects the combination).Ntype web_searchfilters)allowed_domainsexcluded_domains)r1r itemslen)r$kr{vs& rre%XAIWebSearchProvider._web_search_toolms@gg?f!)#''!*55?fg$+MMO9ODAq414O9 w<1 =D i9`6S_J`` h9s#A; BBc 0V^8dQhRRRRRRRRRR R R /#) rrNr-rqrrLrXrkrZr=rz$tuple[Any, Optional[dict[str, Any]]]r)rs"rrr>xsE.R.R#.R.R.RW\.Rpt.Rz^.Rrc  a^RIpRRS 2RRR\4/pRV3RllpRp\^4F+p VPV R 2WaVR 7pVP 4M VfR\R43#VP!4R3# TP dp T P eT P PM^p T R 8XdET ^8Xd>T'd6\PR 4T!4;p 'dT RT 2uoTR&Rp ? KT P eT P PR ,MRp M \dRp Mi;i\PRY4R\RT RT 2P443uRp ? u#Rp ? iTPd3p \PRT 4R\RT 243uRp ? u#Rp ? ii;i \d.p \PRT 4R\R43uRp ? #Rp ? ii;i)uFPOST ``/responses`` → ``(parsed_json, None)`` or ``(None, failure_envelope)``. Two attempts: on a first-call 401 with OAuth creds, force-refresh once and retry (opaque tokens the resolver can't pre-check; mid-window revocation/rotation). XAI_API_KEY creds can't be refreshed, so they skip the retry rather than burn quota. N AuthorizationzBearer z Content-Typezapplication/jsonz User-AgentcV^8dQhRR/#)rrr-r)rs"rr:XAIWebSearchProvider._post_responses..__annotate__s   rc<\\RSR7PR4;'gR4P4pVS8wdV#R# \d"p\ P RT4Rp?R#Rp?ii;i)zeNew bearer after a 401, or "" when refresh fails / returns the same token (retry would be pointless).T) force_refresh api_key_hintrLrMz1xAI web search OAuth refresh after 401 failed: %sN)r-rr r.r!r"rm)r% refresh_excrLs r_refreshed_key._refreshed_keysm 6TX_`ddenouusuv||~!Wns4"4 RT_` s"'A A A A7A22A7z /responses)headersjsonrXizQxAI web search got 401 on first attempt; forcing OAuth refresh and retrying once.:Ni,NrMzxAI web search HTTP %d: %szxAI web search returned HTTP z: z xAI web search request error: %szCould not reach xAI: z#xAI web search produced no responsezxAI web search bad JSON: %sz/Could not parse xAI Responses API reply as JSON)rgr rangepostraise_for_statusHTTPStatusErrorresponse status_coder"ritextr!rmr`ra RequestErrorr)rNrqrLrXrZrgrrrespattemptr&statusnew_keybodys&&f&$ rrj$XAIWebSearchProvider._post_responsesws "ggY$7I[]ilAlCD  QxG BzzXJj"97bizj%%'  * <DEE E R99;$ $'(( ^58\\5M11STS=W\mKK st"0"22w2PQQ Q Rs'B0G G ;F#F3 F-D32F3 EFE9F<G G G %G=G G  H"H:HHc$V^8dQhRRRRRR/#)rrEr-rFrGrr)rs"rrr>s!   S      rc RV RV 2#)zAsk for a JSON *object* (cheap to match with ``_JSON_BLOCK_RE``) and forbid prose/fences/inline citations to keep the payload parseable.u<Use the web_search tool to find current information for the query below, then respond with ONLY a single JSON object — no prose, no markdown fences, no inline citation links — matching this exact schema: {"results": [{"title": "string", "url": "string", "description": "1-2 sentence summary"}]} Return at most zy results, ordered by relevance, with absolute https:// URLs. If no usable results exist, return {"results": []}. Query: r)rErFs&&rrf"XAIWebSearchProvider._build_prompts"  $W%W   rc$V^8dQhRRRRRR/#)r response_datarrFrGrlist[dict[str, Any]]r)rs"rrr>s' a a^ as aOc arc  0aaSPV4wr4\RVV3RlV44R4pV'g4V'd.SPVRPV4SR7;p'dV#VP R4;'g.p\ V\ 4'do\VRS4UUu.uFSwrx\ V\4'gKVP4'gK5\R\V4RV^,4NKU upp#.#uuppi)aRows in order of preference: (1) the JSON object in ``output_text`` blocks, (2) ``url_citation`` annotations paired with surrounding text, (3) the raw ``citations`` list. (2) only short-circuits when it yields rows, so future annotation types don't mask real data in ``citations``.c38"TFq'gK VxK R#5ir+r).0ps& r 8XAIWebSearchProvider._extract_results..sj"dQhiqq"ds  c3J<"TFpSPVSR7xK R#5i)r^N)_try_parse_json_results)rbclsrFs& rrrs'"dXcST3#>#>q#>#N#NXcs #N r^ citationsrM) _collect_output_textnext_results_from_annotationsjoinr rr, enumerater-r._row) rrrF text_blocksrparsedrius f&d rrn%XAIWebSearchProvider._extract_resultss $'#;#;M#J j"dXc"djlpq k1N1N{\`\e\efq\rz1N2A(Av(AM!%%k288b ~HIRTX~Y~Y )FUBS8Ty8TXbcdfiXj+opovovox+RQQU+8Ty a_a ays3DD*"Dc V^8dQhRRRR/#)rrrrz&tuple[list[str], list[dict[str, Any]]]r)rs"rrr>s ( (N (?e (rc  PVPR4p\V\4'dTM.UUu.uFp\V\4'gKVPR4R8XgK3\VPR4\4'gKZVR,F5p\V\4'gKVPR4R8XgK3VNK7 K pppVUu.uFRp\VPR4\4'gK*VR,P 4'gKIVR,NKT ppVUUu.uFTp\VPR4\4'gK*VR,Fp\V\4'gKVNK KV pppWh3#uuppiuupiuuppi)zC(text_blocks, annotations) from ``response.output`` message chunks.outputryr\rT output_textrr)r rr,rr-r.) rrr0chunkchunkscrars & rr)XAIWebSearchProvider._collect_output_textsy""8,$.fd#;#;C C$% *.((6*:i*G LVW[W_W_`iWjlpLq i%& ,199V+< +M E) C  +1i&QJquuV}c4RyWXY_W`WfWfWhyqyy& i"(E&QJquu]7KT,Rq\]^k\l\lWXpz{|CqDqq\lq& E'' jEsGF F$"F F/F F'FF# F7'F"#F" F"c$V^8dQhRRRRRR/#)rrr-rFrGrzOptional[list[dict[str, Any]]]r)rs"rrr>s"cS=[rc l\PV4pV.V'd)VP^4V8wdVP^4.M.,EF<p\P!V4p\T\4'dTPR4MRp\T\4'gK\.pTRTFp\T\4'd*\TPRR44P4MRpT'gKNTP\\TPRR44P4T\TPRR44P4\T4^,44K T'gEK;Tu# R# \P \ 3dEKbi;i)zParse a JSON object with a ``results`` array out of ``text``; None when absent. Whole string first, then the regex-matched block (reasoning models prefix narration).resultsNurlrMtitle description)_JSON_BLOCK_RErugrouprloadsJSONDecodeErrorr6rrr r,r-r.appendrr) rrFmatch candidaterr normalizedrowrs &$ rr,XAIWebSearchProvider._try_parse_json_resultssv%%d+uQSWAWEKKN#3]_``I I.0:&$/G/Gfjj+TGgt,,/1Jv9CC9N9Nc#''%,-335TV3%%d3swww/C+D+J+J+LcSVWZW^W^_lnpWqSrSxSxSz|AK}LOP}P'QR ' z!!a ((*5  sFF32F3c(V^8dQhRRRRRRRR/#)rrr joined_textr-rFrGrr)rs"rrr>s,/CRUadi}rc  \4p.pVEF^pVPR4R8Xd*\VPRR44P4MRpV'dWc9dKUVP V4RpVPR4VPR4r\ V\ 4'd\ V \ 4'dk^Tu;8:dT u;8d\V48:dKMMGV\^V^, 4VP4p\V4^8dVRRP4pVP\RWg\V4^,44\V4V8gEK^V# V#) zFallback rows from ``url_citation`` annotations: URL plus ~200 chars of preceding text as the description (the annotation title is just a number).ry url_citationrrM start_index end_indexNi8) setr r-r.addrrGrrbrr) rrrFseenrannrrstartends &&$ rr.XAIWebSearchProvider._results_from_annotationss*(*C58WWV_5V#cggeR()//1\^C#+ HHSMK/1E3%%%*S#*>*>1CgPSCgWZ[fWgCg)#a*=eDJJL {#c)"-de"4":":"s  . rc \RRRRR7#)r;paiduUAgentic web search via Grok's web_search tool — uses xAI Grok OAuth or XAI_API_KEY.xai_grok) post_setup)r r@s&rget_setup_schema%XAIWebSearchProvider.get_setup_schemas #V cpz  rrN))__name__ __module__ __qualname____firstlineno____doc__NAME DISPLAY_NAMErBru staticmethodrerjrf classmethodrnrrrr__static_attributes__rrrr:r:4se D*L% )CVaa.R.R`     a a ( (,*  rr:)$r __future__rrloggingretypingrrrrplugins.web._commonrrr`r r r rtools.xai_httpr r r getLoggerrr"rdrlr/compile MULTILINErr'r1r8r:rrrrs#  ,,wwcc   8 $ NBLL9 OP 0P r