uPj1\. dZddlZddlZddlmZmZmZddlmZddl m Z m Z ddl Z ddl Z ddlmZmZddlmZddlmZmZdd lmZdd lmZmZmZmZmZmZm Z dd l!m"Z"dd l#m$Z$e$ d)d e%dzde%dzdedzde&e dzde%dzde'e%e fdzde(dzde(dzde(dzdedzde&e%dzde'e%e fdzde%dzde%dzde'e%e fdzde'e%e fdzde)e jTzdzde%dzdeeezf&d Z+e$ d)d e%dzde%dzdedzde&e dzde%dzde'e%e fdzde(dzde(dzde(dzdedzde&e%dzde'e%e fdzde%dzde%dzde'e%e fdzde'e%e fdzde)e jTzdzde%dzdeeezee e eeezfzf&d!Z,e$ d*d"e%de'e%e fdzde)e jTzdzde%dzdef d#Z-e$ d*d"e%de'e%e fdzde)e jTzdzde%dzdeee e efzf d$Z.e$ d*d"e%de'e%e fdzde)e jTzdzde%dzdef d%Z/e$ d*d"e%de'e%e fdzde)e jTzdzde%dzdeee e efzf d&Z0e$ d*d"e%de'e%e fdzde)e jTzdzde%dzdef d'Z1e$ d*d"e%de'e%e fdzde)e jTzdzde%dzdeee e efzf d(Z2y)+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) AsyncIterator CoroutineIterator)partial)AnyFinal)2maybe_schedule_background_interaction_cost_polling1maybe_settle_background_interaction_before_delete)interactions_http_handler)InteractionsAPIRequestUtils$get_provider_interactions_api_config)Logging)CancelInteractionResultDeleteInteractionResultInteractionEnvironmentInteractionInputInteractionsAPIResponse InteractionsAPIStreamingResponseInteractionTool)GenericLiteLLMParams)clientmodelagentinputtoolssystem_instructiongeneration_configstreamstore background environmentresponse_modalitiesresponse_formatresponse_mime_typeprevious_interaction_id extra_headers extra_bodytimeoutcustom_llm_providerreturncKt} 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|d||}tj}t |j|}|jd|d{}tj|r |d{}n|}t||||S767#t$r}tj|||||d}~wwxYww)u 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 environment: Agent execution environment — ``"remote"``, an existing env id string, or a config object such as ``{"type": "remote", "sources": [...]}`` / ``{"type": "remote", "network": {...}}`` 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(r))response create_kwargsr)rr)original_exceptioncompletion_kwargs extra_kwargs)localsasyncioget_event_looplitellmget_llm_providergetrcreate contextvars copy_contextrunrun_in_executor iscoroutiner Exceptionexception_type)rrrrrrrrr r!r"r#r$r%r&r'r(r)kwargs local_varsloop_funcctxfunc_with_context init_responser/es ^/home/oem/CyberBrain26-unified/.venv/lib/python3.12/site-packages/litellm/interactions/main.pyacreaterMFsDJ7 ,,.(,$%  &5+2+C+C%Z`ZdZdeoquZv+w (A"Aq ("*         2  0   " $ !4 ,  2 %< (! ""# $% &!4) .!--/#*377D#9%)%9%9$@Q%RR   } -**H$H: 3  S+  $$ 3 (    sM ECD!D"DDDEDD E%D??EEc t} |jd}|jdd}|jdddu}tdi|}|r||k(rd}|r |s|xsd}n;|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)u 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 environment: Agent execution environment — ``"remote"``, an existing env id string, or a config object such as ``{"type": "remote", "sources": [...]}`` / ``{"type": "remote", "network": {...}}`` 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,FTr.)rr)r-api_key)providerrlitellm_responsesr)#LiteLLMResponsesInteractionsHandler)rroptional_paramsr) _is_asyncrrCrrVlitellm_paramsr)) rrrinteractions_api_configrVr)rY logging_objr&r'r(rWrr1)r5r:poprr8r9r-rQr updater .get_requested_interactions_api_optional_params=litellm.interactions.litellm_responses_transformation.handlerrTinteractions_api_handlerupdate_from_kwargsdictr create_interactionrArB)rrrrrrrrr r!r"r#r$r%r&r'r(r)rCrDrOrPrWrYrFrZrVrThandlerr/rKs rLr;r;sLJT 8> CX8Y-3ZZ8I4-P!::&;UCtK 4 >v > Ue^E "5"A  /6/G/G$7'00&.. 0 ,E&1#6"A )M(*  &!!r?r@rAr8rB rfr&r(r)rCrDrErGrHrIrJr/rKs rLagetrkgsJ ,,.%)!"  )' 3 ?x    !--/#*377D#9%)%9%9$@Q%RR   } -**H%H S+  $$ 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.rOrPNrhFTrR$Interactions API not supported for: rfrXrfrZr)rYr[r&r(rWr1r\) r5r:r]rr ValueErrorrbr get_interactionrAr8rB rfr&r(r)rCrDrOrPrWrYrZrKs rLr:r:sJ-9' 8> CX8Y-3ZZ8I4-P!::&8%@DH 4 >v >)M(*  # *CDWCXYZ Z..-~>-? 3 / )88)$; 3)+'    $$ 3 (    BB'' C0C  CcKt} tj}d|d<t|d{t t f||||xsdd|}t j}t |j|} |jd| d{} tj| r | d{} | S| } | S77+7#t$r#} tjd|xsd| ||d} ~ wwxYww)z'Async: Delete an interaction by its ID.Tadelete_interaction)rfNr.rir1)r5r6r7r rdeleter<r=r>r?r@rAr8rBrjs rLadeleterxsJ  ,,.(,$%?~^^^  )' 3 ?x    !--/#*377D#9%)%9%9$@Q%RR   } -**H%H) _ S+  $$ 3 ?x (    si C2(CB=ACB?C2C3C8C29C<C2=C?CC C/ C**C//C2c 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.rOrPNrvFTrnrorfrXrpr1r\) r5r:r]rr rqrbr delete_interactionrAr8rBrss rLrwrwJ-9' 8> CX8Y-3ZZ8I4-P!::&;UCtK 4 >v >)M(*  # *CDWCXYZ Z..-~>-? 3 / );;)$; 3)+'    $$ 3 (    rtcKt} 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.riNr1) r5r6r7rcancelr<r=r>r?r@rAr8rBrjs rLacancelr5sJ ,,.(,$%  )' 3 ?x    !--/#*377D#9%)%9%9$@Q%RR   } -**H%H S+  $$ 3 ?x (    rlc 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.rOrPNr}FTrnrorfrXrpr1r\) r5r:r]rr rqrbr cancel_interactionrAr8rBrss rLr~r~`r{rt)NNNNNNNNNNNNNNNNNN)NNN)3__doc__r6r<collections.abcrrr functoolsrtypingrrhttpxr8,litellm.interactions.background_cost_pollingr r !litellm.interactions.http_handlerr litellm.interactions.utilsr r *litellm.litellm_core_utils.litellm_loggingrLiteLLMLoggingObjlitellm.types.interactionsrrrrrrrlitellm.types.routerr litellm.utilsrstrlistrcboolfloatTimeoutrMr;rkr:rxrwrr~r\rLrsB>> HT6 %)*.%)/3"15,0-1%)*.+/(,,0&*?y :y  :y d " y   4 'y d y CH~,y  4Ky  $;y "t #y &($.'y *cT)+y ,#s(^d*-y .d /y 2!4Z3y 6S>D(7y 8S#X%9y :U]] "T );y >t?y B}-MNNCy y x%)*.%)/3"15,0-1%)*.+/(,,0&*?[ :[  :[ d " [   4 '[ d [ CH~,[  4K[  $;[ "t #[ &($.'[ *cT)+[ ,#s(^d*-[ .d /[ 2!4Z3[ 6S>D(7[ 8S#X%9[ :U]] "T );[ >t?[ D/01S1MBb4cccdeE[ [ F,0,0&* ' ' S>D(' U]] "T )' t '  ' ' T,0,0&* 2 2 S>D(2 U]] "T )2 t 2 yc3J)JKK 2 2 t,0,0&* ) ) S>D() U]] "T )) t )  ) ) X,0,0&* 2 2 S>D(2 U]] "T )2 t 2 yc3J)JKK 2 2 t,0,0&* ' ' S>D(' U]] "T )' t '  ' ' T,0,0&* 2 2 S>D(2 U]] "T )2 t 2 yc3J)JKK 2 2 r