߲j dZddlZddlmZddlmZmZdZddededed ed ef d Z d d ddddddddddde edddddgddZ d e fdZ ejd de e ddy)uMPoint at something in the Hermes desktop GUI and say one line about it — the quiet sibling of ``tour`` (same ``data-tour`` handles) with no scrim/spotlight/paging. Fire-and-forget: a tip is not a question, so blocking on a round-trip would stall the reply. Lives in ``desktop_ui`` and withdraws itself when the user turns tips off.N) desktop_ui)registry tool_error)toprightbottomlefttextselectortitlesidereturnc|xsdj}|xsdj}|s tdS|s tdS|r*|tvr"tddjtdS||dd|fd |ffDcic] \}}|s || c}}} t j d |}|s td Stjd|ddScc}}w#t $r}td |cYd }~Sd }~wwxYw)z-Show one tip bubble anchored to ``selector``.u0tip needs text — the one line the bubble says.ztip needs a selector to point at. Call tour(action='targets') to see what's on screen and prefer a target reporting stable: true.zside must be one of: z, .)r r r r ztip.showzFailed to show the tip: Nz0tip is only available in the Hermes desktop app.T)successr F) ensure_ascii) striprSIDESjoinremit Exceptionjsondumps) r r r r kvpayloadokexcs 3/home/ubuntu/.hermes/hermes-agent/tools/tip_tool.pytip_toolr!s JB   DB%%'H LMM YZ Z E!1$))E2B1C1EFF#TM%,e$4vtn#EK41a!Q$KMG< __Z 1 LMM ::$H=E RRL <4SE:;; C CC C8 C3-C83C8show_tipuPoint at one thing in the desktop UI with a small arrow bubble (no dimming, no tour chrome) — for when a sentence is clearer with a finger on its subject. Get selectors from tour(action='targets'), prefer stable:true, never guess. One tip at a time (new replaces last); say the same thing in chat too — the bubble is a pointer, not the message. Sparingly: a bubble every turn stops being read.objectstringzThe one-sentence bubble text.)type descriptionzSelector from tour targets.zOptional heading.z&Omit for 'top'; flips at screen edges.)r%enumr&r r r r )r% propertiesrequired)namer& parametersc0tjddS)uHThe user's Settings → Appearance switch. On unless they turned it off. in_app_tipsT)default)r user_enabledr check_tips_enabledr3Hs  " "=$ ??r2rc `tdidDcic]}||j|dc}Scc}w)Nr(rr1)r!get)argskwrs r r8Os2x O'L M!1dhhq"o  M O Ms+ u💡)r+toolsetschemacheck_fnhandleremoji)rr)__doc__rtoolsrtools.registryrrrstrr!list TIP_SCHEMAboolr3registerr1r2r rFsU  /*S3S#ScScS3S.  L!> !< !2 !U G &Z(+! H@D@  \*GY O  r2