+ iRt^RIt^RIHtHtHt^tRRRlltRRltRRR R R R R RRR RR R/RR RRR R/R]R R//RR.//t ^RI H t ] P!RR] R]RR7R#)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)ListOptionalCallablecV^8dQhR\R\\\,,R\\,R\/#)questionchoicescallbackreturn)strrrr)formats"//home/ubuntu/hermes-agent/tools/clarify_tool.py __annotate__rs>444 d3i 4x 4 4c V'dVP4'g\P!RR/RR7#VP4pVe\V\4'g\P!RR/RR7#VUu.uF=p\ V4P4'gK$\ V4P4NK? pp\ V4\8d VR\pV'gRpVf\P!RR/RR7#V!W4p\P!R TR TR \ T4P4/RR7#uupi \d(p\P!RRT 2/RR7uRp?#Rp?ii;i) 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. errorzQuestion text is required.F) ensure_asciiNz"choices must be a list of strings.z8Clarify tool is not available in this execution context.zFailed to get user input: rchoices_offered user_response) stripjsondumps isinstancelistr len MAX_CHOICES Exception)rrr crexcs&&& r clarify_toolrsX& 8>>++zz7$@APUVV~~H'4((::w(LM\ab b+2E7ac!flln>3q6<<>7E w<+ %l{+GGzz P Q    3  ::H7]+113  )F  zz 23%8 9   s*!E 'E  E FE;5F;Fc$V^8dQhR\/#)rr )bool)r s"r rrNsDrcR#)z>Clarify tool has no external requirements -- always available.Tr#rr check_clarify_requirementsr$Ns rnameclarify descriptionu 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. parameterstypeobject propertiesrstringz$The question to present to the user.rarrayitemsmaxItemszUp 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.required)registryc z\VPRR4VPR4VPR4R7#)rrr )rrr )rget)argskws&,r r7s/|*b)# # %ru❓)r%toolsetschemahandlercheck_fnemoji)NN) __doc__rtypingrrrrrr$CLARIFY_SCHEMAtools.registryr1registerr#rr rBs  ++  4n I C E &(+KR   ZL%%&T$    %(  r