Ë tPêjÍãó’—UdZddlmZddlmZmZddlmZddlm Z ddl mZmZddl mZddlmZGd „d ee«ZdZeeedfed <dZeed<Gd„de«Zdedefd„Zdeeefdzdeedffd„Zdedeeefdzdeedffd„Zej:deddœdededeeefdzdedeeefdzdeeeffd„Zy)a¹ Fetch an A2A agent's well-known card from the upstream agent. Different agent runtimes publish the card at different URL shapes, so the fetcher dispatches by ``discovery_mode``: - ``well_known_fallback`` (pure A2A): the card lives at one of the standard well-known paths on the agent's own base URL. We try the canonical path, then the previous-spec path, then a non-standard root fallback. - ``langgraph_platform``: LangGraph Platform mounts a single card endpoint at ``{base}/.well-known/agent-card.json`` and disambiguates assistants via the ``assistant_id`` query parameter. There is no per-assistant subpath, so the pure-A2A fallback strategy returns 404 for these deployments. é)ÚEnum)ÚAnyÚFinal)Ú urlencode)Úverbose_proxy_logger)Ú SSRFErrorÚasync_safe_get)Úget_async_httpx_client)ÚhttpxSpecialProvidercó—eZdZdZdZdZy)Ú DiscoveryModezmHow to locate the upstream agent card. String-valued so it serializes cleanly over JSON / Pydantic. Úwell_known_fallbackÚlanggraph_platformN)Ú__name__Ú __module__Ú__qualname__Ú__doc__ÚWELL_KNOWN_FALLBACKÚLANGGRAPH_PLATFORM©óú`/home/oem/CyberBrain26-unified/.venv/lib/python3.12/site-packages/litellm/proxy/a2a/discovery.pyr r s„ñð 0ÐØ-Ñrr )z/.well-known/agent-card.jsonz/.well-known/agent.jsonz/agent.json.ÚAGENT_CARD_WELL_KNOWN_PATHSg$@Ú!DEFAULT_DISCOVERY_TIMEOUT_SECONDScó—eZdZdZy)ÚAgentCardDiscoveryErrorzFRaised when none of the well-known paths returned a usable agent card.N)rrrrrrrrr1s„ÚPrrÚbase_urlÚreturncó$—|jd«S)Nú/)Úrstrip)rs rÚ_normalize_base_urlr"5s€Ø?‰?˜3ÓÐrÚparamsNcó¤‡—|xsijd«}|std«‚tdt|«i«Št ˆfd„t D««S)aUBuild the paths to try for LangGraph Platform discovery. LangGraph serves the card at ``/.well-known/agent-card.json`` with the ``assistant_id`` carried as a query parameter. We still try the other A2A path variants (with the same query string appended) so we degrade gracefully if a deployment uses an older spec name. Úassistant_idz9langgraph_platform discovery requires params.assistant_idc3ó,•K—|]}|›d‰›–—Œ yw)ú?Nr)Ú.0ÚpathÚquerys €rú z2_build_langgraph_platform_paths..Gsøèø€ÒK tD6˜˜5˜'Ô"ÑKùsƒ)ÚgetrrÚstrÚtupler)r#r%r*s @rÚ_build_langgraph_platform_pathsr/9sNø€ð"š< R×,Ñ,¨^Ó<€LÙÜ%Ð&aÓbÐbÜ˜n¬c°,Ó.?Ð@ÓA€EÜÓKÔ/JÔKÓKÐKrÚmodecóŒ—|tjk(rtS|tjk(rt |«Std|›«‚)Nzunsupported discovery_mode: )r rrrr/r)r0r#s rÚ_paths_for_moder2JsB€ØŒ}×0Ñ0Ò0Ü*Ð*ØŒ}×/Ñ/Ò/Ü.¨vÓ6Ð6Ü !Ð$@ÀÀÐ"GÓ HÐHr)Údiscovery_moder#ÚtimeoutÚheadersr3r4r5cƒóVK—|std«‚t|«}t||«}ttj d|i¬«}d}|D]º} |›| ›} t || |xsi¬«ƒd{–—†}|jd k\r3| ›d |j›}tjd|j| «Œf |j«} t| t«s| ›dt| «j ›}Œ¢tjd| «| cStd|›d|j"›d|›«‚7Œ»#t$r)}| ›d|›}tjd| |«Yd}~Œ d}~wt$r)}| ›d|›}tjd| |«Yd}~Œ:d}~wwxYw#t$r}| ›d|›d }Yd}~ŒYd}~wwxYww)a` Fetch an agent card from ``base_url`` using the strategy chosen by ``discovery_mode``. Returns the parsed JSON from the first path that responds with a JSON body. Raises: AgentCardDiscoveryError: if every path fails (network error, non-2xx, or non-JSON body), or if the chosen mode is missing required params. zbase_url is requiredr4)Úllm_providerr#N)r5z: z.A2A discovery blocked by SSRF guard for %s: %szA2A discovery failed for %s: %siz: HTTP zA2A discovery HTTP %s for %sz: invalid JSON (ú)z: expected JSON object, got zA2A discovery succeeded at %sz Could not fetch agent card from z (mode=z). Last error: )rr"r2r rÚA2Ar rrÚdebugÚ ExceptionÚstatus_codeÚjsonÚ isinstanceÚdictÚtyperÚvalue)rr3r#r4r5Ú normalizedÚpathsÚclientÚ last_errorr)ÚurlÚresponseÚexcÚcards rÚfetch_well_known_cardrJRsßèø€ñ"Ü%Ð&<Ó=Ð=ä+¨HÓ5€JÜ" >°6Ó:€EÜ*Ü)×-Ñ-Ø˜7Ð#ô€Fð "€JØò'ˆØ˜T˜FÐ#ˆð ô,¨F°CÀÂÈBÔO×OˆHð×Ñ 3Ò&Ø˜5 ¨×(<Ñ(<Ð'=Ð>ˆJÜ ×&Ñ&Ð'EÀx×G[ÑG[Ð]`ÔaØð Ø—=‘=“?ˆDô ˜$¤Ô%Ø˜5Ð <¼TÀ$»Z×=PÑ=PÐrTsXðòõ ßÝ"å1ßJÝIÝ?ô.C˜ô.ð7Ð˜U 5¨¨c¨¡?Ñ3óð,0Ð! 5Ó/ôQ˜iôQð #ð ¨#ó ðLØc‰N˜TÑ!ðLà ˆ3ˆ8_óLð"I˜-ðI°°c¸3°h±À$Ñ1FðIÈ5ÐQTÐVYÐQYÉ?óIð%2×$EÑ$EØ$(Ø6Ø%)ò GØðGð"ðGð c‰N˜TÑ!ð Gð ðGð#s(‰^˜dÑ "ð Gð ˆ#ˆsˆ(^ôGr