+ lHjpIVRt^RIHt^RIHt^RIHtHtHtH t ^RI H t H t H t ^RIHt!RR] 4t!RR ] 4t!R R ] 4t!R R ]4t]!R]]RR7!RR]4t!RR]4t!RR] 4t]!R]]RR7!RR] 4t]!R]]RR7!RR] 4t]!R]]R R7!R!R"] 4t!R#R$]4t!R%R&]4t]!R']]R(R7!R)R*] 4t!R+R,]4t]!R-]]R.R7!R/R0] 4t!R1R2]4t]!R3]]R4R7!R5R6] 4t !R7R8]4t!]!R9] ]!R:R7!R;R<] 4t"!R=R>]4t#]!R?]"]#R@R7]!RA]"]#RBR7!RCRD] 4t$]!RE]$]#RFR7!RGRH]4t%!RIRJ] 4t&!RKRL]4t']!RM]%]'RNR7!RORP]4t(!RQRR]4t)]!RS](])RTR7!RURV] 4t*!RWRX]4t+]!RY]*]+RZR7!R[R\] 4t,!R]R^]4t-]!R_],]-R`R7!RaRb] 4t.!RcRd]4t/]!Re].]/RfR7!RgRh] 4t0!RiRj]4t1!RkRl]4t2]!Rm]1]2RnR7!RoRp] 4t3!RqRr]4t4!RsRt] 4t5!RuRv]4t6]!Rw]4]6RxR7!RyRz]4t7!R{R|]4t8]!R}]7]8R~R7!RR]4t9!RR]4t:]!R]9]:RR7!RR]4t;!RR]4t<!RR]<4t=]!R];]=RR7!RR]4t>!RR]<4t?]!R]>]?RR7!RR]<4t@]!R]>]@RR7!RR]4tA!RR] 4tB!RR]4tC]!R]A]CRR7!RR]4tD!RR]<4tE]!R]D]ERR7R#)aRPrompt submission, attachments, side agents, approvals, batch-clarify locks (``methods_prompt.py``) and voice / wake-word control (``methods_voice.py``). ``profile`` rides on every method here: the desktop routes session-scoped calls through ``requestForOwnedSession`` / ``requestForBot`` / ``requestGatewayForProfile``, which stamp it. ) annotations)Field) JsonValueParamsResultWireEnum) OpenModelPendingApproval SessionParams)methodc"]tRt^tRtRtRtRtR#) ClientSurfacezQWhere the user typed this turn; anything else is treated as the plain app window.hudz voice-liveN)__name__ __module__ __qualname____firstlineno____doc__r voice_live__static_attributes__rG/home/ubuntu/.hermes/hermes-agent/tui_gateway/contracts/prompt_voice.pyr r s[ CJrr cN]tRt^t$RtRtR]R&RtR]R&RtR]R &Rt R]R &Rt R]R &Rt R]R &Rt R]R &Rt R]R&RtR]R&RtR]R&RtR]R&RtR]R&RtR]R&RtR]R&RtR]R&]!RRRR7tR]R&]!RRRR7tR]R&]!RRRR7tR]R &R!tR#)"PromptSubmitParamsaf``text`` is normally a string; the relay / hosted paths may hand a structured (parts list) payload, and the busy path renders it. Truncation (rewind / edit / regenerate) needs explicit consent: ``confirm_truncate`` plus one durable target (``truncate_before_row_id`` preferred, ``truncate_before_message_id``, or the legacy ``truncate_before_user_ordinal``).rtextN str | None display_kind bool | None interruptedqueuedsurface voice_context voice_turn title_preview int | Nonetruncate_before_user_ordinaltruncate_before_row_idtruncate_before_message_idconfirm_truncateconfirm_empty_truncateconfirm_deep_truncatezlist[int] | Nonerebind_survivor_row_idsT _hosted_task)defaultexcludealiaszJsonValue | None hosted_task _turn_author turn_author_hosted_terminal_callbackhosted_terminal_callbackr)rrrrrr__annotations__rr r!r"r#r$r%r'r(r)r*r+r,r-rr2r4r6rrrrrrsX D)#L*##K#FKGZ $M:$"J " $M:$/3 *3)-J--1 1$(k(*.K.)-;-04-4%*$N$[K![$)$N$[K![16d*E2G.Grrc&]tRt^8tRtRtRtRtRtR#)PromptSubmitStatus streamingr!steered redirectedrN) rrrrr:r!r;r<rrrrr9r98sI FGJrr9c]tRt^?t$RtRtR]R&RtR]R&RtR]R&Rt R ]R &Rt R ]R &Rt R]R &Rt R]R&Rt R]R&RtR#)PromptSubmitResultz``status`` is absent only on the typed-stop-phrase reply (``voice_stopped``). After a truncation the survivor row ids let the client rebind its cached ``rowId``s (``None`` map entries: drop the cached id). ``turn_isolation`` marks a compute-host dispatch.NzPromptSubmitStatus | Nonestatusr voice_stoppedr& user_row_idzlist[int | None] | Nonesurvivor_user_row_idszdict[str, int | None] | Nonesurvivor_row_id_mapturn_isolationr admission_id forwardedr)rrrrrr?r7r@rArBrCrDrErFrrrrr>r>?scW)-F %,!%M;%#K"59298<5<"&NK& $L*#!I{!rr>z prompt.submitz_Send a user turn to a live session; busy sessions queue / steer / redirect instead of refusing.)paramsresultdoccT]tRt^Yt$RtRtR]R&RtR]R&RtR]R&Rt R]R&R t R#) ImageMetauQ``tui_gateway/server.py::_image_meta`` — dimensions when PIL can open the file.Nrnamer&widthheighttoken_estimater) rrrrrrLr7rMrNrOrrrrrKrKYs-[D*E:FJ!%NJ%rrKcz]tRt^bt$RtR]R&RtR]R&RtR]R&RtR]R &Rt R]R &Rt R]R &Rt R]R &R t R#)AttachedImageResultzU``methods_prompt.py::_attached_image_result``: the image is queued for the next turn.boolattachedNrpathr&count remainderrbytesmessager) rrrrrr7rTrUrVrrWrXrrrrrQrQbsF_ND*E: Iz D*E:GZrrQc]tRt^ntRtR#)ClipboardPasteParamsrNrrrrrrrrrZrZnrrZzclipboard.pastezNSave the host clipboard image into the session and queue it for the next turn.c"]tRt^vt$R]R&RtR#)ImageAttachParamsstrrTrNrrrrr7rrrrr^r^v Irr^z image.attachz5Queue a gateway-visible image file for the next turn.cT]tRt^~t$RtRtR]R&RtR]R&RtR]R&Rt R]R&Rt R#) ImageAttachBytesParamsu``content_base64`` (or the ``data`` alias) carries the bytes; ``filename`` / ``ext`` only hint the extension — magic bytes decide.Nrcontent_base64datafilenameextr) rrrrrrdr7rerfrgrrrrrcrc~s1-"&NJ%D*HjCrrczimage.attach_byteszNQueue an image uploaded as base64 (remote client); reply mirrors image.attach.cp]tRt^t$RtRtR]R&RtR]R&RtR]R&Rt R]R&Rt R]R &Rt R]R &R t R#) PdfAttachParamszHost ``path`` or base64 ``content_base64`` / ``data``; ``first_page`` / ``last_page`` bound the render (per-call page cap enforced server-side).NrrTrdrerfr& first_page last_pager) rrrrrrTr7rdrerfrjrkrrrrririsE8D*!%NJ%D*Hj!J ! Iz rric,]tRt^t$R]R&R]R&RtR#)PdfPager_rTintpagerNr`rrrrmrms I IrrmcT]tRt^t$R]R&R]R&R]R&R]R&R]R &R]R &R tR #) PdfAttachResultrRrSr_rfrnpages_attachedz list[PdfPage]pagesrUrrNr`rrrrqrqs"NM  J Irrqz pdf.attachzGRender a PDF's pages to PNG and queue them as images for the next turn.cF]tRt^t$RtRtR]R&RtR]R&RtR]R&Rt R#)FileAttachParamszq``path`` when the file is gateway-visible, else ``data_url`` carries the bytes; ``name`` labels an uploaded file.NrrTdata_urlrLr) rrrrrrTr7rvrLrrrrrurus'D*HjD*rrucT]tRt^t$R]R&R]R&R]R&R]R&R]R&R]R&R tR #) FileAttachResultrRrSr_rLrTref_pathref_textuploadedrNr`rrrrxrxs N I IMMNrrxz file.attachzOStage a non-image file into the session workspace and hand back its @file: ref.c"]tRt^t$R]R&RtR#)ImageDetachParamsr_rTrNr`rrrr}r}rarr}c,]tRt^t$R]R&R]R&RtR#)ImageDetachResultrRdetachedrnrUrNr`rrrrrs N Jrrz image.detachz,Drop a queued image before the turn is sent.c&]tRt^t$RtR]R&RtR#)InputDetectDropParamsNrrr)rrrrrr7rrrrrrs D*rrc^]tRt^t$RtR]R&RtR]R&RtR]R&RtR ]R &Rt R]R &R t R#) InputDetectDropResultz``matched: false`` alone when the text is not a drop; an image drop is queued immediately (``is_image`` + ``count``), a file drop only yields the ``text`` to insert.rRmatchedNris_imagerrTr&rUrr) rrrrrr7rrTrUrrrrrrrs7SM Hk D*E:D*rrzinput.detect_dropzWRecognise a terminal file drop pasted into the composer and turn it into an attachment.c"]tRt^t$R]R&RtR#)SideAgentParamsr_rrNr`rrrrrrarrc&]tRt^t$RtR]R&RtR#) TaskIdResultzkThe side agent runs detached; its answer lands on the parent session as an event carrying this ``task_id``.r_task_idrN)rrrrrr7rrrrrrsLrrzprompt.backgroundzYRun a task on a fresh agent in the background; the answer arrives as background.complete.z prompt.btwz[Side question over a snapshot of the live conversation; the answer arrives as btw.complete.c>]tRt^t$R]R&RtR]R&RtR]R&RtR#)PreviewRestartParamsr_urlNrcwdcontextr)rrrrr7rrrrrrrrs HCGZrrzpreview.restartzJSpawn a hidden agent that brings the desktop preview's dev server back up.cH]tRtRt$R]R&R]R&RtR]R&RtR ]R &R tR#) ClarifyLockParamsir_ request_id question_idrranswerNrprofiler)rrrrr7rrrrrrrrs!OFIGZrrc]tRtRtRtRtRtR#)ClarifyLockStatusiokexpiredrN)rrrrrrrrrrrrs BGrrc4]tRtRt$RtR]R&RtR]R&RtR#) ClarifyLockResulti u``remaining`` lists the qids still unanswered; the lock that empties it resolves the request. ``expired``: the wait already ended (timeout / cancel) — not an error.rr?Nzlist[str] | None remainingr)rrrrrr7rrrrrrr sP "&I&rrz clarify.lockzULock one answer of a batch clarify request (editable until every question is locked).c:]tRtRt$R]R&R]R&RtR]R&R tR#) RequestAnswerParamsir_idzdict[str, JsonValue]rHNrrrrrrrr7rrrrrrrs G  GZrrc"]tRtRt$R]R&RtR#)RequestAnswerResultirr?rNr`rrrrrs rrzrequest.answeruSAnswer an open server→client request from a client that never received the frame.c]tRtRtRtR#)ApprovalPendingParamsi*rNr[rrrrr*r\rrc"]tRtRt$R]R&RtR#)ApprovalPendingResulti.zlist[PendingApproval] approvalsrNr`rrrrr.s$$rrzapproval.pendingzIReplay the approvals still waiting on this session (reconnect / polling).c"]tRtRt$R]R&RtR#)ApprovalReceivedParamsi6r_rrNr`rrrrr6sOrrc"]tRtRt$R]R&RtR#)ApprovalReceivedResulti:rR acknowledgedrNr`rrrrr:srrzapproval.receivedzDTell the backend the card is on screen, so its timeout clock starts.cF]tRtRt$RtRtR]R&RtR]R&RtR]R&R t R#) ApprovalRespondParamsiBz``choice`` is one of the offered ``approval`` choices (once / session / always / deny); ``all`` resolves every pending approval, ``request_id`` a specific one, neither the oldest.Nrchoicerallrr) rrrrrrr7rrrrrrrrBs([FJC!J !rrc"]tRtRt$R]R&RtR#)ApprovalRespondResultiKrnresolvedrNr`rrrrrKsMrrzapproval.respondzcDeliver the user's decision on a dangerous command (falls back to durable identity on a stale sid).c&]tRtRtRtRtRtRtRtR#)VoiceToggleActioniVr?onoffttsrN) rrrrr?rrrrrrrrrVs F B C CrrcH]tRtRt$]P tR]R&RtR]R&Rt R#)VoiceToggleParamsi]ractionNrrr) rrrrrr?rr7rrrrrrr]s 1 8 8F 8GZrrc]tRtRt$RtR]R&R]R&R]R&RtR ]R &RtR ]R &RtR ]R &Rt R ]R&Rt R ]R&Rt R#)VoiceToggleResultibzu``methods_voice.py::_voice_status_payload`` (+ the requirements probe on ``status``, the spoken stop hint on ``on``).rRenabledr_ record_keyrNr stop_hintr availableaudio_available stt_availabledetailsr) rrrrrr7rrrrrrrrrrrbsJMO I Iz !I{!#'O['!%M;%GZrrz voice.togglezG/voice parity: report, flip voice mode on/off, or toggle speech output.c]tRtRtRtRtRtR#)VoiceRecordActionitstartstoprN)rrrrrrrrrrrrts E DrrcV]tRtRt$]P tR]R&RtR]R&Rt R]R&Rt R#) VoiceRecordParamsiyrrNr session_idrr) rrrrrrrr7rrrrrrrrys' 1 7 7F 7!J !GZrrc"]tRtRtRtRtRtRtR#)VoiceRecordStatusi recordingstoppedbusyrN)rrrrrrrrrrrrrsIG Drrc0]tRtRt$R]R&RtR]R&RtR#)VoiceRecordResultirr?Nrreasonr)rrrrr7rrrrrrrs FJrrz voice.recordzMVAD-bounded push-to-talk; the transcript arrives as a voice.transcript event.c0]tRtRt$R]R&RtR]R&RtR#)VoiceTtsParamsir_rNrrrrrrrrrs IGZrrc"]tRtRt$R]R&RtR#)VoiceTtsResultir_r?rNr`rrrrrs Krrz voice.ttsz;Speak text through the backend TTS engine (barge-in aware).cb]tRtRt$RtRtR]R&RtR]R&RtR]R&Rt R]R &Rt R]R &R t R#) WakeStartParamsiz``surface`` names the caller ("tui" | "gui"); ``persist`` is the explicit gesture that also flips ``wake_word.enabled`` on; ``client_capture`` asks for PCM streamed via wake.feed.Nrr"rpersistclient_capturerrr) rrrrrr"r7rrrrrrrrrrs<_GZG["&NK&!J !GZrrc]tRtRt$RtR]R&RtR]R&RtR]R&RtR]R &Rt R]R &Rt R]R &Rt R ]R &Rt R]R&Rt R]R&RtR]R&RtR#)WakeStartResultiz``started: false`` carries ``reason`` (unavailable / disabled / disabled_for_surface / owned); ``sample_rate`` / ``frame_length`` describe the PCM frames the armed detector expects.rRstartedNrrhintphraseprovider owner_surfacerenabled_persistedcapturer& sample_rate frame_lengthr)rrrrrr7rrrrrrrrrrrrrrrsj^MFJD*FJHj $M:$%){)GZ"K"#L*#rrz wake.startzIArm the wake-word listener for the calling surface; refusals explain why.c4]tRtRt$RtR]R&RtR]R&RtR#)WakeStopParamsiNrrrrr)rrrrrr7rrrrrrrsG[GZrrc*]tRtRt$RtRtR]R&RtR#)WakeOwnerResultiuk``methods_voice.py::_owner_result`` — ``reason: "not_owner"`` when the caller does not hold the listener.Nrrr)rrrrrrr7rrrrrrsFJrrc,]tRtRt$R]R&R]R&RtR#)WakeStopResultirRrdisabled_persistedrNr`rrrrrs Mrrz wake.stopzKStop this surface's listener; persist also writes wake_word.enabled: false.c&]tRtRt$RtR]R&RtR#)WakeControlParamsiNrrr)rrrrrr7rrrrrrs GZrrc"]tRtRt$R]R&RtR#)WakePauseResultirRpausedrNr`rrrrrs Lrrz wake.pausezBRelease the mic (e.g. while the desktop's browser captures audio).c"]tRtRt$R]R&RtR#)WakeResumeResultirRresumedrNr`rrrrrs Mrrz wake.resumezAReclaim the mic after a pause; no-op if the listener isn't armed.cB]tRtRt$RtR]R&RtR]R&RtR]R&RtR#) WakeStatusParamsiNrr"rrrr) rrrrr"r7rrrrrrrrs GZ"&NK&GZrrc~]tRtRt$RtRtR]R&RtR]R&RtR]R&Rt R ]R &Rt R ]R &Rt R ]R &Rt R]R&Rt R#)WakeInputDeviceiu```tools/wake_word.py::_describe_input_device`` — PortAudio diagnostics for the configured mic.Nzint | str | NoneselectorrrLerrorr&max_input_channelsz float | Nonedefault_samplerate hostapi_indexhostapir)rrrrrrr7rLrrrrrrrrrrrsNj!%H%D*E:%) )'+ + $M:$GZrrc]tRtRt$RtR]R&R]R&RtR]R&R ]R &R ]R &R ]R &R ]R&R]R&R ]R&R]R&R]R&R ]R&R]R&R]R&R]R&RtR#)WakeStatusResultiz``enabled`` is config truth; ``listening`` is this caller's armed detector; ``audio_silent`` means armed but deaf (see ``hint``).rR listeningowned_by_callerNrrr_rrconfigured_surfacer input_devicerrr audio_silentrlocal_input_availablernrrr)rrrrrr7rrrrrrrs`,O $M:$ KM!!O I M Lrrz wake.statuszTEverything a client needs to draw the wake-word state and decide whether to (re)arm.cT]tRtRt$RtRtR]R&RtR]R&RtR]R&Rt R]R &R t R#) WakeFeedParamsizQ``pcm`` (or the ``pcm_b64`` alias): base64 int16 mono little-endian, 16 kHz only.Nrpcmpcm_b64r&rrr) rrrrrr r7r rrrrrrr r s-[CGZ"K"GZrr c"]tRtRt$R]R&RtR#)WakeFeedResultirRfedrNr`rrrrrs Irrz wake.feedzLPush client-captured PCM into the armed detector (mic-less remote backends).N)Fr __future__rpydanticrbaserrrrcommonrr r registryr r rr9r>rKrQrZr^rcrirmrqrurxr}rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr rrrrrs#55== HGG<""&1:L ln&& )  = !5>Q [] ~/8K BD]$:CV [] !m !i f|OO TV}v}-6F \^  ~/8I 9;MI#8AV dfm6?< fh|OL hj= !5l WY ''~/8I bd& & 3. HJf $f $ |OO VXV f_ {>. XZo|-o OQ}.7G NPv i v*}-6F acV_{>. Y[r