߲jdZddlZddlmZmZddlmZddlmZm Z dZ dZ dZ d3d e d ee d ee d ee d ee dee deedeedeede fdZdddddddddddee ddddZddddee d ddee d!ddd"ddd#ddd$ddee d%dd&ed'd(d)d*dd+d gd,d-Zdefd.Zej*dd/eed0d12y)4a:Guided tour (highlight + narrate UI elements) in the Hermes desktop GUI: the agent discovers targets (``action="targets"``), then highlights one step at a time (``show``) or hands over a step list the user pages (``start``). Round-trips through the gateway blocking-prompt bridge (``tour.request``/``tour.respond``) so the agent learns whether the selector matched. Registered in ``desktop_ui`` and hidden from the model when tours are off: a tour covers the whole screen, so "off" must mean the model is never told the tool exists rather than offered a call that fails.N)CallableOptional) desktop_ui)registry tool_error)targetsshowstartnextprevstop)apppreview)toprightbottomleftactionsurfaceselectortitletextsidesteps step_indexcallbackreturnc | tdS|xsdjj} | tvr"tddj tdS|xsdjj} | t vr"tddj t dS|*|t vr"td dj t dS| d k(r|s|s |s td S| d k(rt|tr|s td St|D]l\} } t| tstd| dcS| jdr9| jdrK| jdr]td| dcS| | ||||||d} || jDcic] \}}| || c}}}|s tdS tjtj |dScc}}w#t$r}td|cYd}~Sd}~wwxYw#t"t$f$r%tjdt'|idcYSwxYw)zHDispatch one tour action to the desktop renderer and return its outcome.Nz1tour is only available in the Hermes desktop app.zaction must be one of: z, .rzsurface must be one of: zside must be one of: r z:show needs a selector (and/or title/text for the popover).r z$start needs a non-empty steps array.zsteps[z] must be an object.rrrz%] needs a selector and/or title/text.rrrrrrrrzTour action failed: zsThe tour request timed out, or no GUI window answered. For surface='preview' open a page in the preview pane first.F) ensure_ascii)rstriplowerACTIONSjoinSURFACESSIDES isinstancelist enumeratedictgetitems Exceptionjsondumpsloads TypeError ValueErrorstr)rrrrrrrrrverbwhereistepfieldskeyvalrawexcs 4/home/ubuntu/.hermes/hermes-agent/tools/tour_tool.py tour_toolr@sJ MNN Lb   ! ' ' )D 73DIIg4F3GqIJJ   $ $ & , , .E H4TYYx5H4IKLL D-1$))E2B1C1EFF v~x5DVWW w%&eDE E ' UGAtdD)!F1#-A"BCCHHZ(DHHW,=&AQ!F1#-R"STT  U HuD5 TF8SXS#3?SST YZ ZBzz$**S/>>T 806778 z "Bzz63s8,5AABsHG;% G5 0G5 5G; )H5G;; H HHH1IIobjectstringz0Element to highlight; omit = centered narration.)type descriptionzPopover title.z Popover body.z!Popover side; omit to auto-place.)rCenumrD)rrrr)rC propertiesgui_touruEGuided tour in the desktop GUI: dim the screen, highlight an element, attach a titled popover. Surfaces: 'app' (Hermes itself) or 'preview' (the page in the preview pane). ALWAYS call action='targets' first — prefer targets marked stable:true (their selectors survive re-renders); re-scan if one stops matching. Then narrate with action='show' (one highlight per call, replaces the last — pair each with a chat message) or hand over with action='start' + steps (user gets Next/Prev; 'next'/'prev' also page it). 'stop' clears. Use for how-does-X-work / where-is-Y walkthroughs.z/targets first; show narrates; start hands over.z'app' (default) or 'preview'.zGshow: selector from targets (prefer stable). Omit = centered narration.zshow: popover title.zshow: popover body.z'show: popover side; omit to auto-place.arrayzstart: ordered steps.)rCr.rDintegerzstart: 0-indexed first step.r!)rCrFrequired)namerD parametersc0tjddS)uHThe user's Settings → Appearance switch. On unless they turned it off. in_app_toursT)default)r user_enabledr?check_tours_enabledrSs  " ">4 @@rRrc td|jdd|jdddDcic]}||j|c}Scc}w)Nrrr)rr)rrrrrrrrQ)r@r-)argskwks r?rXsSy 4xx"%z0B 4$2 3a1dhhqk> 3 4 3sA u🧭)rKtoolsetschemacheck_fnhandleremoji) rNNNNNNNN)__doc__r0typingrrtoolsrtools.registryrrr%r'r(r5r*intr@ _STEP_SCHEMA TOUR_SCHEMAboolrSregisterrQrRr?rgs\ %/ > *Z^]aHL-1'Bc'B#'BRU'Bc]'B19#'BMUVY]'Bd^'B8@ 'B!*'B7:'BV M #3CD!/BK>   $  !W P !X> !h'7MN%6KL U H  %6 "=7 @JE##5 pATA  \+H[ 4  rR