љi SSKrSSKrSSKJr SSKJrJrJrJrJ r SSK J r J r SSK JrJr SSKJr SS KJr \R("\5r"S S \ 5r"S S \ 5r"SS\ 5r"SS5rSSS.S\S\S\S\4Sjjrg)N)Optional) APIRouterDependsFastAPI HTTPExceptionstatus) BaseModelField) STSRequest STSResponse)Adapter)create_api_key_dependencyc4\rSrSr%Sr\"SSSS9r\\S'Sr g ) APIResponse z APIResponse is a standard response model for successful API operations. Used to return a simple success message or status information. .zMessage from APIz"Success message from API operationexample descriptionmessageN) __name__ __module__ __qualname____firstlineno____doc__r rstr__annotations____static_attributes__rP/home/james-whalen/.local/lib/python3.13/site-packages/aiavatar/admin/control.pyrr s#  "8GSr!rcT\rSrSr%Sr\"SSSS9r\\S'\"SS S S 9r \ \\S 'S r g) SpeechRequestz SpeechRequest contains text for avatar speech synthesis and performance. Supports control tags for face expressions and animations embedded in text. .z![face:joy]Hi, let's talk with me!z@Text to synthesize with optional face and animation control tagsrtextN local_sessionRSession Id to route the response to a specific client (e.g., WebSocket connection)defaultrr session_idr) rrrrrr r&rrr+rr rr!r"r$r$sC  3VD# !&h!J r!r$ct\rSrSr%Sr\"SSSS9r\\S'\"SS S S 9r \ \\S '\"SS SS 9r \ \\S'Sr g) ChatRequest,z ChatRequest contains a text message for conversation processing. Used to send messages to the AIAvatar's conversation processing pipeline. .uこんにちは！z2Text message to send to the conversation processorrr&Nr'r(r)r+user_001zCUser Id for conversation context management (e.g., per-user memory)user_idr) rrrrrr r&rrr+rr0r rr!r"r-r-,sc  $HD# !&h!J  #YGXc]r!r-cJ\rSrSrS S\S\4SjjrS\S\4SjrS\4S jr S r g) ControlAPICNadapterdefault_session_idcXlX lgNr4r5)selfr4r5s r"__init__ControlAPI.__init__Ds  "4r!r&returncZUn[R"SSU5nUR5nU$)Nz\[(\w+):([^\]]+)\])resubstrip)r9r& clean_texts r"remove_control_tagsControlAPI.remove_control_tagsHs. VV12zB %%' r!c ^[5nURSS/SSSSS0SS0SS 0S .S 9S [S [4U4Sjj5nURSS/SSSSS0SS0SS0SS 0S.S 9S [S [4U4Sjj5nU$)Nz/avatar/performzAvatar Controlz#Perform avatar speech with controlszUSynthesize speech and perform avatar controls (face/animation) based on embedded tagsz"Performance completed successfullyr)Avatar performance completed successfullyzInvalid text or control tagszInternal server error))tagssummaryrresponse_description responsesrequestr<c ># UR=(d TRnTRRRR TR UR5S9IShvN nTRRUS5IShvN TR UR5nTRR[SUURUUSS0S95IShvN TRR[SUURU0S 95IShvN [S S 9$NNNIN![a2n[RS 5 [[ R"S S9eSnAff=f7f)a  Perform comprehensive avatar actions including speech, face, and animation. This endpoint processes text with embedded control tags: - Synthesizes speech from the provided text (excluding control tags) - Parses control tags for face expressions and animations - Executes synchronized avatar performance Control tag format: - Face: [face:expression_name] (e.g., [face:joy]) - Animation: [animation:animation_name] (e.g., [animation:wave_hands]) Example: "[face:joy]Hello there! [animation:wave_hands]Nice to meet you!" )r&N_chunkis_first_chunkT)typer+r& voice_text audio_datametadatafinal)rSr+r&rTrVrFrzError performing avatar actionsz5Internal server error while performing avatar actions status_codedetail)r+r5r4ststts synthesizerCr& stop_responsehandle_responser r Exceptionlogger exceptionrrHTTP_500_INTERNAL_SERVER_ERROR)rNr+voicerTexr9s r"post_avatar_perform2ControlAPI.get_router..post_avatar_performQsW6 $//J43J3J "ll..22==4C[C[\c\h\hCi=jjll00SAAA!55gllC ll22; ) )$.5 4ll22; ) ) 4#+VWW+kA   #BD# & E ER srE4A(D5-D-.#D5D/AD5'D1(7D5D3 D5,E4-D5/D51D53D55 E1?-E,,E11E4z /conversationz&Send message to conversation processorzDSend a text message to the AIAvatar conversation processing pipelinez=Success message indicating conversation processing completionMessage processed successfullyzAIAvatar is not listeningzInvalid message format)rGirHrIc ># UR=(d TRnU(a0TRRRR US5OSnTRRR [XRX RS95ShvN nURS:XaBU(a;TRRRRUSUR5 TRRU5IShvN MN{N [SS9$![a e[ a5n["R%SU35 [[&R(SS 9eSnAff=f7f) a  Send a text message to the conversation processing pipeline. This endpoint processes a text message through the complete STS pipeline: - Validates that the avatar is currently listening - Invokes the Speech-to-Speech pipeline with the text input - Processes LLM response and generates appropriate avatar actions - Handles TTS synthesis and avatar control synchronization The message will be processed as if it were spoken input, triggering the full conversation flow including context management and response generation. context_idN)r+r0rkr&startrirXz'Error processing conversation message: z;Internal server error while processing conversation messagerY)r+r5r4r\vadget_session_datainvoker r0r&rSset_session_datarkr`rrrarberrorrrd)rNr+rkresprfr9s r"processor_chat-ControlAPI.get_router..processor_chatsC4 $//J43J3J `jT\\--11BB:|\pt "&,,"2"2"9"9*PZdsdsAKR^R^;_#`=$yyG+% LL,,00AA*l\`\k\kl,,66t<<< == #` #+KLL    FrdKL# & E EX s`E8BD,D""D#D"&A1D,D D,D" D," D,+E8,E50E00E55E8)rpostr$rr-)r9routerrgrss` r" get_routerControlAPI.get_routerNs  "#9o!E#%PQ#%CD#%<=  - }- -  - ^  "#<^!`#%EF#%@A#%=>#%<=    + +   B r!r8r7) rrrrrrr:rCrrwr rr!r"r2r2Cs655S5 lIlr!r2)r5api_keyappr4r5rycU(a[[U55/O/nUR[XS9R 5US9 g)Nr8) dependencies)rrinclude_routerr2rw)rzr4r5rydepss r"setup_control_apirsC=DG-g6 7 8D7JUUWr!)loggingr?typingrfastapirrrrrpydanticr r sts.modelsr r adapter.baserauthr getLoggerrrbrr$r-r2rrrr!r"rs FF%0"+   8 $ ) I$).ww|#       r!