ߩ^j$dZddlmZddlmZmZddlmZmZddl m Z m Z m Z m Z mZeGddZeGdd ZeGd d ZGd d eZdS)zAbstract backend interface for computer use. Any implementation (cua-driver over MCP, pyautogui, noop, future Linux/Windows) must return the shape described below. All methods synchronous; async is handled inside the backend implementation if needed. ) annotations)ABCabstractmethod) dataclassfield)AnyDictListOptionalTupleceZdZUdZded<ded<dZded<dZd ed <dZded <d Zded <d Z ded<e e Z ded<dZ ded<ddZdS) UIElementz/One interactable element on the current screen.intindexstrrolelabel)rrrrzTuple[int, int, int, int]boundsapprpid window_iddefault_factoryDict[str, Any] attributesN Optional[str] element_tokenreturnTuple[int, int]c:|j\}}}}||dzz||dzzfS)N)r)selfxywhs r>Fs   HHHKKKG(,G++++ 5666D6666 $H#### F    ,0J////D#H#####'M''''Dr*r>c eZdZdZed>dZed>dZed?dZe d@dAdZed d d ddd d dddBd"Z ed d d d dd d dd#dCd)Z ed*d d d d d dd+dDd.Z ed dd/dEd1Z ed dd/dFd3Z edGd5ZdGd6ZedHdId8ZedJdKd:ZdLd=Zd S)MComputerUseBackendzcdSrPr1) r#r]r$r%r^r_r`rJras r(clickzComputerUseBackend.click sr*) from_element to_elementfrom_xyto_xyr^r`rJrarfrgrhOptional[Tuple[int, int]]ricdSrPr1) r#rfrgrhrir^r`rJras r(dragzComputerUseBackend.dragrer*)amountr]r$r%r`rJra directionrncdSrPr1) r#rornr]r$r%r`rJras r(scrollzComputerUseBackend.scrollrer*)rJratextcdSrPr1)r#rrrJras r( type_textzComputerUseBackend.type_textsADr*keyscdS)z7Send a key combo, e.g. 'cmd+s', 'ctrl+alt+t', 'return'.Nr1)r#rurJras r(keyzComputerUseBackend.keyrWr*List[Dict[str, Any]]cdS)z9Return running apps with bundle IDs, PIDs, window counts.Nr1rQs r( list_appszComputerUseBackend.list_appsrWr*cgS)zReturn visible native windows with PID and window identifiers. Optional compatibility hook: backends that predate window discovery remain instantiable and simply report no windows. r1rQs r( list_windowszComputerUseBackend.list_windowss  r* raise_windowcdS)zJRoute input to `app` (by name or bundle ID). Default: focus without raise.Nr1)r#rr}s r( focus_appzComputerUseBackend.focus_apprWr*valuecdS)zSet a native value on an element (e.g. AXPopUpButton selection). `element` is the 1-based SOM index returned by a prior capture call. Nr1)r#rr]s r( set_valuezComputerUseBackend.set_valuerWr*secondsfloatc ddl}|tdt|dt ddd|dd  S) z#Default implementation: time.sleep.rNgg>@Twaitzwaited z.2fs)r@rArB)timesleepmaxminr>)r#rrs r(rzComputerUseBackend.waitsU  3sC..//000tF)rfrYrgrYrhrjrirjr^rr`rbrJrrar?rr>)rorrnrr]rYr$rYr%rYr`rbrJrrar?rr>)rrrrJrrar?rr>)rurrJrrar?rr>)rrx)F)rrr}r?rr>rP)rrr]rYrr>)rrrr>)r+r,r-r.rrRrTrVrCrdrlrqrtrwrzr|rrrr1r*r(rMrMosmFF   ^ ^   ^ !!#' ^"&)-'+$     ^ '+$(-1+/)-'+$     ^  !%)-'+$     ^ EI).EEEEE^E?C#(FFFFF^F HHH^HYYYY^Y    ^ VVVVVVr*rMN)r. __future__rabcrr dataclassesrrtypingrr r r r rr3r>rMr1r*r(rsb#"""""########((((((((33333333333333 &&&&&&& &0 ******* *: %%%%%%% %PmVmVmVmVmVmVmVmVmVmVr*