idZddlmZddlZddlmZddlmZmZm Z ej e Z dZ dZdZdd Zdd ZddZddZddZd d!dZd"dZd#dZd$dZgdZdS)%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_promptopenclaw_residue_cleanupmodestrreturnc,|dkr dS|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.steeru💡 First-time tip — I steered your message into the current run; it will arrive after the next tool call instead of interrupting. Send `/busy interrupt` or `/busy queue` to change this, 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, `/busy steer` to inject them mid-run without interrupting, or `/busy status` to check. This notice won't appear again.r s 5/home/ubuntu/.hermes/hermes-agent/agent/onboarding.pybusy_input_hint_gatewayr#sH  w W   w G   Cc,|dkr dS|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, or /busy steer to inject mid-run. This tip only shows once.rz(tip) Your message was steered into the current run; it arrives after the next tool call. Use /busy interrupt or /busy queue to change this. This tip only shows once.z(tip) Your message interrupted the current run. Use /busy queue to queue messages for the next turn instead, or /busy steer to inject mid-run. This tip only shows once.rrs rbusy_input_hint_clir>sE w J   w 5   Frc 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_gatewayrSs 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_clir Rrc dS)uwBanner shown the first time Hermes starts and finds ``~/.openclaw/``. Points users at ``hermes claw migrate`` (non-destructive port of config, memory, and skills) first. ``hermes claw cleanup`` is mentioned as the follow-up step for users who have already migrated and want to archive the old directory — with a warning that archiving breaks OpenClaw. uWA legacy OpenClaw directory was detected at ~/.openclaw/. To port your config, memory, and skills over to Hermes, run `hermes claw migrate`. If you've already migrated and want to archive the old directory, run `hermes claw cleanup` (renames it to ~/.openclaw.pre-migration — OpenClaw will stop working after this). This tip only shows once.rrrropenclaw_residue_hint_clirbs $rhomeOptional[Path]boolc~|ptj} |dz S#t$rYdSwxYw)uReturn True if an OpenClaw workspace directory is present in ``$HOME``. Pure filesystem check — no side effects. ``home`` override exists for tests. z .openclawF)rris_dirOSError)rbases rdetect_openclaw_residuer%usR  49;;D{"**,,, uus . <<configMapping[str, Any]ct|tr|dnd}t|tsiS|d}t|tr|niS)N onboardingseen) isinstancerget)r&r)r*s r_get_seen_dictr-sh-7-H-HRL)))dJ j' * * >>& ! !DdG,, 444"4rflagc`tt||S)zEReturn True if the user has already been shown this first-touch hint.)r r-r,)r&r.s ris_seenr0s& 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)encodingr)r*Tz&onboarding: failed to mark flag %s: %s) yamlutilsr3 Exceptionloggerdebugexistsopen safe_loadr+r,dict)r1r.r5r3ecfgfr*s r mark_seenrAs +++++++  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_FLAGOPENCLAW_RESIDUE_FLAGrrrrrr%r0rA)r r r r )r r )N)rrr r )r&r'r r')r&r'r.r r r )r1rr.r r r )__doc__ __future__rloggingpathlibrtypingrrr getLogger__name__r8rBrCrDrrrrrr%r-r0rA__all__rrrrMsP  #"""""))))))))))  8 $ $&+26*&      55552222    F   r