
    cCiZT                     |   S SK JrJrJr  S SKrS SKJr  SSKJr  SSKJ	r	J
r
  SSKJr  SSKJr  SS	KJrJr  SS
KJr  SSKJrJrJrJr  SSKJrJr  SSKJrJr  SSKJ r J!r!  SSK"J#r#  SSK$J%r%J&r&J'r'  SSK(J)r)  SSK*J+r+  SSK,J-r-   " S S\R\                  5      r/S r0S<S jr1S\Rd                  S\3S\Rd                  4S jr4 S=S\R\                  S\Rd                  S\Rd                  S \Rd                  S!\\Rd                     S"\5S#\5S$\#\%   4S% jjr6 " S& S'\R\                  5      r7\" S(5       " S) S*\R\                  5      5       r8 " S+ S,\5      r9\& " S- S.\!5      5       r: " S/ S0\R\                  5      r;\& " S1 S2\:5      5       r<\& " S3 S4\:\5      5       r= " S5 S6\\:5      r> " S7 S8\\:5      r? " S9 S:\\:5      r@/ S;QrAg)>    )CallableOptionalUnionN)nn   )ACT2FN)CacheDynamicCache)GenerationMixin)use_kernel_forward_from_hub)create_causal_mask!create_sliding_window_causal_mask)FlashAttentionKwargs)GenericForQuestionAnswering GenericForSequenceClassificationGenericForTokenClassificationGradientCheckpointingLayer)BaseModelOutputWithPastCausalLMOutputWithPast)ROPE_INIT_FUNCTIONSdynamic_rope_update)ALL_ATTENTION_FUNCTIONSPreTrainedModel)Unpack)TransformersKwargsauto_docstringcan_return_tuple)deprecate_kwarg)check_model_inputs   )MinistralConfigc                   .   ^  \ rS rSrU 4S jrS rSrU =r$ )MinistralMLP"   c                   > [         TU ]  5         Xl        UR                  U l        UR                  U l        [
        R                  " U R                  U R                  SS9U l        [
        R                  " U R                  U R                  SS9U l        [
        R                  " U R                  U R                  SS9U l	        [        UR                     U l        g NFbias)super__init__confighidden_sizeintermediate_sizer   Linear	gate_projup_proj	down_projr   
hidden_actact_fnselfr+   	__class__s     j/home/james-whalen/.local/lib/python3.13/site-packages/transformers/models/ministral/modeling_ministral.pyr*   MinistralMLP.__init__#   s    !--!'!9!94#3#3T5K5KRWXyy!1!143I3IPUV4#9#94;K;KRWXV../    c                     U R                  U R                  U R                  U5      5      U R                  U5      -  5      nU$ N)r1   r3   r/   r0   )r5   xr1   s      r7   forwardMinistralMLP.forward-   s6    NN4;;t~~a/@#ADLLQRO#ST	r9   )r3   r+   r1   r/   r,   r-   r0   )__name__
__module____qualname____firstlineno__r*   r=   __static_attributes____classcell__r6   s   @r7   r#   r#   "   s    0 r9   r#   c                     U SSU R                   S   S-  24   nU SU R                   S   S-  S24   n[        R                  " U* U4SS9$ )z*Rotates half the hidden dims of the input..N   dim)shapetorchcat)r<   x1x2s      r7   rotate_halfrP   2   sZ    	
3"!''"+"""	#B	
3q ""	#B99rc2YB''r9   c                     UR                  U5      nUR                  U5      nX-  [        U 5      U-  -   nX-  [        U5      U-  -   nXg4$ )a  Applies Rotary Position Embedding to the query and key tensors.

Args:
    q (`torch.Tensor`): The query tensor.
    k (`torch.Tensor`): The key tensor.
    cos (`torch.Tensor`): The cosine part of the rotary embedding.
    sin (`torch.Tensor`): The sine part of the rotary embedding.
    position_ids (`torch.Tensor`, *optional*):
        Deprecated and unused.
    unsqueeze_dim (`int`, *optional*, defaults to 1):
        The 'unsqueeze_dim' argument specifies the dimension along which to unsqueeze cos[position_ids] and
        sin[position_ids] so that they can be properly broadcasted to the dimensions of q and k. For example, note
        that cos[position_ids] and sin[position_ids] have the shape [batch_size, seq_len, head_dim]. Then, if q and
        k have the shape [batch_size, heads, seq_len, head_dim], then setting unsqueeze_dim=1 makes
        cos[position_ids] and sin[position_ids] broadcastable to the shapes of q and k. Similarly, if q and k have
        the shape [batch_size, seq_len, heads, head_dim], then set unsqueeze_dim=2.
Returns:
    `tuple(torch.Tensor)` comprising of the query and key tensors rotated using the Rotary Position Embedding.
)	unsqueezerP   )qkcossinposition_idsunsqueeze_dimq_embedk_embeds           r7   apply_rotary_pos_embr[   9   sS    ( --
&C
--
&Cw;q>C/0Gw;q>C/0Gr9   hidden_statesn_repreturnc                     U R                   u  p#pEUS:X  a  U $ U SS2SS2SSS2SS24   R                  X#XU5      n U R                  X#U-  XE5      $ )z
This is the equivalent of torch.repeat_interleave(x, dim=1, repeats=n_rep). The hidden states go from (batch,
num_key_value_heads, seqlen, head_dim) to (batch, num_attention_heads, seqlen, head_dim)
r    N)rK   expandreshape)r\   r]   batchnum_key_value_headsslenhead_dims         r7   	repeat_kvrf   T   s_    
 2?1D1D.Ez!!Qa"23::5W\dlmM  e(CTTTr9   modulequerykeyvalueattention_maskscalingdropoutkwargsc                 @   [        X R                  5      n[        X0R                  5      n	[        R                  " XR	                  SS5      5      U-  n
Ub"  US S 2S S 2S S 2S UR
                  S   24   nX-   n
[        R                  R                  U
S[        R                  S9R                  UR                  5      n
[        R                  R                  XU R                  S9n
[        R                  " X5      nUR	                  SS5      R                  5       nX4$ )NrH   r   rG   )rJ   dtype)ptrainingr    )rf   num_key_value_groupsrL   matmul	transposerK   r   
functionalsoftmaxfloat32torq   rm   rs   
contiguous)rg   rh   ri   rj   rk   rl   rm   rn   
key_statesvalue_statesattn_weightscausal_maskattn_outputs                r7   eager_attention_forwardr   `   s     3 ; ;<JU$?$?@L<<';';Aq'ABWLL!$Q1.D
0@0@0D.D%DE#1==((2U]](SVVW\WbWbcL==((6??([L,,|:K''1-88:K$$r9   c                   6  ^  \ rS rSrSrS\4U 4S jjr\" SSSS9  SS	\R                  S
\
\R                  \R                  4   S\\R                     S\\   S\\R                     S\\   S\
\R                  \\R                     4   4S jj5       rSrU =r$ )MinistralAttentionz   z=Multi-headed attention from 'Attention Is All You Need' paper	layer_idxc                 X  > [         TU ]  5         Xl        X l        [	        USUR
                  UR                  -  5      U l        UR                  UR                  -  U l	        U R                  S-  U l
        UR                  U l        SU l        [        R                  " UR
                  UR                  U R                  -  SS9U l        [        R                  " UR
                  UR                  U R                  -  SS9U l        [        R                  " UR
                  UR                  U R                  -  SS9U l        [        R                  " UR                  U R                  -  UR
                  SS9U l        UR&                  U   S:X  a  UR(                  U l        g S U l        g )Nre   g      TFr'   sliding_attention)r)   r*   r+   r   getattrr,   num_attention_headsre   rc   rt   rl   attention_dropout	is_causalr   r.   q_projk_projv_projo_projlayer_typessliding_windowr5   r+   r   r6   s      r7   r*   MinistralAttention.__init__}   sQ   "
F4F4F&JdJd4de$*$>$>&B\B\$\!}}d*!'!9!9ii 2 2F4N4NQUQ^Q^4^ejkii 2 2F4N4NQUQ^Q^4^ejkii 2 2F4N4NQUQ^Q^4^ejkii : :T]] JFL^L^ejk7=7I7I)7TXk7kf33qur9   past_key_valuepast_key_values4.58new_nameversionr\   position_embeddingsrk   cache_positionrn   r^   c                 J   UR                   S S n/ UQSPU R                  P7nU R                  U5      R                  U5      R	                  SS5      n	U R                  U5      R                  U5      R	                  SS5      n
U R                  U5      R                  U5      R	                  SS5      nUu  p[        XX5      u  pUb$  XUS.nUR                  XU R                  U5      u  p[        nU R                  R                  S:w  a  [        U R                  R                     nU" U U	U
UU4U R                  (       d  SOU R                  U R                   U R"                  S.UD6u  nnUR$                  " / UQSP76 R'                  5       nU R)                  U5      nUU4$ )NrG   r    rH   )rV   rU   r   eager        )rm   rl   r   )rK   re   r   viewrv   r   r   r[   updater   r   r+   _attn_implementationr   rs   r   rl   r   ra   r{   r   )r5   r\   r   rk   r   r   rn   input_shapehidden_shapequery_statesr|   r}   rU   rV   cache_kwargsattention_interfacer   r~   s                     r7   r=   MinistralAttention.forward   s    $))#2.88b8$--8{{=166|DNNqRST[[/44\BLLQPQR
{{=166|DNNqRST&#7RU#[ &#&nUL'6'='=jX\XfXfht'u$J(?;;++w6"9$++:Z:Z"[$7
%
  $}}C$2H2HLL..
%
 
%
!\ "));;;;FFHkk+.L((r9   )r   r+   re   r   r   r   rt   r   r   rl   r   r   )NN)r?   r@   rA   rB   __doc__intr*   r   rL   Tensortupler   r	   
LongTensorr   r   r=   rC   rD   rE   s   @r7   r   r   z   s    Gv# v  %0A6R ,059*)||*) #5<<#=>*) !.	*)
 "%*) !!1!12*) -.*) 
u||Xell33	4*) S*)r9   r   RMSNormc                   x   ^  \ rS rSrS
S\SS4U 4S jjjrS\R                  S\R                  4S jrS r	S	r
U =r$ )MinistralRMSNorm   epsr^   Nc                    > [         TU ]  5         [        R                  " [        R
                  " U5      5      U l        X l        g)z/
MinistralRMSNorm is equivalent to T5LayerNorm
N)r)   r*   r   	ParameterrL   onesweightvariance_epsilon)r5   r,   r   r6   s      r7   r*   MinistralRMSNorm.__init__   s/     	ll5::k#:; #r9   r\   c                    UR                   nUR                  [        R                  5      nUR	                  S5      R                  SSS9nU[        R                  " X0R                  -   5      -  nU R                  UR                  U5      -  $ )NrH   rG   T)keepdim)	rq   rz   rL   ry   powmeanrsqrtr   r   )r5   r\   input_dtypevariances       r7   r=   MinistralRMSNorm.forward   sw    #))%((7 $$Q',,R,>%H?T?T4T(UU{{]--k:::r9   c                 ^    [        U R                  R                  5       SU R                   3$ )Nz, eps=)r   r   rK   r   )r5   s    r7   
extra_reprMinistralRMSNorm.extra_repr   s*    ))*+6$2G2G1HIIr9   )r   r   )gư>)r?   r@   rA   rB   floatr*   rL   r   r=   r   rC   rD   rE   s   @r7   r   r      sB    $ $$ $ $;U\\ ;ell ;J Jr9   r   c                   H  ^  \ rS rSrS\S\4U 4S jjr\" SSSS9      SS	\R                  S
\
\R                     S\
\R                     S\
\   S\
\   S\
\R                     S\
\\R                  \R                  4      S\\   S\R                  4S jj5       rSrU =r$ )MinistralDecoderLayer   r+   r   c                 4  > [         TU ]  5         UR                  U l        [        XS9U l        [        U5      U l        [        UR                  UR                  S9U l	        [        UR                  UR                  S9U l
        UR                  U   U l        g )N)r+   r   r   )r)   r*   r,   r   	self_attnr#   mlpr   rms_norm_epsinput_layernormpost_attention_layernormr   attention_typer   s      r7   r*   MinistralDecoderLayer.__init__   s~    !--+6O'/0B0BH[H[\(89K9KQWQdQd(e%$00;r9   r   r   r   r   r\   rk   rW   	use_cacher   r   rn   r^   c                     Un	U R                  U5      nU R                  " SUUUUUUUS.UD6u  pX-   nUn	U R                  U5      nU R                  U5      nX-   nU$ )N)r\   rk   rW   r   r   r   r    )r   r   r   r   )r5   r\   rk   rW   r   r   r   r   rn   residual_s              r7   r=   MinistralDecoderLayer.forward   s     !,,];>> 	
')%+) 3	
 	
 !0 !55mD/ 0r9   )r   r,   r   r   r   r   )NNNFNN)r?   r@   rA   rB   r!   r   r*   r   rL   r   r   r   r	   boolr   r   r   r=   rC   rD   rE   s   @r7   r   r      s    	< 	<3 	< %0A6R 2637+/$)59KO|| !. u//0	
 "% D> !!1!12 &eELL%,,,F&GH +, 
 Sr9   r   c                   R    \ rS rSr% \\S'   SrSrS/rS/r	Sr
SrSrSrSr\\S.rSrg	)
MinistralPreTrainedModel   r+   modelTr   r   )r\   
attentionsr   N)r?   r@   rA   rB   r!   __annotations__base_model_prefixsupports_gradient_checkpointing_no_split_modules_skip_keys_device_placement_supports_flash_attn_supports_sdpa_supports_flex_attn_can_compile_fullgraph_supports_attention_backendr   r   _can_record_outputsrC   r   r9   r7   r   r      sQ    &*#01#4"5N!"&.(r9   r   c                      ^  \ rS rSr% \R
                  \S'   SS\4U 4S jjjr\R                  " 5       \
S 5       5       rSrU =r$ )MinistralRotaryEmbeddingi  inv_freqr+   c                   > [         TU ]  5         [        US5      (       aZ  [        UR                  [
        5      (       a;  UR                  R                  SUR                  R                  S5      5      U l        OSU l        UR                  U l	        UR                  U l
        Xl        [        U R                     U l        U R                  U R                  U5      u  o0l        U R                  SUSS9  U R                   U l        g )Nrope_scaling	rope_typetypedefaultr   F)
persistent)r)   r*   hasattr
isinstancer   dictgetr   max_position_embeddingsmax_seq_len_cachedoriginal_max_seq_lenr+   r   rope_init_fnattention_scalingregister_bufferr   original_inv_freq)r5   r+   devicer   r6   s       r7   r*   !MinistralRotaryEmbedding.__init__  s    6>**z&:M:Mt/T/T#0044[&BUBUBYBYZ`BabDN&DN"("@"@$*$B$B!/?+/+<+<T[[&+Q((ZeD!%r9   c                 b   U R                   S S S 2S 4   R                  5       R                  UR                  S   SS5      R	                  UR
                  5      nUS S 2S S S 24   R                  5       n[        UR
                  R                  [        5      (       a0  UR
                  R                  S:w  a  UR
                  R                  OSn[        R                  " USS9   UR                  5       UR                  5       -  R                  SS5      n[        R                  " Xf4SS	9nUR                  5       U R                  -  nUR                  5       U R                  -  n	S S S 5        WR	                  UR                   S
9W	R	                  UR                   S
94$ ! , (       d  f       N@= f)Nr   rG   r    mpscpuF)device_typeenabledrH   rI   )rq   )r   r   r`   rK   rz   r   r   r   strrL   autocastrv   rM   rU   r   rV   rq   )
r5   r<   rW   inv_freq_expandedposition_ids_expandedr   freqsembrU   rV   s
             r7   r=    MinistralRotaryEmbedding.forward&  sR    !MM$4-8>>@GGHZHZ[\H]_acdehhijiqiqr ,QaZ 8 > > @'1!((--'E'E!((--[`J`ahhmmfk^^UC&,,.1F1L1L1NNYYZ[]^_E))UN3C'')d444C'')d444C	 D vvAGGv$cff177f&;;; DCs   $BF  
F.)r   r+   r   r   r   r   r   r;   )r?   r@   rA   rB   rL   r   r   r!   r*   no_gradr   r=   rC   rD   rE   s   @r7   r   r     s@    ll/ / /" ]]_<  <r9   r   c                   "  ^  \ rS rSrS\4U 4S jjr\" 5       \       SS\\	R                     S\\	R                     S\\	R                     S\\   S\\	R                     S	\\   S
\\	R                     S\\   S\4S jj5       5       rSrU =r$ )MinistralModeli6  r+   c           	        > [         TU ]  U5        UR                  U l        UR                  U l        [
        R                  " UR                  UR                  U R                  5      U l        [
        R                  " [        UR                  5       Vs/ s H  n[        X5      PM     sn5      U l        [        UR                  UR                  S9U l        [#        US9U l        SU l        U R)                  5         g s  snf )Nr   r+   F)r)   r*   pad_token_idpadding_idx
vocab_sizer   	Embeddingr,   embed_tokens
ModuleListrangenum_hidden_layersr   layersr   r   normr   
rotary_embgradient_checkpointing	post_initr   s      r7   r*   MinistralModel.__init__8  s     !.. ++LL):):F<N<NPTP`P`ammGLVMeMeGfgGf)"65Gfg
 %V%7%7V=P=PQ	2&A&+# 	 hs   C?	input_idsrk   rW   r   inputs_embedsr   r   rn   r^   c                    US L US L-  (       a  [        S5      eUc  U R                  U5      nU(       a  Uc  [        U R                  S9nUcD  Ub  UR	                  5       OSn	[
        R                  " XUR                  S   -   UR                  S9nUc  UR                  S5      n[        U=n
[        5      (       d*  U R                  UUUUUS.n[        S
0 UD6[        S
0 UD6S.n
UnU R                  X5      nU R                  S U R                  R                     H  nU" U4XR"                     UUUUUS.UD6nM!     U R%                  U5      n['        UU(       a  US	9$ S S	9$ )Nz:You must specify exactly one of input_ids or inputs_embedsr  r   r    )r   )r+   input_embedsrk   r   r   rW   )full_attentionr   )rk   rW   r   r   r   r   )last_hidden_stater   r   )
ValueErrorr  r
   r+   get_seq_lengthrL   arangerK   r   rR   r   r   r   r   r  r  r  r   r  r   )r5   r  rk   rW   r   r  r   r   rn   past_seen_tokenscausal_mask_mappingmask_kwargsr\   r   decoder_layers                  r7   r=   MinistralModel.forwardH  s    -t";<YZZ  --i8M0*$++>O!CRC^==?de"\\ ]5H5H5K"KTaThThN )33A6L ?-FF ++ -"0"0#2 ,K #5"C{"C%F%U%U#
 & #oomJ![[)H4;;+H+HIM)	23O3OP) /#-$7	 	M J 		-0&+/8O
 	
>B
 	
r9   )r  r  r  r  r  r  r  )NNNNNNN)r?   r@   rA   rB   r!   r*   r   r   r   rL   r   r   r	   FloatTensorr   r   r   r   r=   rC   rD   rE   s   @r7   r  r  6  s        151537+/59$(59C
E,,-C
 !.C
 u//0	C

 "%C
   1 12C
 D>C
 !!1!12C
 +,C
 
!C
  C
r9   r  c                   r  ^  \ rS rSrS/rSS0rSS/S/40rU 4S jr\\	         SS\
\R                     S	\
\R                     S
\
\R                     S\
\   S\
\R                     S\
\R                     S\
\   S\
\R                     S\\\R                  4   S\\   S\4S jj5       5       rSrU =r$ )MinistralForCausalLMi  zlm_head.weightlm_headcolwise_repr\   logitsc                    > [         TU ]  U5        [        U5      U l        UR                  U l        [
        R                  " UR                  UR                  SS9U l        U R                  5         g r&   )
r)   r*   r  r   r  r   r.   r,   r-  r  r4   s     r7   r*   MinistralForCausalLM.__init__  sU     #F+
 ++yy!3!3V5F5FUS 	r9   r  rk   rW   r   r  labelsr   r   logits_to_keeprn   r^   c
                 ~   U R                   " SUUUUUUUS.U
D6nUR                  n[        U	[        5      (       a  [	        U	* S5      OU	nU R                  USS2USS24   5      nSnUb)  U R                  " SXU R                  R                  S.U
D6n[        UUUR                  UR                  UR                  S9$ )a  
Example:

```python
>>> from transformers import AutoTokenizer, MinistralForCausalLM

>>> model = MinistralForCausalLM.from_pretrained("meta-ministral/Ministral-2-7b-hf")
>>> tokenizer = AutoTokenizer.from_pretrained("meta-ministral/Ministral-2-7b-hf")

>>> prompt = "Hey, are you conscious? Can you talk to me?"
>>> inputs = tokenizer(prompt, return_tensors="pt")

>>> # Generate
>>> generate_ids = model.generate(inputs.input_ids, max_length=30)
>>> tokenizer.batch_decode(generate_ids, skip_special_tokens=True, clean_up_tokenization_spaces=False)[0]
"Hey, are you conscious? Can you talk to me?\nI'm not conscious, but I can talk to you."
```)r  rk   rW   r   r  r   r   N)r/  r2  r  )lossr/  r   r\   r   r   )r   r!  r   r   slicer-  loss_functionr+   r  r   r   r\   r   )r5   r  rk   rW   r   r  r2  r   r   r3  rn   outputsr\   slice_indicesr/  r5  s                   r7   r=   MinistralForCausalLM.forward  s    @ ,0:: 	,
)%+')	,
 	,
  118B>SV8W8W~ot4]kmA}a,?@A%%pVt{{OeOepiopD%#33!//))
 	
r9   )r-  r   r  )	NNNNNNNNr   )r?   r@   rA   rB   _tied_weights_keys_tp_plan_pp_planr*   r   r   r   rL   r   r   r	   r*  r   r   r   r   r   r   r=   rC   rD   rE   s   @r7   r,  r,    s0   *+=)H_-z:;H  151537+/59-1$(59348
E,,-8
 !.8
 u//0	8

 "%8
   1 128
 ))*8
 D>8
 !!1!128
 c5<</08
 +,8
 
 8
  8
r9   r,  c                       \ rS rSrSrg)"MinistralForSequenceClassificationi  r   Nr?   r@   rA   rB   rC   r   r9   r7   r?  r?        r9   r?  c                       \ rS rSrSrg)MinistralForTokenClassificationi  r   Nr@  r   r9   r7   rC  rC    rA  r9   rC  c                       \ rS rSrSrSrg)MinistralForQuestionAnsweringi  transformerr   N)r?   r@   rA   rB   r   rC   r   r9   r7   rE  rE    s    %r9   rE  )r   r  r,  r?  rC  rE  )Nr    )r   )Btypingr   r   r   rL   r   activationsr   cache_utilsr	   r
   
generationr   integrationsr   masking_utilsr   r   modeling_flash_attention_utilsr   modeling_layersr   r   r   r   modeling_outputsr   r   modeling_rope_utilsr   r   modeling_utilsr   r   processing_utilsr   utilsr   r   r   utils.deprecationr   utils.genericr   configuration_ministralr!   Moduler#   rP   r[   r   r   rf   r   r   r   r   r   r   r   r  r,  r?  rC  rE  __all__r   r9   r7   <module>rY     s   - ,   ! . ) 7 R B  P K F & I I 0 / 4299  (6	UU\\ 	U# 	U%,, 	U& %II%<<% 
% <<	%
 U\\*% % % '(%4>) >)B Y'Jryy J (J(,6 ,^   $!<ryy !<H V
- V
 V
r H
3_ H
 H
V	)IKc 		&CE] 	&$?AY &r9   