sj dZddlZddlmZmZddlmZmZdZdddddZ d"d e d ee d ee d ee deede f dZ dddde eddddddddddddgddZ ejdde dd !dS)#uLeave a mark on the page in the Hermes desktop GUI's in-app browser. ``drive_preview`` already draws every move it makes — the field it can reach, a box round its target, the cursor going there — but those are transients: each one stands for a single action and retires itself. That is right for narrating a click and no use at all for holding a finding on screen. This is the deliberate one. An annotation outlines an element — or, with ``hold``, the entire visible field at once — and stays until the agent takes it down, so it can show the user what it found, flag the fields it is about to fill, or keep its place while it works elsewhere on the page. Named for TouchDesigner's Annotate — the labelled box you drop around part of a network to call it out. Annotations are bound to elements, not coordinates: they ride scrolls and reflows, and they go when their element does, so a navigation clears them without the agent having to. Rides the same ``preview.act`` bridge as ``drive_preview`` rather than opening a second channel — the renderer already resolves ``@e`` refs and owns the overlay, so this is one more verb on a wire that exists. Lives in the ``desktop_ui`` toolset, which the GUI gateway enables only for desktop-sourced sessions. N)CallableOptional)registry tool_error)addholdremoveclearpinrunpinractionrefselectorlabelcallbackreturnc|tdS|pd}|tvr+tddtdS|dvr|s|st|dSd d t |fd |d vrdn|fd |d vrdn|fd|ffD} ||}n)#t $r}td|cYd}~Sd}~wwxYw|stdS tjtj |dS#ttf$r(tjdt|idcYSwxYw)z8Put one annotation up, take one down, or clear them all.Nz=annotate_preview is only available in the Hermes desktop app.rzaction must be one of: z, .)rr zY needs a ref from drive_preview action='elements' (e.g. 'btn-sign-in') or a CSS selector.ci|] \}}||| S)N).0namevals ?/home/agent/.hermes/hermes-agent/tools/annotate_preview_tool.py z)annotate_preview_tool..=s/    D# ? c ??r r)r rrtextz'Failed to annotate the in-app browser: zYThe annotation timed out, or no GUI window answered. Open a page with open_preview first.F) ensure_ascii) rstriplowerACTIONSjoinWIRE Exceptionjsondumpsloads TypeError ValueErrorstr) r rrrrverbpayloadrawexcs rannotate_preview_toolr/(sYZZZ Oe " " $ $ * * , ,D 7IDIIg4F4FIIIJJJ    #   6 6 6    tDz " D$555DD3 ? ):!:!: I UO     GKhw KKKICIIJJJJJJJJK   3   Bz$*S//>>>> z "BBBz63s88,5AAAAAABs08 C C*C%C*%C*?'D''6E E annotate_previewuDraw a lasting mark on the page open in the in-app browser / preview pane of the Hermes desktop GUI. Everything drive_preview draws as it works fades on its own; an annotation STAYS until you remove it, so this is how you point at something. Use it to show the user what you found ('here are the three cheapest'), flag what you are about to change before you change it, or keep your place while you work elsewhere on the page. Address elements by the same refs drive_preview action='elements' hands back. action='add' outlines an element and gives it an optional short label; 'hold' freezes the WHOLE visible field at once — every element the page offers, outlined and named — which is the picture drive_preview flashes as it works, made to stay; 'remove' takes one down; 'clear' takes them all down. Annotations follow their element as the page scrolls and disappear if it does, so a navigation clears them for you. Keep labels to a word or two — they are drawn on the page, not read aloud.objectstringz'add' marks one element, 'hold' freezes the whole visible field, 'remove' takes one down, 'clear' takes them all down. Defaults to 'add'.)typeenum descriptionzLElement reference from drive_preview action='elements' (e.g. 'btn-sign-in').)r3r5z9CSS selector, as a fallback when no ref fits. Prefer ref.z;Short caption drawn on the mark, e.g. 'cheapest'. Optional.)r rrr)r3 propertiesrequired)rr5 parameters desktop_uic t|dd|d|d|d|dS)Nr rrrrr)r rrrr)r/get)argskws rr>sa4xx%(( HHUOO*%%hhw ##    ru🔖)rtoolsetschemahandleremoji)rNNNN)__doc__r%typingrrtools.registryrrr!r#r*r/listANNOTATE_PREVIEW_SCHEMAregisterrrrrIs4 %%%%%%%%//////// ,f'JJ"#' .B.B .B #.Bsm.B C= .B x .B  .B.B.B.Bd  $!W / !m !Z !\%  .3)//d   "         r