߲j= dZddlZddlZddlmZmZmZmZdZdZ dZ dZ dZ d e fd Zd ee d ee fd Zd e d e fdZde d efdZdZde fdZd ee fdZdefdZd ed eee fdZd efdZd efdZd:deedededee d e f dZdeede d e fd Z d;de d eee d!ed"eeed#eed e f d$Zd efd%Z d&d'e d(ed)d*d"d+d,e d-d*d.d/id+d.d/ied0d.d1id2dgd3d4id"gd3d5Z!dd6l"m#Z#m$Z$e#jJd&d&e!d7e d89y) ``description`` > ``text`` > ``title`` (``name``/``value`` excluded: raw component enums, not labels). No match -> "" and dropped: no choice beats a garbage label.c3K|]E}tj|xtr"jrjGywN) isinstancegetstrstrip).0kcvs 7/home/ubuntu/.hermes/hermes-agent/tools/clarify_tool.py z"_flatten_choice..s>F1"a=1#61779WWYFsA A)label descriptiontexttitle c32K|]}t|ywr _flatten_choice)rxs rrz"_flatten_choice..s6q*6)r rrdictnextlisttuplejoin)rrs`@rrrs !Swwy!TF(QFGIK K!dE]#xx6A66<<>>2.A .choicesc|rt|djnd}t|dks|t|k7r|S|dtgt |ddzS)zSuffix the first choice (schema says best-first) with RECOMMENDED_LABEL; idempotent, and a lone choice is left untouched (nothing to prefer it over).rrrN)rrlenstrip_recommendedRECOMMENDED_LABELr$)r(firsts rmark_recommendedr0#sb(/C O ! ! #BE 7|a5$5e$<<gQ() * +d712;.? ??r'rct|j}|jjtjr!|dt t jS|S)zSRemove the recommendation label so presentation never leaks into ``user_response``.N)rrcasefoldendswithr.r,)rstrippeds rr-r-,sX4y H##$5$>$>$@A13011288:: Or'namec tj|j}||vxs t d|j DS#ttf$rYywxYw)zSignature-inspect (never a TypeError retry, which could re-prompt the user) whether ``callback`` takes ``name`` or ``**kwargs``; non-introspectable callables are legacy.Fc3jK|]+}|jtjjk(-ywr )kindinspect Parameter VAR_KEYWORD)rps rrz!_accepts_kwarg..;s% bQ7+<+<+H+H!H bs13)r9 signature parameters TypeError ValueErroranyvalues)callbackr5paramss r_accepts_kwargrE4s\""8,77 6> bS bRXR_R_Ra bbb z "sAAAcBt|dr ||||S|||S)z@Invoke the platform callback, passing multi_select if supported. multi_select)rG)rE)rCquestionr(rGs r_invoke_callbackrI>s(h/' EE Hg &&r'rawc tj|}t||r|SdS#tj$rYywxYw)zJ``json.loads(raw)`` when it decodes to an instance of ``kind``, else None.N)jsonloadsJSONDecodeErrorr )rJr8parseds r_json_asrPEsDC -6747   s '==cP|}t|tsOt|j}|j drt |tnd}||j d}|Dcgc]5}t|jst|j7c}Scc}w)zRParse a list / JSON array / comma-separated reply into stripped non-empty strings.[N,)r r$rr startswithrPsplit) raw_responseitemsrJrs r_parse_multi_select_responserYNsx E eT "%j '*~~c':d# =IIcNE$) .`s?!?1-?r!N) MAX_CHOICES)r(scleaneds r_clean_choicesrb^s4?w?EQ1qEGE  ``(normalized, error)``; an empty list gives ``(None, None)`` (fall back to the single-question path). Entries carry ``qid`` (stable wire id ``q`` surfaces key answers by; the model's ``id`` is unvalidated text, only echoed), ``question``, decorated ``choices``, bare ``choices_offered``, ``multi_select``.)Nz/questions must be an array of question objects.)NNNzquestions supports at most z items.rHz questions[z&] must be an object with a 'question'.rz"].question must be non-empty text.r(z].choices must be a list.qidrG)qidrhrHr(choices_offeredrG) r r$r, MAX_QUESTIONS enumeraterr"rrrbappendr0bool) questions normalizedindexitemrr(s r_normalize_questionsrsjs i &F  9~ %2=/IIIJ +O t dC %D$%:eW,RSS S488J'-2.446:eW,NOO O((9%  gt,z%0IJJJ$W-Gug;c$((4.*>B&?&E&E&G&O4]a:A'W 6t07tG}T .!9:LtG} N OO$ t r'rpanswers timed_outnoticec g}|D]R}|j|d}|ji|drd|dini|d|d|rt||dnddTd|i}|rd |d <|rt||d <t j |d S)aEBatch result JSON; unanswered -> "". The top-level ``timed_out`` flag (present only when true) tells the agent whether blanks are deliberate skips or the user walking away; ``notice`` (surface-supplied, only beside ``timed_out``) says WHY the wait ended, so an undeliverable prompt never reads as user inactivity.rirhrHrjrGrrHrj user_response responsesTrurvF ensure_ascii)rrmr\rrLdumps)rprtrurvrzentryrJresults r _batch_resultrs IXkk%,'W&+DkeDk"rWj)eDU>VJM]3n0EFSUW XX "-i 8F"{ "6{F8  ::f5 11r'rHci}d}d}t|dr||d|}t|}t|trt |t }t|t rIt |j dxsi}t|j d}|j d}t||||S|D]0}t||d|d |d }t|rd }n |||d <2t|||S) aDispatch a validated batch. Batch-capable callbacks (``questions`` kwarg) get the whole list once and reply ``{"answers": {qid: raw}, "timed_out"?}`` as a dict or JSON string (the tui_gateway bridge only carries strings); any other falsy/unparseable reply is a cancel-all (mirrors the single-question skip). Legacy callbacks are looped per question: an empty answer is a skip, a timeout (``None`` or the sentinel) means the user walked away so the loop aborts instead of pestering them; earlier answers are kept.FNro)rortrurvrHr(rGTri) rErer rrPr"rrnrrI)rprCrHrtrurvrJr~s r _run_batchrsGI Fh ,x<$ c3 3%C c4 3779-34GSWW[12IWWX&FZ)VDD$xz):E) str`` is platform injected (batch-capable ones also take ``questions=``). Returns result JSON. Args: question: The question text to present. choices: Up to 4 predefined answer choices. When omitted the question is purely open-ended. multi_select: When True, the user can select multiple choices (checkboxes). The ``user_response`` in the output JSON will be a list of strings instead of a single string. Has no effect when ``choices`` is omitted. questions: Up to 5 independent questions asked as one batch (issue #18450). When present (non-empty), the single ``question``/``choices``/``multi_select`` parameters are ignored and the result JSON is ``{"responses": [...]}`` (plus ``"timed_out": true`` when the user stopped answering partway). callback: Platform-provided function that handles the actual UI interaction. Batch-capable platforms additionally accept a ``questions`` keyword and receive the normalized list in one call; platforms without it are looped one question at a time. Injected by the agent runner (cli.py / gateway). NrzFailed to get user input: uNo question provided. Pass questions=[{question: '...', choices?: [...], multi_select?: bool}, ...] — a single question is a one-entry array.z"choices must be a list of strings.rxFr{)rs tool_error _UNAVAILABLErrr Exceptionr r$rbr0rIrLr}r\) rHr(rGrorCrperrorexcshownrVs r clarify_toolrso"0; E e$ $ !,// F!*hHN8K8Q8Q8STT 8>>+23 3~~H'4(BC C ),'')0)< W %$E>'(E<P  ::8(5lLDhU\dhUh(ik#( **) F!$>se"DEE F$ >6se<==>s;'D D- D* D%D*%D*- E6 E E Ecy)z>Clarify tool has no external requirements -- always available.Trr'rcheck_clarify_requirementsrs r'clarifyzAsk the user one or more questions when you need a decision, clarification, or feedback before proceeding. Pass every question in `questions` (1-u entries) — a single question is a one-entry array, and several INDEPENDENT questions belong in ONE call (one form beats a chain of clarify calls; if one answer would change another question, ask separately). Per question: single-select (up to u choices — put your recommended option FIRST, the UI marks it '(Recommended)' and auto-appends an 'Other' free-text row), multi-select (multi_select=true), or open-ended (omit choices). Options go ONLY in `choices`, never enumerated inside the question text (choices render as pickable rows; options written into the question are dead prose the user can't click). Result: {responses: [...]} in question order (plus timed_out=true, and a notice saying why, if the user stopped part-way or the prompt could not be delivered). Prefer deciding low-stakes questions yourself; don't use this for dangerous-command confirmation (the terminal tool handles that).objectarrayr+zThe question(s). Each: question text (options excluded), optional choices (recommended first; omit for free-text), optional multi_select. Responses come back in question order with the question text echoed.typestring)rrWmaxItemsboolean)rHr(rG)r propertiesrequired)rminItemsrrrW)r5rr>)registryrc t|jdd|jd|jdd|jd|jdS) NrHrr(rGFrorC)rHr(rGrorC)rr)argskws rr6sK|*b)#XXne4((;' #  %r'u❓)r5toolsetschemahandlercheck_fnemojir )NFNN)&__doc__r9rLtypingrrrrr_rkrdr.rrrr0r-rnrErIrPrYr\r$rbrer%rsr"rrrrCLARIFY_SCHEMAtools.registryrrregisterrr'rrse3 11  N$I  /# /@d3i@DI@CCc3c4c'8#8=$s)=rdr )D)Xd3i%8) UU uB2d4j242D2RZ[^R_2kn2(94:93939:[`X\0*30*$s))<0*SW0*$T$Z00*CKHCU0*ad0*fD  *O, !,} -9  9& ); %%+X$6$+&,h%7(3$ *0(;#",   @!ME#+9x0    % (  r'