AHjV/dZddlZddlZddlmZddlmZmZmZm Z m Z m Z m Z m Z ddlZddlZddlmZddlmZmZddlmZddlmZmZmZmZmZmZdd lm Z dd l!m"Z"e" d&d e e#d e e#d e ede e ede e#de e e#efde e$de e$de e$de e e#de e e#efde e#de e#de e e#efde e e#efde e e%ejLfde e#de eeeff$dZ'e" d&d e e#d e e#d e ede e ede e#de e e#efde e$de e$de e$de e e#de e e#efde e#de e#de e e#efde e e#efde e e%ejLfde e#de ee eeeee eeeffff$dZ(e" d'de#de e e#efde e e%ejLfde e#def d Z)e" d'de#de e e#efde e e%ejLfde e#de eeeeefff d!Z*e" d'de#de e e#efde e e%ejLfde e#def d"Z+e" d'de#de e e#efde e e%ejLfde e#de eeeeefff d#Z,e" d'de#de e e#efde e e%ejLfde e#def d$Z-e" d'de#de e e#efde e e%ejLfde e#de eeeeefff d%Z.y)(a LiteLLM Interactions API - Main Module Per OpenAPI spec (https://ai.google.dev/static/api/interactions.openapi.json): - Create interaction: POST /{api_version}/interactions - Get interaction: GET /{api_version}/interactions/{interaction_id} - Delete interaction: DELETE /{api_version}/interactions/{interaction_id} Usage: import litellm # Create an interaction with a model response = litellm.interactions.create( model="gemini-2.5-flash", input="Hello, how are you?" ) # Create an interaction with an agent response = litellm.interactions.create( agent="deep-research-pro-preview-12-2025", input="Research the current state of cancer research" ) # Async version response = await litellm.interactions.acreate(...) # Get an interaction response = litellm.interactions.get(interaction_id="...") # Delete an interaction result = litellm.interactions.delete(interaction_id="...") N)partial)Any AsyncIterator CoroutineDictIteratorListOptionalUnion)interactions_http_handler)InteractionsAPIRequestUtils$get_provider_interactions_api_config)Logging)CancelInteractionResultDeleteInteractionResultInteractionInputInteractionsAPIResponse InteractionsAPIStreamingResponseInteractionTool)GenericLiteLLMParams)clientmodelagentinputtoolssystem_instructiongeneration_configstreamstore backgroundresponse_modalitiesresponse_formatresponse_mime_typeprevious_interaction_id extra_headers extra_bodytimeoutcustom_llm_providerreturncrKt} tj}d|d<|/|r-tj||j dd\}}}}n|d}t tfid|d|d |d |d |d |d |d|d|d| d| d| d| d| d|d|d||}tj}t |j|}|jd|d{}tj|r |d{}|S|}|S7)7 #t$r}tj|||||d}~wwxYww)a Async: Create a new interaction using Google's Interactions API. Per OpenAPI spec, provide either `model` or `agent`. Args: model: The model to use (e.g., "gemini-2.5-flash") agent: The agent to use (e.g., "deep-research-pro-preview-12-2025") input: The input content (string, content object, or list) tools: Tools available for the model system_instruction: System instruction for the interaction generation_config: Generation configuration stream: Whether to stream the response store: Whether to store the response for later retrieval background: Whether to run in background response_modalities: Requested response modalities (TEXT, IMAGE, AUDIO) response_format: JSON schema for response format response_mime_type: MIME type of the response previous_interaction_id: ID of previous interaction for continuation extra_headers: Additional headers extra_body: Additional body parameters timeout: Request timeout custom_llm_provider: Override the LLM provider Returns: InteractionsAPIResponse or async iterator for streaming Tacreate_interactionNapi_base)rr,geminirrrrrrrrr r!r"r#r$r%r&r'r(rr(original_exceptioncompletion_kwargs extra_kwargs)localsasyncioget_event_looplitellmget_llm_providergetrcreate contextvars copy_contextrunrun_in_executor iscoroutine Exceptionexception_type)rrrrrrrrr r!r"r#r$r%r&r'r(kwargs local_varsloop_funcctxfunc_with_context init_responseresponsees Q/root/tools/cai/cai_env/lib/python3.12/site-packages/litellm/interactions/main.pyacreaterK@sxJ2 %%'(,$%  &5+2+C+CfjjT&B, (A"Aq! ("*         2  0   " !4 ,  2 %< ( "! "# $!4' ,&&(#CGGT2"2249JKK   } -**H%HL+  $$ 3 (    sY D7CD DD =D >D D7D D7D D D4D//D44D7c t} |jd}|jdd}|jdddu}tdi|}|r3t j |||j |j\}}}}n|xsd}t|| }|j|tj|}|d k(s|*d d l m }|}|jd|xsd |||||d|S|j||t!|d|i|t#j$||||||||| |||| }|S#t&$r}t j(|||||d}~wwxYw)a Sync: Create a new interaction using Google's Interactions API. Per OpenAPI spec, provide either `model` or `agent`. Args: model: The model to use (e.g., "gemini-2.5-flash") agent: The agent to use (e.g., "deep-research-pro-preview-12-2025") input: The input content (string, content object, or list) tools: Tools available for the model system_instruction: System instruction for the interaction generation_config: Generation configuration stream: Whether to stream the response store: Whether to store the response for later retrieval background: Whether to run in background response_modalities: Requested response modalities (TEXT, IMAGE, AUDIO) response_format: JSON schema for response format response_mime_type: MIME type of the response previous_interaction_id: ID of previous interaction for continuation extra_headers: Additional headers extra_body: Additional body parameters timeout: Request timeout custom_llm_provider: Override the LLM provider Returns: InteractionsAPIResponse or iterator for streaming litellm_logging_objlitellm_call_idNr+FT)rr(r,api_keyr-)providerrlitellm_responsesr)#LiteLLMResponsesInteractionsHandler)rroptional_paramsr( _is_asyncrr@rrTlitellm_paramsr() rrrinteractions_api_configrTr(rW logging_objr%r&r'rUrr.)r2r7poprr5r6r,rOrupdater .get_requested_interactions_api_optional_params=litellm.interactions.litellm_responses_transformation.handlerrRinteractions_api_handlerupdate_from_kwargsdictr create_interactionr>r?)rrrrrrrrr r!r"r#r$r%r&r'r(r@rArMrNrUrWrCrXrTrRhandlerrHrIs rJr8r8sHJT 17r5r? rdr%r'r(r@rArBrDrErFrGrHrIs rJagetriTsJ %%'%)!"  )' 3 ?x    &&(#CGGT2"2249JKK   } -**H%HL+  $$ 3 ?x (    Y CA1B-?B)B-B+B-$C%B-(C)B-+B-- C6CCCc t}|xsd} |jd}|jdd}|jdddu}tdi|} t |} | t d ||j |dd |id|i| tj|| || |||| S#t$r} tjd|| || d} ~ wwxYw)z#Sync: Get an interaction by its ID.r-rMrNNrfFTrP$Interactions API not supported for: rdrVrdrXr(rWrYr%r'rUr.rZ) r2r7r[rr ValueErrorr`r get_interactionr>r5r? rdr%r'r(r@rArMrNrUrWrXrIs rJr7r7sJ-9) 17-? 3 / )88)$; 3)+'    $$ 3 (    BB'' C0C  CcKt} tj}d|d<ttf||||xsdd|}t j }t|j|} |jd| d{} tj| r | d{} | S| } | S7)7 #t$r#} tjd|xsd| ||d} ~ wwxYww)z'Async: Delete an interaction by its ID.Tadelete_interactionr-rgNr.) r2r3r4rdeleter9r:r;r<r=r>r5r?rhs rJadeletervJ %%'(,$%  )' 3 ?x    &&(#CGGT2"2249JKK   } -**H%HL+  $$ 3 ?x (    rjc t}|xsd} |jd}|jdd}|jdddu}tdi|} t |} | t d ||j |dd |id|i| tj|| || |||| S#t$r} tjd|| || d} ~ wwxYw)z&Sync: Delete an interaction by its ID.r-rMrNNrtFTrlrmrdrVrnr.rZ) r2r7r[rrror`r delete_interactionr>r5r?rqs rJruruJ-9) 17-? 3 / );;)$; 3)+'    $$ 3 (    rrcKt} tj}d|d<ttf||||xsdd|}t j }t|j|} |jd| d{} tj| r | d{} | S| } | S7)7 #t$r#} tjd|xsd| ||d} ~ wwxYww)z'Async: Cancel an interaction by its ID.Tacancel_interactionr-rgNr.) r2r3r4rcancelr9r:r;r<r=r>r5r?rhs rJacancelr~$rwrjc t}|xsd} |jd}|jdd}|jdddu}tdi|} t |} | t d ||j |dd |id|i| tj|| || |||| S#t$r} tjd|| || d} ~ wwxYw)z&Sync: Cancel an interaction by its ID.r-rMrNNr|FTrlrmrdrVrnr.rZ) r2r7r[rrror`r cancel_interactionr>r5r?rqs rJr}r}Orzrr)NNNNNNNNNNNNNNNNN)NNN)/__doc__r3r9 functoolsrtypingrrrrrr r r httpxr5!litellm.interactions.http_handlerr litellm.interactions.utilsr r*litellm.litellm_core_utils.litellm_loggingrLiteLLMLoggingObjlitellm.types.interactionsrrrrrrlitellm.types.routerr litellm.utilsrstrboolfloatTimeoutrKr8rir7rvrur~r}rZrJrsBWWW GT6  (,-1(,26! !%/304(,-1.2+/59)-;n C=n  C=n $ % n  D) *n ! n  S#X/n  TNn  D>n "#n &"$s),'n (d38n-)n *! +n .&c]/n 2DcN+3n 4c3h(5n 6eE5==01 27n :"#;n > "M2R$S ST?n n b (,-1(,26! !%/304(,-1.2+/59)-;Y C=Y  C=Y $ % Y  D) *Y ! Y  S#X/Y  TNY  D>Y "#Y &"$s),'Y (d38n-)Y *! +Y .&c]/Y 2DcN+3Y 4c3h(5Y 6eE5==01 27Y :"#;Y >  -.    %}5U'VVW Y?Y Y B/359)- ' ' DcN+' eE5==01 2' "# '  ' ' T/359)- 4 4 DcN+4 eE5==01 24 "# 4  "Ic38O.O$P PQ 4 4 x/359)- ' ' DcN+' eE5==01 2' "# '  ' ' T/359)- 4 4 DcN+4 eE5==01 24 "# 4  "Ic38O.O$P PQ 4 4 x/359)- ' ' DcN+' eE5==01 2' "# '  ' ' T/359)- 4 4 DcN+4 eE5==01 24 "# 4  "Ic38O.O$P PQ 4 4 r