eiBdZddlmZddlZddlmZddlmZmZm Z ej e Z dZ dZdd Zdd Zdd ZddZddZddZddZgdZdS)u Contextual first-touch onboarding hints. Instead of blocking first-run questionnaires, show a one-time hint the *first* time a user hits a behavior fork — message-while-running, first long-running tool, etc. Each hint is shown once per install (tracked in ``config.yaml`` under ``onboarding.seen.``) and then never again. Keep this module tiny and dependency-free so both the CLI and gateway can import it without pulling in heavy modules. ) annotationsN)Path)AnyMappingOptionalbusy_input_prompttool_progress_promptmodestrreturnc|dkr dS dS)uHint shown the first time a user messages while the agent is busy. ``mode`` is the effective busy_input_mode that was just applied, so the message matches reality ("I just interrupted…" vs "I just queued…"). queueu💡 First-time tip — I queued your message instead of interrupting. Send `/busy interrupt` to make new messages stop the current task immediately, or `/busy status` to check. This notice won't appear again.u💡 First-time tip — I just interrupted my current task to answer you. Send `/busy queue` to queue follow-ups for after the current task instead, or `/busy status` to check. This notice won't appear again.r s 2/home/div/.hermes/hermes-agent/agent/onboarding.pybusy_input_hint_gatewayr"s-  w W   Fc|dkr dS dS)z=CLI version of the busy-input hint (plain text, no markdown).rz(tip) Your message was queued for the next turn. Use /busy interrupt to make Enter stop the current run instead. This tip only shows once.z(tip) Your message interrupted the current run. Use /busy queue to queue messages for the next turn instead. This tip only shows once.rrs rbusy_input_hint_clir5s) w (   $rc dS)Nu💡 First-time tip — that tool took a while and I'm streaming every step. If the progress messages feel noisy, send `/verbose` to cycle modes (all → new → off). This notice won't appear again.rrrrtool_progress_hint_gatewayrDs Arc dS)Nz(tip) That tool ran for a while. Use /verbose to cycle tool-progress display modes (all -> new -> off -> verbose). This tip only shows once.rrrrtool_progress_hint_clirLs RrconfigMapping[str, Any]ct|tr|dnd}t|tsiS|d}t|tr|niS)N onboardingseen) isinstancerget)rrrs r_get_seen_dictr!Wsh-7-H-HRL)))dJ j' * * >>& ! !DdG,, 444"4rflagboolc`tt||S)zEReturn True if the user has already been shown this first-touch hint.)r#r!r )rr"s ris_seenr%_s& v&&**400 1 11r config_pathrc ddl}ddlm}n3#t$r&}td|Yd}~dSd}~wwxYw i}|r@t|d5}||pi}dddn #1swxYwYt| dtsi|d<|d d }t|ts i}||dd <| |d urd Sd ||<|||d S#t$r'}td ||Yd}~dSd}~wwxYw) u Persist ``onboarding.seen. = True`` to ``config_path``. Uses the atomic YAML writer so a concurrent process can't observe a partially-written file. Returns True on success, False on any error (including the config file being absent — onboarding is best-effort). rN)atomic_yaml_writez+onboarding: failed to import yaml/utils: %sFzutf-8)encodingrrTz&onboarding: failed to mark flag %s: %s) yamlutilsr( Exceptionloggerdebugexistsopen safe_loadrr dict)r&r"r*r(ecfgfrs r mark_seenr6ds +++++++  BAFFFuuuuu      .kG444 .nnQ''-2 . . . . . . . . . . . . . . .#'',//66 # "C < $$V,,$%% -D(,C f % 88D>>T ! !4T +s+++t  =tQGGGuuuuusS =8='D-(B  D- BD-BBD-D-- E7EE)BUSY_INPUT_FLAGTOOL_PROGRESS_FLAGrrrrr%r6)r r r r )r r )rrr r)rrr"r r r#)r&rr"r r r#)__doc__ __future__rloggingpathlibrtypingrrr getLogger__name__r-r7r8rrrrr!r%r6__all__rrrrAs  #"""""))))))))))  8 $ $&+&    55552222    F   r