+ lHj&Rt^RIHt^RIt^RIt^RIt^RIt^RIt^RIt^RI t ^RI t ^RI H t ^RI HtHtHtHtHt]P&!R4tRtRtR.tR.tRR R 0R 0R/mR R 0/t]P4!R 4tRtRRltRRltRRltRRlt RRlt!R0RRllt"RRlt#RRlt$]3RR llt%]PL!^R!7R"R#l4t'R$R%/R&R'llt(R(R)lt)R0R*R+llt*R$R/R,R-llt+R#)1zPM-backed cua-driver selection, MCP discovery and the runtime contract gate. Config-derived policy (``_cua_no_overlay``, ``_run_driver`` ...) is looked up lazily through the facade.) annotationsN)PureWindowsPath)AnyDictListOptionalTupleztools.computer_use.cua_backendHERMES_CUA_DRIVER_CMD cua-drivermcp--socketz--grantservestopz v?(\d+)\.(\d+)\.(\d+)(?:[-+].*)?c^RIHpV#)zRFacade module (config/policy helpers), looked up lazily to avoid the import cycle. cua_backend)tools.computer_userrs J/home/ubuntu/.hermes/hermes-agent/tools/computer_use/cua_backend_driver.py_cbr s . c(V^8dQhRRRRRRRR/#) driver_cmdstrargstimeoutfloatreturnOptional[dict[str, Any]])formats"r __annotate__r!%s/ZZSZZuZAYZrc\4P!V.VO5RVR\/pVe%VP;'gRP 4MRpVeV'dVP ^8wdR#\ V4#)zRun a driver verb and parse its stdout as a JSON object; None on spawn failure, empty stdout (older drivers print usage to stderr), unparseable or non-object output, or a non-zero exit.rswallowN)r _run_driver Exceptionstdoutstrip returncode _json_object)rrrprocouts&$* r _driver_jsonr-%sh 5  Z S$ S S SD)-)94;;  " # # %rC"_valid_mcp_args..7s1Sd*Q2D2DdsFT)r5r6getlistall)r9rs& r_valid_mcp_argsrD4sV%/ D%A%A:>>& !tDdD))cc1Sd1Sccc1Sd1S.S.S4]Y]]rc V^8dQhRRRR/#)rvaluerrboolr)r s"rr!r!9sMMsMtMrc\PV9;'g.\PRJ;'d\PV9#r<)ossepaltsep)rFs&r_has_path_separatorrL9s2 66U? L Lryy4KKe9KLrc V^8dQhRRRR/#)rpathrrr)r s"rr!r!<s P PS PS Prcn\P!RV4'gV#^RIHpV!4p\ V4pVP ;'gRPR4P4pV'd/V'd'RPRV.VPR,O4#T# \dRpLi;i) zTranslate a Windows absolute manifest command to its DrvFS ``/mnt//...`` form when Hermes runs in WSL (a Windows cua-driver manifest can report ``C:\...`` while Hermes spawns via POSIX). Non-Windows paths and non-WSL hosts are returned unchanged.z^[A-Za-z]:[\\/])is_wslFr$:/z/mnt:NN) rematchhermes_constantsrPr&rdriverstriplowerjoinparts)rNrPwslwinrWs& r_wsl_windows_path_to_posixr^<s 88& - - +h $ C YY__" $ $S ) / / 1E8;388VU3SYYr]3 4O4O s B$$ B43B4c V^8dQhRRRR/#)roverride Optional[str]rr)r s"rr!r!Ks M M] Mm MrcVeTM#\PP\R4P 4pV'dS\P P V4p\P!V4pV'd\V4'dV#T#^RI H pV!R4pV'd(VP'd\VP4#R#)zQRead PM's selected binary without installing; never replace an explicit override.Nr$)installed_packager )rIenvironrA_CUA_DRIVER_CMD_ENVr(rN expandusershutilwhichrLpmrcbinaryr)r` configuredexpandedresolvedrc installeds& rresolve_cua_driver_cmdroKs&2( GZ\^8_ffhJ77%%j1<<)#(;H(E(ExS8S$!,/I$-)2B2B2B3y LLrcV^8dQhRR/#)rrrGr)r s"rr!r!Ws00T0rc\4RJ#)z:True if PM or an explicit override selects a local driver.N)rorrrcua_driver_binary_availablerrWs ! #4 //rcV^8dQhRR/#)rrrr)r s"rr!r![sfffrcR#)zcua-driver is not installed. Install the pinned driver with: hermes computer-use install Or run `hermes tools` and enable the Computer Use toolset to install it automatically.rrrrcua_driver_install_hintru[s erc$V^8dQhRRRRRR/#)rrz list[str]rrrr)r s"rr!r!_s"99i9S9_h9rc\4P4;'d \V4pV'd.VORN#\V4#)zKReturn *args* with ``--no-overlay`` appended when configured and supported. --no-overlay)r_cua_no_overlay_cua_driver_supports_no_overlayrB)rrons&& r_mcp_args_with_overlay_flagr|_s<    P P%DZ%PB&( "T "> "8d4j8r)maxsizec V^8dQhRRRR/#)rrrrrGr)r s"rr!r!esrc\4PVRRR7pRVP;'gRVP;'gR,9# \dR#i;i)zTrue if `` --help`` mentions ``--no-overlay`` (probed once); older drivers reject unknown flags, which would crash the MCP spawn.z--helpg@rrxr$F)rr%r'stderrr&)rr+s& rrzrzdsZu  Xs C$++"3"3 8I8Ir!JJJ s/AA A A! A!rg@c$V^8dQhRRRRRR/#)rrrrrrztuple[str, list[str]]r)r s"rr!r!ns'JJJJI^Jrc\VRVR7;'g/pVPR4p\V4pVe(\V\4'dVPR4MRpVf\ \ 4MTp\V\4'dV'd \V4MRpV'd\V4'dTMTpV\WER73#)u<``(command, args)`` that spawn cua-driver's stdio MCP server, asked of the driver itself via ``cua-driver manifest`` (``mcp_invocation``) so a subcommand rename keeps working. Falls back to ``(driver_cmd, ["mcp"])`` on older drivers or any discovery failure — the wrapper must not refuse to start over a failed discovery hop. ``--no-overlay`` appended when allowed. Surface 8 of NousResearch/hermes-agent#47072: instead of hardcoding ``["mcp"]`` we ask the driver itself via ``cua-driver manifest`` (trycua/cua#1961). The manifest carries a stable ``mcp_invocation`` pointer with both ``command`` and ``args``, so a future cua-driver that renames or relocates the subcommand keeps working without a Hermes patch. When ``computer_use.no_overlay`` is enabled (or auto-detected — macOS, headless/WSL2/X11 Linux), ``--no-overlay`` is appended to suppress the cursor overlay rendering loop that can consume CPU indefinitely when idle (#28152, #47032). Older drivers that don't recognise the flag will reject it; callers should fall back to the no-overlay invocation on spawn failure. manifestrmcp_invocationNcommandr$)r) r-rArDr5r6rB_CUA_DRIVER_ARGSrr^rLr|)rrrr9rrs&$ r_resolve_mcp_invocationrnsJ GDJJH./J : &D+/+; :W[@\@\jnnY'bfG%)\4 !tD 6@5M5MRY(1_aG %8%A%AgzG /I IIrc V^8dQhRRRR/#)rrrrrr)r s"rr!r!sRR(@RSRrc ~VfR#\P\VPR4;'gR4P 44pV'gR#\ ;QJd".RVP 44FNK 5M!RVP 444\8dR#\VPR44'gR#VPR 4;'g.UUu/uFp\V\4'gK\VPR 4\4'gKBVR ,VPR 4;'g.Uu0uFKp\V\4'gK\VPR 4\4'gKBVR ,kKM upbK ppp\P4UUUu.uF<wr%\WTPV\44, 4F pV R V 2NK K> ppppV'dR RPV4,#R#uupiuuppiuupppi)zWhy a parsed manifest fails the 0.20 contract, or ``""`` when it passes (version floor, MCP launch command, then the ``" "`` entries the advertised subcommands lack).z%driver manifest is missing or invalidbinary_versionr$z2driver manifest does not report a semantic versionc38"TFp\V4xK R#5ir<)int)r=parts& rr?,_manifest_contract_reason..s 2>4SYY>sz7Hermes computer use requires cua-driver 0.20.0 or newerrz6driver manifest does not provide an MCP launch command subcommandsnamer zdriver manifest is missing: z, ) _SEMVER_RE fullmatchrrAr(tuplegroups _CUA_DRIVER_RUNTIME_CONTRACT_MINrDr5r6!_CUA_DRIVER_RUNTIME_CONTRACT_ARGSitemssortedsetrZ)rrUrarg advertisedrequiredmissings& r_manifest_contract_reasonrs6  X\\2B%C%I%Ir!J!P!P!R SE C u 25<<> 2uu 25<<> 225UUH 8<<(89 : :G ||M288b8'9G gt $ Y*4GKK4G)M YV1D1J1J1JY1J#'T2&7A#''&/SV7W&#f++1JY Y8' <];b;b;dM;d&7g NN7CE,J!JK3!C5!K";dGMBI )DIIg,> >QrQY' Ms=)H2"H2-H2 H2H-/"H- H-#H2AH8-H2c V^8dQhRRRR/#)rrjrarzdict[str, Any]r)r s"rr!r!s[[}[[rcT;'g \4pRpRpV'Ed\4PTR\PR8XdRMRR7pVegVP^8wdVRVP;'gVP;'gR P4P4R,R ,r4Vem\VP;'gR 4p\V4pVe=\VP!R 4;'gR 4P4;'gRMRpR V'*RVRVRV/# \ \ P3dpRRT 2r4Rp?ELRp?ii;i)z@Report whether a local driver can host Hermes' 0.20 integration.Nzcua-driver is not installedrwin32g.@g@rzmanifest check failed: zmanifest command failed:NNr$rreadyrjversionreason)rorr%sysplatformOSError subprocessSubprocessErrorr)rr'r( splitlinesr*rrrA)rjrmrrresultexcrs& r"cua_driver_runtime_contract_statusrsG11/1H!G *Fx CU&&xS\\]dMdTjm&nF  &"3"3q"8!FMM$_$_V]]$_$_F_#f#f#h#s#s#uvx#yz~#F  #FMM$7$7R8H.x8FS[Sgc(,,'78>>B?EEGOO4mqG Z8YSY ZZ334 C!%r --embedded--permission-mode--capability-manifest--approve-capability-manifestr<),__doc__ __future__r functoolsr1loggingrIrTrgrrpathlibrtypingrrrrr getLoggerloggerre_CUA_DRIVER_DEFAULT_CMDrrrcompilerrr-r*rDrLr^rorrrur| lru_cacherzrrrrrrrrsl#   #33   ; <.&7#-  J " v ZL%! ZZ; <  Z4^ M P M0fD[9  Q JJ8R,[$$r