+ lHjMa0t$Rt^RIHt^RIt^RIt^RIt^RIt^RIt^RI t ^RI t ^RI t ^RI t ^RI Ht^RIHt^RIHtHtHtHtHt^RIHt^RIHtHtHtHt]P<!R4tR t R R lt!R t"R RRRRRRRRR RRRRRRRRRR/ t#R]$R&RRR RR!RR"RR#RR$RR%R&R'R(/t%R]$R)&R*R+lt&RaR,R-llt'R.^^ut(t)t*.RbOt+]!R/R07!R1R244t,R3R4RcR5R6/R7R4RdR5R6/R8R4RcR5R6//t-R9]$R:&RaR;R<llt.R=R>/R?R@llt/RARBlt0RCRDlt1RERFlt2RG^RHR>RIR//RJRKllt3RLRMlt4RNROlt5RPRQlt6](])]*3RRRSllt7RTRUlt8RVRWlt9RXRYlt:RZR[lt;R\R>/R]R^llt/R_R`llt=R#)eaLong-form chunking, ffmpeg encoding, container repair and delivery packing (``tools.tts_tool``). Provider-agnostic post-processing: split text under a per-request cap, wrap raw PCM as WAV, convert WAV/MP3 to the target container, sniff/repair mislabelled ``.ogg`` files, and combine final-encoded chunks under a destination platform's upload limit. Also home of the sibling helpers ``_origin`` / ``_section`` / ``_remove_quietly``. ) annotationsN) dataclass)Path)AnyDictListOptionalTuple)windows_hide_flags)BUILTIN_TTS_PROVIDERS#DEFAULT_COMMAND_TTS_MAX_TEXT_LENGTH_get_named_provider_config_is_command_provider_configztools.tts_toolc^RIHpV#)zO``tools.tts_tool``, resolved per call so seams monkeypatched there still apply.tts_tool)toolsrrs 8rc\V\4'dVPV4MRp\V\4'dV#/#)zC``tts.`` as a dict (``null``/non-dict sections read as empty).N) isinstancedictget)rrsections&& r_sectionr$&s5%/ D%A%AjnnS!tG $//77R7riedgeiopenaiixaii:minimaxi'mistralgeminii} elevenlabsneuttsi kittenttspiperzdict[str, int]PROVIDER_MAX_TEXT_LENGTH eleven_v3 eleven_ttv_v3eleven_multilingual_v2eleven_multilingual_v1eleven_english_sts_v2eleven_english_sts_v1eleven_flash_v2i0ueleven_flash_v2_5i@ ELEVENLABS_MODEL_MAX_TEXT_LENGTHc V^8dQhRRRR/#)rvaluerrz Optional[int]r)rs"rrrDsccccrcp\V\4'd \V\4'g V^8dV#R#)z6*value* when it is a positive non-bool int, else None.N)r intbool)r:s&r _positive_intr>Ds-uc**:eT3J3JuWXy5b^bbrc$V^8dQhRRRRRR/#)rprovider Optional[str]rOptional[dict[str, Any]]rr<r)rs"rrrIs#$$}$BZ$fi$rcfV'g\#VP4P4pT;'g/p\W24p\ VP R44pV'dV#VR8XdX^RIHpVP R4;'gTp\P \V4P44pV'dV#V\9d\V,#V\9dE\W24p \V 4'd)\ V P R44;'g\#\#)aUInput-character cap for *provider*: ``tts..max_text_length`` > ElevenLabs model table > ``PROVIDER_MAX_TEXT_LENGTH`` > command provider's own ``max_text_length`` (else ``DEFAULT_COMMAND_TTS_MAX_TEXT_LENGTH``) > ``FALLBACK_MAX_TEXT_LENGTH``. Non-positive / non-int overrides fall through so a broken config can't disable truncation.max_text_lengthr+)DEFAULT_ELEVENLABS_MODEL_IDmodel_id)FALLBACK_MAX_TEXT_LENGTHlowerstripr$r>r"tools.tts_tool_providersrEr8rr/r r rr ) r@rrcfgprov_cfgoverriderErFmappednameds && r_resolve_max_text_lengthrPIs '' ..  "C   C!HX\\*;<=H lH<< +JJ/J155c(m6I6I6KL M &&',, ''*34 &u - - +eeBe e ##ri]T)frozencT]tRt^ot$RtR]R&R]R&RtR]R&]R R l4tR t R #) AudioDeliveryProfilez9Destination-platform constraints for generated TTS audio.rplatformr<max_file_bytes333333?float safety_ratiocV^8dQhRR/#)rrr<r)rs"rr!AudioDeliveryProfile.__annotate__xsDD3Drc b\^\VPVP,44#)z:Conservative packing target below the platform hard limit.)maxr<rUrX)selfs&rtarget_file_bytes&AudioDeliveryProfile.target_file_bytesws'1c$--0A0AABCCrrN) __name__ __module__ __qualname____firstlineno____doc____annotations__rXpropertyr^__static_attributes__rrrrSrSos.CML% DDrrSdiscordrUrXrVtelegramdefaultzdict[str, dict[str, Any]]_PLATFORM_AUDIO_DEFAULTSc$V^8dQhRRRRRR/#)rrTrArrBrrSr)rs"rrrs) o o o)A oMa orcT;'gRP4P4;'gRp\\P V4;'g\R,4p\ \ VR4V4pTP VP4UUu/uF wrVVfK WVbK upp4\VP R44;'g\R,R,pVP RR4p\V\4'g.\V\\34'd^Tu;8d^8:gMRp\W'\V4R7#uuppi)zSResolve upload constraints, including optional ``tts.delivery_profiles`` overrides.rjdelivery_profilesrUrXrV)rTrUrX)rHrIr!rkr"r$updateitemsr>r r=r<rWrS) rTrrdefaults overrideskvrUrXs && r_resolve_audio_delivery_profilerus  y ' ' ) / / 1 > >YC,005\\9QR[9\]H*.ABCHI OOioo&7I&7da1TQT&7IJ#HLL1A$BCOO1)<=MN<<5L<&&jU|.T.T|(q( Z_`lZm nnJs E 'E slice_oversizedFc(V^8dQhRRRRRRRR/#)rpieces list[str] max_charsr<rvr=rr)rs"rrrs)I#4\erc aa.pRpVFoV'd^\S4S8dNV'dVPV4RpVPVV3Rl\^\S4S444KhV RS 2P 4pV'd&\V4S8dVPV4SpKTpK V'dVPV4V#)zGreedily join *pieces* with single spaces, starting a new chunk past *max_chars*. With ``slice_oversized`` an over-long piece flushes the running chunk and emits its hard slices as their own chunks (the tail slice is not merged with following pieces).c3:<"TFpSWS,xK R#5iNr).0irzpieces& r "_pack_under_cap..sZ:YQ%i-0:Ys )lenappendextendrangerI)rxrzrvchunkscurrent candidaters&f$ @r_pack_under_caprsFG s5zI5 g& MMZ%3u:y:YZ Z iq(..0 s9~ 1 MM' "GG g Mrc$V^8dQhRRRRRR/#)rsentencerrzr<rryr)rs"rrrs&NNNN Nrc:\VP4VRR7#)zGSplit one over-limit sentence on word boundaries, then hard boundaries.T)rv)rsplit)rrzs&&r_split_oversized_sentencers 8>>+Y MMrc$V^8dQhRRRRRR/#)rtextrrzr<rryr)rs"rrrs!00c0c0i0rcV^8:d\pRPT;'gRP44pV'g.#\V4V8:dV.#.p\ RR\ P!RV444F@p\V4V8:dVP V4K&VP\WA44KB \W14#)zDSplit text under a provider cap without dropping normalized content.rr|Nc3@"TFqP4xK R#5ir~)rI)rss& rr&_split_text_for_tts..s!_5^''))5^sz(?<=[.!?;:,])\s+) rGjoinrrfilterrerrrr)rrz normalizedexpandedrs&& r_split_text_for_ttsrsA~, 4::2,,./J   :)#|H4!_RXX>QS]5^!_` x=I % OOH % OO5hJ K a 8 //rc$V^8dQhRRRRRR/#)r audio_pathsryprofilerSrzlist[list[str]]r)rs"rrrs# 5 5 5DX 5]l 5rcx.p.p^RrTVFp\V4P4P\V4PP 4rV'd2WG,VP 8gW8wdVP V4.^rCVP V4WG,TrTK V'd W#.,#T#)z[Group final-encoded chunks under the size target; never mixes suffixes (can't concat-copy).r|)rstatst_sizesuffixrHr^r) rrgroupsr current_sizecurrent_suffixpathsizers && r_pack_audio_files_for_deliveryrs FG#$b.Dz(00$t*2C2C2I2I2Kf  +g.G.GG6Kc MM' "$&\t'3':Fn ")6I 4f4rtimeoutcheckcapturec 0V^8dQhRRRRRRRRR RR R /#) rffmpegrargsryrr<rr=rrzsubprocess.CompletedProcessr)rs"rrrsDXX X X.1X?CXVZX Xrc j\P!V.VOWCV\P\4R7#)zDRun ``ffmpeg `` headless (no stdin, hidden window on Windows).)capture_outputrrstdin creationflags) subprocessrunDEVNULLr )rrrrrs&&$$$r _ffmpeg_runrs3 >>6/D/'X_ * 2 2BTBV XXrc V^8dQhRRRR/#)rrrArNoner)rs"rrrs-DrclV'd\P!V4R#R# \dR#i;i)zGBest-effort unlink (missing/locked files are ignored); None is a no-op.N)osremoveOSError)rs&r_remove_quietlyrs.   IIdO    s $ 33c V^8dQhRRRR/#)r output_pathrrr)rs"rrrscc3c3crctVPR4'dV#VPR^4^,R,#)zOPath a WAV-native engine writes to before conversion to *output_path*'s format..wav.)endswithrsplit)rs&r_wav_sidecar_pathrs7%..v66;bKWrite in-memory WAV to *output_path*, ffmpeg-converting to its container. ``.ogg`` is forced to Opus (ffmpeg's .ogg default is Vorbis, which voice bubbles reject). A failed conversion raises RuntimeError; without ffmpeg the raw WAV is written under the requested name (misleading extension, but the audio still plays).rwbNF)rdeleter.oggrrrrutf-8ignoreerrors:Ni,Nzffmpeg conversion failed: zEffmpeg not found; writing raw WAV to %s (extension may be misleading))rHropenwritetempfileNamedTemporaryFilenamerr_OPUS_VOICE_ARGSr returncodestderrdecode RuntimeErrorloggerwarningcopyfiler) rrftmprropusresultrs && r_write_wav_bytes_asrsp ##F++ +t $ $ GGI %  $ $F5 A AS )88 B "h' '2'8'8':'C'CF'K'K#QSD xX$XXkX7XKXZF  A%--gh-GM"%?x#HII& NNbdo p OOHk 2! )% $ A A A !s0E>6FF&;$F& BF&> F  F# & F3c V^8dQhRRRR/#)rmp3_pathrrrAr)rs"rrr!swwsw}wrc b^RIHpV!VR^VPR^4^,R,R7#)zOConvert any ffmpeg-readable audio file to OGG Opus next to it; None on failure.transcode_to_ogg_opus48krrbitraterr)gateway.platforms.baserr)rrs& r_convert_to_opusr!s2< 5"RZRaRabeghRijkRlouRu vvrc V^8dQhRRRR/#)rrrrr)rs"rrr,src^RIHp\VR4;_uu_4pV!VP^ 44;'gRuuRRR4# +'giR#;i \dR#i;i)zFReturn a container id ('ogg', 'wav', 'mp3', 'flac', ...) or 'unknown'.)sniff_containerrbunknownN)tools.audio_containerr rreadr)rr fhs& r_sniff_audio_containerr,sQ5 $  "2772;/<<9    s-A!A A A AA A+*A+c V^8dQhRRRR/#)rfile_strrrr)rs"rrr6sCCrcXVPR4'd \V4MRpVR 9dV#\PRW4^RIHpV!VR^VR7pV'dV#VRR  RV 2p\ P!W4\PR Y4T# \dTu#i;i) zEnsure a ``.ogg`` path really holds Ogg: transcode in place, else rename to the sniffed real extension so platforms get an honest file instead of a 0-second voice bubble.rogguITTS wrote %s bytes into a .ogg path (%s) — transcoding to real Ogg/OpusrrrNrubCould not transcode %s to Ogg/Opus — renamed to %s so the file is delivered with its real format)rr ) rrrinforrrreplacerr)r containerrrepairedhonests& r_repair_ogg_containerr6s5=4E4Ef4M4M&x0SXI&& KK[]fq<$XubV^_H" a { +F 8$ NN<=EO M s+B B)(B)voice_compatiblec(V^8dQhRRRRRRRR/#) rrryrrrr=rrAr)rs"rrrLs*$$Y$S$W[$hu$rc V'g \R4h\V4^8Xdi\PP V^,4\PP V48wd\ P !V^,V4V#\ P!R4pV'gR#\V4pVPPRRR7VPRVP R\P!4P R24pVPRVP R\P!4P RVP" 24pR P%R V44pVP'VR R 7R RRRRRRR\)V4R. pVP"P+4p V'gV R 9d V.R!O, pMLV R8XdF\,;QJdRV4F 'dK RM RM !RV44'd VRR., p\/V.VO\)V4N^xR7p V P0^8XdlVP34'dVVP54P6^8d7\P8!Wd4\)V4WV3Fp \;V 4K #\<P?RV P@PCR RR7R,4WV3Fp \;V 4K R# \D\FPH3d!p \<P?RT 4Rp ? LMRp ? ii;i YV3Fp \;T 4K i;i)"zCombine independently encoded chunks with ffmpeg (never byte-joined). OGG/Opus is always re-encoded (even without voice opt-in); matching MP3 chunks keep their frames (``-c:a copy``). None when ffmpeg is missing/fails so callers keep the valid parts.zNo audio chunks to combinerNTparentsexist_okrz .concat.txtz .combiningr|c3"TF<pR\P!\PP V44 R2xK> R#5i)zfile  N)shlexquoterrabspath)rps& rr&_concat_audio_files..^s0[{!E%++bggooa.@"A!B"E{sAAr)encodingrrrz-fconcatz-safe0rz-vn-c:a.mp3c3n"TF+p\V4PP4R8HxK- R#5i)r-N)rrrH)rrs& rrr(ds*%bVadd4j&7&7&=&=&?6&IVas35Fcopy)rzffmpeg audio combine failed: %srr:NiN>r.opus)r,libopus-ac1-b:a64k-vbroff)% ValueErrorrrrr&rrrrparentmkdir with_nameruuiduuid4hexstemrr write_textrrHallrrexistsrrrrrrrrrrTimeoutExpired) rrrr destination concat_path temp_outputentriesrrrrexcs &&$ r_concat_audio_filesrILs 566 ;1 77??;q> *bggook.J J OOKNK 8 \\( #F {#KTD9''!K,<,<+=Qtzz|?O?O>PP[(\]K''!K,<,<+=Qtzz|?O?O>PPZ[f[m[mZn(opK"''[{[[w9k7D(GS$PST_P`bgh##))+ v):: Q QD v ##%bVa%b###%bVa%b"b"b VV$ $DV%>t%>S-=%>L    !k&8&8&:&:{?O?O?Q?Y?Y\]?] JJ{ 0{# !.D D !/ 8&--:N:Nw_g:N:him:no!.D D !/  Z.. /?8#>>?!.D D !/sJBL&L:LA L"?L78LM!L<7M<MMMc ,V^8dQhRRRRRRRRR R /#) rrryrrrrSrr=rztuple[list[str], bool]r)rs"rrrss46)6)6)),6)7K6)bf6)6)rc aaaaaaaV'g \R4hVFbp\V4P4PpVSP8gK9\RSP RV RSP RV 24h \V4o.oR^uooRVVVVVVV3Rllo\ VS4pVUUu.uFpS!V4FqDNK K ppp.p \V^R 7EF4wrSp \V4^8dKSPSP R V R \V 4P;'g SP 24p \PPV 4\PPV 48wd4V PP!R R R 7\P"!W4V P4PSP8d\RSP RV 24hV P%\'V 44EK7 V S3SFp W9gK \)V 4K #uuppi SFp Y9gK \)T 4K i;i)aePack final-encoded chunks under the hard upload limit -> ``(final_paths, combined_any)``. Groups are packed against the conservative target, then each combined artifact is checked at its real size; an over-limit group is split in half and retried. A failed combine returns the constituent files separately. A single chunk above the hard limit fails closed.z!No final-encoded TTS audio chunksz Final-encoded TTS chunk exceeds z delivery limit (z > z bytes): Fc V^8dQhRRRR/#)rgroupryrr)rs"rr1_build_audio_delivery_files..__annotate__s??I?)?rc N<\V4^8Xd \V4#S^, oSPRSP RSR R\P !4P SP 24p\V\V4S R7pV'g \V4#S PV4\V4P4PSP8:dRoV.#\V4\!^\V4^,4pS!VRV4S!WR4,#)rz .delivery03d)rTN)rlistr;r?r<r=r>rrIrrrrrrUrr\) rMscratchcombinedmidpointbase combine_index combined_anyemitrscratch_outputsrs & rrY)_build_audio_delivery_files..emits u:?;  ..1TYYKys8K1TZZ\M]M]L^_c_j_j^k!lm&uc'lM]^; x( >   ( (G,B,B BL: !q#e*/*E)8$%U9-=(>>>r)startz.part02dTrzFinal TTS deliverable exceeds z delivery limit: )r8rrrrUrTr enumeraterr;r?rrrr&r9r:rrrr)rrrrrrrrMpacked final_pathsindexsourcerDrSrVrWrXrYrZs&&fd @@@@@r_build_audio_delivery_filesrcss! <==Dz (( '(( (273C3C2DEs7#9#9":)D6KL L  D!#O"'L-?? ,K AF & ?u4;4d;dF ?K"633  v;?..DII;eE#;tF|GZGZGiGi^b^i^iFj)klK 77??6 "bggook&B B    $ $TD $ A JJv +     % %(>(> >=g>N>N=OO`al`mno o3{+,4)L(&G)('@'G)('s5H:I IIr~) z-acodecr1r2r3r4rr6onz -applicationvoipz-compression_level10ii )>__conditional_annotations__rd __future__rloggingrrr$rrrrr< dataclassesrpathlibrtypingrrrrr hermes_cli._subprocess_compatr tools.tts_command_providerr r r r getLoggerrrr$rGr/rer8r>rPGEMINI_TTS_SAMPLE_RATEGEMINI_TTS_CHANNELSGEMINI_TTS_SAMPLE_WIDTHrrSrkrurrrrrrrrrrrrrrIrc)rgs@rrss#  !33<!!   + , 8   D d 5 u t e% d T ,. e%=uU$;Uu15 4: .:c $:HMaQRD+-D8  $ D D D "2NDI!#3^TJ  "2NDI7K3K o RW0N 0$ 5 X46XFKX]aXc  *@'=T C:w,$^c$N6)in6)6)r