3jz%SrSSKrSSKrSSKrSSKJr SSKJrJr SSK J r SSK J r \ R"\ 5rS rS r"S S \S S9r"SS\5r/0S.r\\S'Sq\S-\S'S\\4SjrS\4SjrS\\\4S\4SjrS\4SjrS\4SjrS\S\S-S\S-4SjrS\S\SS4Sjr S\S-4S jr!g)!uDetect whether the process is being invoked by an AI coding agent. Detection is based on environment variables that AI agents set in their shell sessions. `AI_AGENT` and `AGENT` are treated as a universal standard (any tool can set its harness id there); the remaining checks are tool-specific and ordered by priority (first match wins). The list of known harnesses is maintained on the Hub and exposed at `{ENDPOINT}/api/agent-harnesses`. We fetch it at most once a day and cache it locally so the list can be updated without requiring a new client release. Detection is entirely best-effort: there is no hardcoded list of harnesses. When the registry cannot be fetched (and no cached copy is available), detection simply reports "no agent". Any error while fetching/reading the registry is swallowed — detection must never make a process fail. More details: https://huggingface.co/docs/hub/agents-overview#register-your-agent-harness N)Path)Optional TypedDict) constants)loggingiQc.\rSrSr%Sr\\\4\S'Srg) HarnessInfo4zbA single harness entry. `envVars` maps an env var name to a match pattern (see `_env_vars_match`).envVarsN) __name__ __module__ __qualname____firstlineno____doc__dictstr__annotations____static_attributes__r]/home/wildlama/miniconda3/lib/python3.13/site-packages/huggingface_hub/utils/_detect_agent.pyr r 4sl #s(^rr F)totalc>\rSrSr%Sr\\\S'\\\ 4\S'Sr g)Registry:zJThe agent harness registry, as served by `{ENDPOINT}/api/agent-harnesses`.standardEnvVars harnessesrN) rrrrrlistrrrr rrrrrr:sT#YC$%%rr)rr _EMPTY_REGISTRY _registryreturnc[5nURS5=(d /nURS5=(d 0nUR5H{up4U=(d 0RS5nU(a[U5(aUs $UH;n[R RUS5R 5U:XdM7Us s $ M} UR5Vs1sHowR5iM nnUHQn[R RUS5R 5R5=n (dMHX;aU s $ g gs snf)aGReturn the id of the detected AI agent harness or `None`. Harnesses are checked in registry order; for each one we match its env var pattern(s) and, failing that, the standard `AI_AGENT` / `AGENT` vars against the harness id. The first match wins. When a standard var is set to an unrecognized value, `"unknown"` is returned. rr runknownN) _get_registrygetitems_env_vars_matchosenvironstripkeyslower) registry standard_varsr harness_idinfoenv_varsvarklowercased_harnessesvalues r detect_agentr:IsHLL!239rM [)/RI%OO- JB##I. 11  Czz~~c2&,,.*<!!! .09~~/?@/?!GGI/?@JJNN3+11399; ;5 ;,   As Ec[5SL$)zDReturn `True` if the process is being invoked by an AI coding agent.N)r:rrris_agentr<hs > %%rr5cUR5H<up[RRU5nU(dM-US:Xa gX2:XdM< g g)zReturn `True` if any `(var, pattern)` from the harness matches the environment. Supported patterns: - `"*"`: the variable is set to any non-empty value - `""`: the variable equals this exact value *TF)r*r,r-r))r5r6patternr9s rr+r+msG!(  s#  c>  ) rc[c[5q[$[$![a" [R SSS9 [ q[$f=f)zReturn the harness registry, loading (and caching in-process) on first call. Best-effort: any unexpected error degrades to an empty registry so detection never raises. z+Could not resolve agent harnesses registry.Texc_info)r#_load_registry Exceptionloggerdebugr"rrrr(r(sR (&(I 9 ( LLFQUL V'I  (s $A  A c[Rn[U[S9=n(aU$[ 5=nb [ X5 U$[USS9=n(aU$[ $)zResolve the registry from the local cache or the Hub. No hardcoded list: if the Hub is unreachable and no cached copy exists, an empty registry is returned (i.e. no agent is detected). )max_ageN)rAGENT_HARNESSES_PATH_read_cached_registry_REGISTRY_TTL_SECONDS_fetch_registry_write_cached_registryr")pathcachedfetchedstales rrCrCse  ) )D't5JKKvK #$$1t-&dD99u9 rrNrHc[RRU5(dgUb:[R"5[RR U5- U:ag[ USS9n[ R"U5sSSS5 $!,(df  g=f![a [RSSS9 gf=f)zBReturn the cached registry, or `None` if missing/stale/unreadable.Nutf-8encodingz/Could not read cached agent harnesses registry.TrA) r,rNexiststimegetmtimeopenjsonloadrDrErF)rNrHfs rrJrJs ww~~d##  DIIK"''2B2B42H$HW#T $ )Q99Q<* ) )  FQU Vs:$Brrs& &   H %")5 &y&13DD" 8d?!hsm>&$& d38n$ x  .  cDj X_ QQQTQDr