+ j>aRt0tRt^RIt^RIt^RIt^RIHt^RIHtH t ^RI H t ^RI H t ] P!]4tRt^t!RR] RR 7t!R R ] 4tR .R //t]^kRs]^kRRltRRltRRltRRltRRltRRltRRltRRltR#) 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)loggingc0a]tRt^4toRtV3RltRtVtR#) HarnessInfozbA single harness entry. `envVars` maps an env var name to a match pattern (see `_env_vars_match`).c<<V^8dQh/S[S[S[3,;R&#)envVars)dictstr)format __classdict__s"d/home/luca/screen-checking/.venv/lib/python3.14/site-packages/huggingface_hub/utils/_detect_agent.py __annotate__HarnessInfo.__annotate__4s#s(^N__name__ __module__ __qualname____firstlineno____doc____annotate_func____static_attributes____classdictcell__rs@rrr4slrrF)totalc0a]tRt^:toRtV3RltRtVtR#)RegistryzJThe agent harness registry, as served by `{ENDPOINT}/api/agent-harnesses`.cX<V^8dQh/S[S[,;R&S[S[S[3,;R&#)r standardEnvVars harnesses)listr r r)rrs"rrRegistry.__annotate__:s-#YC$%% rrNrrs@rr!r!:sTrr!r#r$c:V^8dQhR\\,/#r return)rr )rs"rrrIshsmrc\4pVPR4;'g.pVPR4;'g/pVP4Fwr4T;'g/PR4pV'd\V4'dVu#VF<p\P PVR4P 4V8XgK8Vuu# K VP4Uu0uFqwP4kK ppVFTp\P PVR4P 4P4;p 'gKIW9dV u#R# R#uupi)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. r#r$r unknownN) _get_registrygetitems_env_vars_matchosenvironstripkeyslower) registry standard_varsr$ harness_idinfoenv_varsvarklowercased_harnessesvalues r detect_agentr?IsHLL!2399rM [)//RI%OO- JJB##I. 11  Czz~~c2&,,.*<!!! .09~~/?@/?!GGI/?@JJNN3+11399; ;5 ; ;,   As&Ec$V^8dQhR\/#r()bool)rs"rrrhs&&$&rc\4RJ#)zDReturn `True` if the process is being invoked by an AI coding agent.N)r?rrris_agentrChs > %%rcRV^8dQhR\\\3,R\/#)r r:r))r r rA)rs"rrrms"d38nrcVP4FAwr\PPV4pV'gK.VR8XdR#W28XgK@R# R#)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/r1r2r.)r:r;patternr>s& rr0r0msG!(  s#  c>  ) rc$V^8dQhR\/#r(r!)rs"rrrs  x rc\f\4s\#\# \d&\P RRR7\ s\#i;i)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) _registry_load_registry Exceptionloggerdebug_EMPTY_REGISTRYrrrr-r-sR (&(I 9 ( LLFQUL V'I  (s (AAc$V^8dQhR\/#r(rI)rs"rrrsrc\Pp\V\R7;p'dV#\ 4;pe\ W4V#\VRR7;p'dV#\ #)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_registryrR)pathcachedfetchedstales rrNrNse  ) )D't5JKKvK #$$1t-&dD99u9 rcXV^8dQhR\R\R,R\R,/#)r r[rUNr))r intr!)rs"rrrs)   cDj X_ rc\PPV4'gR#VeA\P!4\PP V4, V8dR#\ VRR7;_uu_4p\ P!V4uuRRR4# +'giR#;i \d\PRRR7R#i;i)zBReturn the cached registry, or `None` if missing/stale/unreadable.Nutf-8encodingz/Could not read cached agent harnesses registry.TrK) r1r[existstimegetmtimeopenjsonloadrOrPrQ)r[rUfs&& rrWrWs ww~~d##  DIIK"''2B2B42H$HW#T $ ) )Q99Q<* ) ) )  FQU Vs;$B7AB7-B7B# B7# B4 .B74B77"CCc4V^8dQhR\R\RR/#)r r[r6r)N)r r!)rs"rrrs&QQQQTQrc8\V4PPRRR7\VRRR7;_uu_4p\P !W4RRR4R# +'giR#;i \ d\PRRR7R#i;i)T)parentsexist_okwrbrcNz)Could not cache agent harnesses registry.rK) rparentmkdirrhridumprOrPrQ)r[r6rks&& rrZrZsrQ T t< $g . .! IIh "/ . . . Q @4 PQs.rs& &   H %")5 &y&/KDD" !>& $  . Qr