+
    i                      a  0 t $ R t^ RIHt ^ RIt^ RIHt ^ RIHt	 ^ RI
Ht ^ RI
Ht ^ RI
Ht ^ RI
Ht ^ R	I
Ht ^ R
I
Ht ^ RIt^ RIHt R]	n        ]P*                  t]P,                  t]P.                  t]P0                  tRsR]R&   R R ltR R lt ! R R]P:                  4      t ! R R]4      t]P@                   ! R R]PB                  4      4       t!]PD                  ! 4       PG                  ]!4       R# )z,Colab Magics class.

Installs %%llm magics.
)annotationsN)credentials)client)gspread_client)ipython_env)ipython_env_impl)magics_engine)post_process_utils)sheets_utils)magiczgenai-py-magiczipython_env.IPythonEnv | None_ipython_envc                   V ^8  d   QhRR/# )   returnzipython_env.IPythonEnv )formats   "v/Users/igloo/.openclaw/workspace/scratch/fb_ad_env/lib/python3.14/site-packages/google/generativeai/notebook/magics.py__annotate__r   4   s      0     c                 H    \         f   \        P                  ! 4       s \         # )z;Lazily constructs and returns a global IPythonEnv instance.)r   r   IPythonEnvImplr   r   r   _get_ipython_envr   4   s     '668r   c                    V ^8  d   QhRRRR/# )r   credszcredentials.Credentialsr   Noner   )r   s   "r   r   r   <   s     B B, B Br   c                F    \         P                  ! V \        4       R7       R# )zSets up credentials.

This is used for interacting Google APIs, such as Google Sheets.

Args:
  creds: The credentials that will be used (e.g. to read from Google Sheets.)
)r   envN)r   	authorizer   )r   s   &r   r   r   <   s     5.>.@Ar   c                  D    ] tR t^GtRt]P                  R R l4       tRtR# )AbstractMagicsz"Defines interface to Magics class.c                    V ^8  d   QhRRRR/# r   	cell_linez
str | None	cell_bodyr   )r   s   "r   r   AbstractMagics.__annotate__K   s     $ $Z $J $r   c                    \        4       h)zPerform various LLM-related operations.

Args:
  cell_line: String to pass to the MagicsEngine.
  cell_body: Contents of the cell body.
)NotImplementedErrorselfr"   r#   s   &&&r   llmAbstractMagics.llmJ   s     "##r   r   N)	__name__
__module____qualname____firstlineno____doc__abcabstractmethodr)   __static_attributes__r   r   r   r   r   G   s    ,$ $r   r   c                  ,    ] tR t^UtRtR tR R ltRtR# )
MagicsImplzActual class implementing the magics functionality.

We use a separate class to ensure a single, global instance
of the magics class.
c                	N    \         P                  ! \        4       R 7      V n        R# ))r   N)r   MagicsEnginer   _engine)r(   s   &r   __init__MagicsImpl.__init__\   s    $116F6HIr   c                    V ^8  d   QhRRRR/# r!   r   )r   s   "r   r   MagicsImpl.__annotate___   s     ? ?Z ?J ?r   c                h    T;'       g    RpT;'       g    RpV P                   P                  W4      # )Perform various LLM-related operations.

Args:
  cell_line: String to pass to the MagicsEngine.
  cell_body: Contents of the cell body.

Returns:
  Results from running MagicsEngine.
 )r7   execute_cellr'   s   &&&r   r)   MagicsImpl.llm_   s/     OO	OO	||((>>r   )r7   N)r+   r,   r-   r.   r/   r8   r)   r2   r   r   r   r4   r4   U   s    J? ?r   r4   c                      ] tR t^ntRtRt]R R l4       t]P                  R R l4       t
]P                  R R l4       t]P                  R	 R
 l4       tRtR# )MagicszpClass to register the magic with Colab.

Objects of this class delegate all calls to a single,
global instance.
Nc                   V ^8  d   QhRR/# )r   r   r   r   )r   s   "r   r   Magics.__annotate__z   s      ^ r   c                T    V P                   f   \        4       V n         V P                   # )z.Retrieve global instance of the Magics object.)	_instancer4   )clss   &r   get_instanceMagics.get_instancey   s!     == &LCM}}r   c                    V ^8  d   QhRRRR/# r!   r   )r   s   "r   r   rD      s     
S 
SZ 
SJ 
Sr   c                J    \         P                  4       P                  WR7      # )r=   )r"   r#   )rB   rH   r)   r'   s   &&&r   r)   
Magics.llm   s!     ""$((9(RRr   c                    V ^8  d   QhRRRR/# r!   r   )r   s   "r   r   rD      s     . .j .Z .r   c                	$    V P                  W4      # Nr)   r'   s   &&&r   palmMagics.palm       xx	--r   c                    V ^8  d   QhRRRR/# r!   r   )r   s   "r   r   rD      s     . .
 .z .r   c                	$    V P                  W4      # rO   rP   r'   s   &&&r   geminiMagics.gemini   rS   r   r   )r+   r,   r-   r.   r/   rF   classmethodrH   r   line_cell_magicr)   rQ   rV   r2   r   r   r   rB   rB   n   sp     I  
S 
S . . . .r   rB   )$__conditional_annotations__r/   
__future__r   r0   google.authr   google.generativeair   genaigoogle.generativeai.notebookr   r   r   r   r	   r
   IPythonIPython.corer   
USER_AGENTSheetsInputsSheetsOutputspost_process_add_fnpost_process_replace_fnr   __annotations__r   r   ABCr   r4   magics_classrB   get_ipythonregister_magics)rZ   s   @r   <module>rl      s    # 
 # / 7 4 9 6 ; 5   $ ((** )<< ,DD  /3+ 2B$SWW $? ?2 $.U\\ $. $.N     % %f -r   