i[ dZddlZddlmZmZmZdZ ddedeeedeedefd Zde fd Z d d d ddddddieddddgddZ ddl m Z mZe jd d e de ddS)a Clarify Tool Module - Interactive Clarifying Questions Allows the agent to present structured multiple-choice questions or open-ended prompts to the user. In CLI mode, choices are navigable with arrow keys. On messaging platforms, choices are rendered as a numbered list. The actual user-interaction logic lives in the platform layer (cli.py for CLI, gateway/run.py for messaging). This module defines the schema, validation, and a thin dispatcher that delegates to a platform-provided callback. N)ListOptionalCallablequestionchoicescallbackreturncT|r|stdS|}|[t|tstdSd|D}t |t kr|dt }|sd}|t jddidS |||}n2#t$r%}t jdd |idcYd}~Sd}~wwxYwt j||t|d dS) a Ask the user a question, optionally with multiple-choice options. Args: question: The question text to present. choices: Up to 4 predefined answer choices. When omitted the question is purely open-ended. callback: Platform-provided function that handles the actual UI interaction. Signature: callback(question, choices) -> str. Injected by the agent runner (cli.py / gateway). Returns: JSON string with the user's response. zQuestion text is required.Nz"choices must be a list of strings.cg|]D}t|#t|ES)strstrip).0cs 7/home/ubuntu/.hermes/hermes-agent/tools/clarify_tool.py z clarify_tool..3s9EEEac!ffllnnE3q66<<>>EEEerrorz8Clarify tool is not available in this execution context.F) ensure_asciizFailed to get user input: )rchoices_offered user_response) r tool_error isinstancelistlen MAX_CHOICESjsondumps Exceptionr)rrr rexcs r clarify_toolr"s& 88>>++86777~~H'4(( DBCC CEE7EEE w<<+ % %l{l+G Gz P Q      733    z 8388 9          :"]++1133    s2 B?? C. C)#C.)C.cdS)z>Clarify tool has no external requirements -- always available.Tr r rrcheck_clarify_requirementsr$Ns 4rclarifyu Ask the user a question when you need clarification, feedback, or a decision before proceeding. Supports two modes: 1. **Multiple choice** — provide up to 4 choices. The user picks one or types their own answer via a 5th 'Other' option. 2. **Open-ended** — omit choices entirely. The user types a free-form response. Use this tool when: - The task is ambiguous and you need the user to choose an approach - You want post-task feedback ('How did that work out?') - You want to offer to save a skill or update memory - A decision has meaningful trade-offs the user should weigh in on Do NOT use this tool for simple yes/no confirmation of dangerous commands (the terminal tool handles that). Prefer making a reasonable default choice yourself when the decision is low-stakes.objectstringz$The question to present to the user.)type descriptionarrayr(zUp to 4 answer choices. Omit this parameter entirely to ask an open-ended question. When provided, the UI automatically appends an 'Other (type your answer)' option.)r(itemsmaxItemsr))rr)r( propertiesrequired)namer) parameters)registryrc t|dd|d|dS)Nrrr )rrr )r"get)argskws rr7sD|*b))## ## % % %ru❓)r/toolsetschemahandlercheck_fnemoji)NN)__doc__rtypingrrrrrr"boolr$CLARIFY_SCHEMAtools.registryr1rregisterr rrrCss   ++++++++++  $(#'444 d3i 4x 4 4444nD  C !E   (+'R      L%%&&T0///////    % %(       r