Ë
    òÏjå5  ã                  ó  — d Z ddlmZ ddlmZmZmZ ddlmZm	Z	m
Z
 dZ eh d£«      Zdd„Zdd„Zdd	„Zdd d„Ze	d   Zd!d„Z	 	 	 	 d"d„Zd#d„Z G d„ de
«      Z G d„ d«      Z G d„ d«      Z G d„ d«      Z G d„ d«      Z G d„ d«      Zy
)$u;  Per-channel event â†’ items state machines.

Used both by the projection iterators (`_ValuesProjection`,
`_MessagesProjection`, `_ToolCallsProjection`, `_SubgraphsProjection`) on
`AsyncThreadStream` / `SyncThreadStream`, and by `interleave_projections`,
which drives multiple decoders from one shared subscription.
é    )Úannotations)ÚCallableÚIterableÚMapping)ÚAnyÚLiteralÚProtocol)ÚvaluesÚmessagesÚ
tool_callsÚ	subgraphsÚupdatesÚcheckpointsÚtasks>   ÚinputÚtoolsÚ	lifecyclec           
     ó‚   — | D ]:  }|t         v sŒ|dk(  rdnd}t        |›d|› ddj                  t        «      › d�«      ‚ y)	aM  Reject reserved protocol channel names before they hit the fallback.

    Genuine extension names pass through untouched; only names that
    ``infer_channel`` treats as built-in methods without an interleave decoder
    are rejected, so a typo'd or unsupported protocol channel surfaces an error
    instead of an empty stream.
    r   z (use "tool_calls")Ú z. is not a valid interleave_projections channelz. Supported channels: z, z, or an extension name.N)ÚRESERVED_INTERLEAVE_CHANNELSÚ
ValueErrorÚjoinÚSUPPORTED_INTERLEAVE_CHANNELS)ÚchannelsÚchÚhints      úZ/var/www/html/gaurav-v2/venv/lib/python3.12/site-packages/langgraph_sdk/stream/decoders.pyÚvalidate_interleave_channelsr   "   s_   € ó ˆØÔ-Ò-Ø,.°'ªMÑ(¸rˆDÜØ�&ÐFÀtÀfð M'Ø'+§y¡yÔ1NÓ'OÐ&Pð Q(ð(óð ñ ó    c                óŠ   — t        | t        «      sg S | j                  d«      xs g }t        |t        «      rt        |«      S g S )NÚ	namespace)Ú
isinstanceÚdictÚgetÚlist)Úparams_fieldr!   s     r   Ú_event_namespacer'   4   s>   € Ü�l¤DÔ)Øˆ	Ø× Ñ  Ó-Ò3°€IÜ(¨´DÔ9Œ4�	‹?ÐA¸rÐAr   c                óh   — | j                  d«      xs | j                  d«      }|�t        |«      S d S )NÚidÚ
message_id©r$   Ústr)Údatar*   s     r   Ú_message_event_idr.   ;   s1   € Ø—‘˜$“Ò9 4§8¡8¨LÓ#9€JØ(Ð4Œ3ˆz‹?Ð>¸$Ð>r   Nc                ó6   — t        | «      }|�d|› �S |�d|› �S y)a  Return the routing key for a message-channel event in `active`.

    Keys on `message_id` when available so concurrent messages that share the
    same `run_id` (two AI turns in one agent step) route to independent streams
    rather than colliding on a shared `run:<run_id>` slot.
    zmessage:Ú
__single__)r.   )r-   Úfallbackr*   s      r   Ú_message_route_keyr2   @   s7   € ô # 4Ó(€JØÐØ˜*˜Ð&Ð&ØÐØ˜(˜Ð$Ð$Ør   )ÚstartedÚ	completedÚfailedÚinterruptedc                ó>   — | j                  d«      \  }}}||r|fS d fS )NÚ:)Ú	partition)ÚsegmentÚnameÚsepÚtask_ids       r   Ú_parse_namespace_segmentr>   R   s.   € Ø ×*Ñ*¨3Ó/Ñ€Dˆ#ˆwØ™C�Ð)Ð) TÐ)Ð)r   c                óh   — | j                  d«      ry| j                  d«      }|rdt        |«      fS y)NÚ
interrupts)r6   NÚerrorr5   )r4   Nr+   )r-   rA   s     r   Ú_terminal_from_tasks_resultrB   W   s6   € ð ‡x�x�ÔØ"Ø�H‰H�WÓ€EÙØœ˜U›Ð#Ð#Ør   c                ón   — t        | «      t        |«      dz   k(  xr t        | d t        |«       «      |k(  S )Né   )ÚlenÚtuple)r!   Úscopes     r   Ú_is_direct_childrH   b   s4   € Üˆy‹>œS ›Z¨!™^Ñ+ÒW´°iÀÄ#ÀeÃ*Ð6MÓ0NÐRWÑ0WÐWr   c                  ó   — e Zd Zdd„Zy)ÚDecoderc                 ó   — y ©N© )ÚselfÚevents     r   ÚfeedzDecoder.feedg   s   € ¸sr   N©rO   zMapping[str, Any]ÚreturnúIterable[Any])Ú__name__Ú
__module__Ú__qualname__rP   rM   r   r   rJ   rJ   f   s   „ ÜBr   rJ   c                  ó"   — e Zd ZdZddd„Zdd„Zy)ÚDataDecoderuW  Yields `params.data` from events of a single `method`.

    Covers the channels whose projection is just "emit the payload": `values`,
    `updates`, `checkpoints`, `tasks` â€” the SDK analog of local's
    `Values`/`Updates`/`Checkpoints`/`TasksTransformer`, all of which push
    `params["data"]` unchanged. The REST-state seeding for `values` stays at
    the projection layer; it is a one-shot pre-stream fetch, not part of the
    event state machine.

    Args:
        method: The protocol `method` this decoder consumes.
        namespace: When not `None`, events whose namespace differs are ignored
            (scope filter, mirroring the local transformers' `namespace != scope`
            check). `None` consumes every namespace â€” the historical `values`
            projection behavior, where subscription scoping is handled upstream.
    Nc                óF   — || _         |�t        |«      | _        y d | _        y rL   )Ú_methodr%   Ú
_namespace)rN   Úmethodr!   s      r   Ú__init__zDataDecoder.__init__|   s   € ØˆŒØ-6Ð-Bœ$˜y›/ˆ�Èˆ�r   c              #  óî   K  — |j                  d«      | j                  k7  ry |j                  d«      xs i }| j                  �t        |«      | j                  k7  ry |j                  d«      }|�|–— y y ­w)Nr\   Úparamsr-   )r$   rZ   r[   r'   ©rN   rO   r_   r-   s       r   rP   zDataDecoder.feed€   sm   è ø€ Ø�9‰9�XÓ $§,¡,Ò.ØØ—‘˜8Ó$Ò*¨ˆØ�?‰?Ð&Ô+;¸FÓ+CÀtÇÁÒ+VØØ�z‰z˜&Ó!ˆØÐØ‹Jð ùó   ‚A3A5rL   )r\   r,   r!   zlist[str] | NonerQ   ©rT   rU   rV   Ú__doc__r]   rP   rM   r   r   rX   rX   j   s   „ ñô"Môr   rX   c                  ó(   — e Zd ZdZ	 	 	 	 dd„Zdd„Zy)ÚMessagesDecoderaW  Yields one chat-model stream per `message-start` event.

    Subsequent events route to the matching stream via `stream.dispatch(data)`.
    Mirrors the per-event body of `_MessagesProjection._messages_iter`
    (`_async/stream.py:404-458`). The subscription open/close and the
    `_root_messages_inbox` drain branch stay at the projection layer.

    Args:
        namespace: Events whose namespace differs are ignored (scope filter).
        stream_factory: Keyword-only `(namespace, node, message_id) -> stream`.
            Sync binds `ChatModelStream`; async binds `AsyncChatModelStream`.
    c                ó@   — t        |«      | _        || _        i | _        y rL   )r%   r[   Ú_stream_factoryÚ_active)rN   r!   Ústream_factorys      r   r]   zMessagesDecoder.__init__™   s   € ô
 ˜y›/ˆŒØ-ˆÔØ')ˆ�r   c              #  óü  K  — |j                  d«      dk7  ry |j                  d«      xs i }t        |«      | j                  k7  ry |j                  d«      }t        |t        «      sy |j                  d«      dk(  r©t        |«      }t        ||¬«      }t        |j                  d«      t        «      r|j                  d«      ni }| j                  t        | j                  «      |r|j                  d	«      nd |¬
«      }|| j                  |<   |j                  |«       |–— y t        |«      }| j                  j                  |«      }|€I|dk(  rDt        | j                  «      dk(  r,t        t        | j                  j                  «       «      «      }|€y |j                  |«       |j                  d«      dv r>t        | j                  j                  «       «      D ]  \  }}	|	|u sŒ| j                  |= Œ y y ­w)Nr\   r   r_   r-   rO   zmessage-start)r1   ÚmetadataÚlanggraph_node)r!   Únoder*   r0   rD   )zmessage-finishrA   )r$   r'   r[   r"   r#   r.   r2   rg   r%   rh   ÚdispatchrE   ÚnextÚiterr
   Úitems)
rN   rO   r_   r-   r*   Úkeyrk   ÚstreamÚ	route_keyÚ	candidates
             r   rP   zMessagesDecoder.feed¢   s¹  è ø€ Ø�9‰9�XÓ *Ò,ØØ—‘˜8Ó$Ò*¨ˆÜ˜FÓ# t§¡Ò6ØØ�z‰z˜&Ó!ˆÜ˜$¤Ô%ØØ�8‰8�GÓ Ò/Ü*¨4Ó0ˆJÜ$ T°JÔ?ˆCä(2°4·8±8¸JÓ3GÌÔ(N�—‘˜Ô$ÐTVð ð ×)Ñ)Ü˜tŸ™Ó/Ù7?�X—\‘\Ð"2Ô3ÀTØ%ð *ó ˆFð
 !'ˆD�L‰L˜ÑØ�O‰O˜DÔ!Ø‹Lä$ TÓ*ˆCØ—\‘\×%Ñ% cÓ*ˆFØˆ~ #¨Ò"5¼#¸d¿l¹lÓ:KÈqÒ:PÜœd 4§<¡<×#6Ñ#6Ó#8Ó9Ó:�Øˆ~ØØ�O‰O˜DÔ!Ø�x‰x˜Ó Ð$?Ñ?Ü,0°·±×1CÑ1CÓ1EÖ,FÑ(�I˜yØ  FÒ*Ø ŸL™L¨Ñ3ñ -Gð @ùs   ‚G(G<Ç+G<N)r!   ú	list[str]ri   úCallable[..., Any]rQ   rb   rM   r   r   re   re   ‹   s#   „ ñð*àð*ð +ó*ô"4r   re   c                  ó    — e Zd ZdZdd„Zdd„Zy)ÚToolCallsDecodera¿  Yields one tool-call handle per `tool-started` event.

    Mirrors the per-event body of `_ToolCallsProjection._tool_calls_iter`
    (`_async/stream.py:1168-1217`). The thread register/unregister and the
    terminal-error-on-close finally stay at the projection / wrapper layer.

    Args:
        namespace: Events whose namespace differs are ignored.
        handle_factory: Keyword-only `(tool_call_id, name, input, namespace) -> handle`.
    c                ó@   — t        |«      | _        || _        i | _        y rL   )r%   r[   Ú_handle_factoryrh   )rN   r!   Úhandle_factorys      r   r]   zToolCallsDecoder.__init__Ó   s   € Ü˜y›/ˆŒØ-ˆÔØ')ˆ�r   c              #  ó  K  — |j                  d«      dk7  ry |j                  d«      xs i }t        |«      | j                  k7  ry |j                  d«      }t        |t        «      sy |j                  d«      }t        |t
        «      sy |j                  d«      }|dk(  rn|j                  d«      }| j                  |t        |t
        «      r|nd	|j                  d
«      t        | j                  «      ¬«      }|| j                  |<   |–— y |dk(  rR| j                  j                  |«      }|j                  d«      }|�#t        |t
        «      r|j                  |«       y y y |dk(  r@| j                  j                  |d «      }|�!|j                  |j                  d«      «       y y |dk(  rX| j                  j                  |d «      }|�9|j                  d«      }	|j                  t        |	rt        |	«      nd«      «       y y y ­w)Nr\   r   r_   r-   Útool_call_idrO   ztool-startedÚ	tool_namer   r   )r~   r;   r   r!   ztool-output-deltaÚdeltaztool-finishedÚoutputz
tool-errorÚmessagezTool call errored)r$   r'   r[   r"   r#   r,   r{   r%   rh   Ú_push_deltaÚpopÚ_finishÚ_failÚRuntimeError)
rN   rO   r_   r-   r~   Ú
event_typer;   Úhandler€   r‚   s
             r   rP   zToolCallsDecoder.feedØ   sÕ  è ø€ Ø�9‰9�XÓ 'Ò)ØØ—‘˜8Ó$Ò*¨ˆÜ˜FÓ# t§¡Ò6ØØ�z‰z˜&Ó!ˆÜ˜$¤Ô%ØØ—x‘x Ó/ˆÜ˜,¬Ô,ØØ—X‘X˜gÓ&ˆ
Ø˜Ò'Ø—8‘8˜KÓ(ˆDØ×)Ñ)Ø)Ü'¨¬cÔ2‘T¸Ø—h‘h˜wÓ'Ü˜tŸ™Ó/ð	 *ó ˆFð *0ˆD�L‰L˜Ñ&Ø‹LØÐ.Ò.Ø—\‘\×%Ñ% lÓ3ˆFØ—H‘H˜WÓ%ˆEØÐ!¤j°¼Ô&<Ø×"Ñ" 5Õ)ð '=Ð!à˜?Ò*Ø—\‘\×%Ñ% l°DÓ9ˆFØÐ!Ø—‘˜tŸx™x¨Ó1Õ2ð "à˜<Ò'Ø—\‘\×%Ñ% l°DÓ9ˆFØÐ!ØŸ(™( 9Ó-�Ø—‘Ü ±¤ W¤Ð>QÓRõð "ð (ùs   ‚HHN)r!   rv   r|   rw   rQ   rb   rM   r   r   ry   ry   Ç   s   „ ñ	ó*ô
&r   ry   c                  ó0   — e Zd ZdZdd„Zdd„Zd	d„Zd
d„Zy)ÚSubgraphsDecoderaâ  Discovers child subgraph handles and fans out events to active ones.

    Mirrors the per-event body of `_SubgraphsProjection._subgraphs_iter`
    (`_async/stream.py:963-1041`) plus `_apply_tasks_result`. Root-inbox
    forwarding and terminal-status-on-close stay at the projection / wrapper
    layer.

    Args:
        scope: Tuple-form namespace of this decoder's parent. `()` for root.
        handle_factory: Keyword-only `(path, graph_name, trigger_call_id) -> handle`.
    c                óL   — || _         || _        i | _        t        «       | _        y rL   )Ú_scoper{   rh   ÚsetÚ_seen)rN   rG   r|   s      r   r]   zSubgraphsDecoder.__init__  s!   € ØˆŒØ-ˆÔØ35ˆŒÜ+.«5ˆ�
r   c              #  ó®  K  — |j                  d«      xs i }t        |«      }|j                  d«      }t        |t        «      sy |j                  d«      }t	        |«      }| j
                  j                  «       D ]:  \  }}t        |«      }	t        |«      |	k\  sŒ |d |	 |k(  sŒ)|j                  |«        n |dk(  rHd|v r| j                  ||«       y t        || j                  «      r| j                  |«      E d {  –—†  y y |dk(  rF|j                  d«      dk(  r1t        || j                  «      r| j                  |«      E d {  –—†  y y y y 7 ŒR7 Œ
­w)	Nr_   r-   r\   r   Úresultr   rO   r3   )r$   r'   r"   r#   rF   rh   rq   rE   Ú_push_eventÚ_apply_tasks_resultrH   r�   Ú	_discover)
rN   rO   r_   r!   r-   r\   Úns_tupleÚ
child_pathÚchild_handleÚ	child_lens
             r   rP   zSubgraphsDecoder.feed  sD  è ø€ Ø—‘˜8Ó$Ò*¨ˆÜ$ VÓ,ˆ	Ø�z‰z˜&Ó!ˆÜ˜$¤Ô%ØØ—‘˜8Ó$ˆô ˜Ó#ˆØ(,¯©×(:Ñ(:Ö(<Ñ$ˆJ˜Ü˜J›ˆIÜ�8‹} 	Ó)¨h°z¸	Ð.BÀjÓ.PØ×(Ñ(¨Ô/Ùð	 )=ð �WÒØ˜4ÑØ×(Ñ(¨°DÕ9Ü! )¨T¯[©[Ô9ØŸ>™>¨)Ó4×4Ñ4ð :ð �kÒ!Ø—‘˜Ó! YÒ.Ü  ¨D¯K©KÔ8à—~‘~ iÓ0×0Ñ0ð 9ð /ð "ð 5øð 1ús2   ‚BEÂEÂ$AEÃ>EÃ?A	EÅEÅ		EÅEc              #  óî   K  — t        |«      }|| j                  v ry | j                  j                  |«       t        |d   «      \  }}| j	                  ||xs d |¬«      }|| j
                  |<   |–— y ­w)Néÿÿÿÿ)ÚpathÚ
graph_nameÚtrigger_call_id)rF   r�   Úaddr>   r{   rh   )rN   r!   r›   rœ   r�   r‰   s         r   r”   zSubgraphsDecoder._discover1  sz   è ø€ Ü�YÓˆØ�4—:‘:ÑØØ�
‰
�‰�tÔÜ&>¸tÀB¹xÓ&HÑ#ˆ
�OØ×%Ñ%ØØ!Ò) TØ+ð &ó 
ˆð
 $ˆ�‰�TÑØ‹ùra   c                ó$  — |j                  d«      }|sy t        |«      }t        | j                  j	                  «       «      D ]K  \  }}|d d |k7  rŒ|j
                  |k7  rŒt        |«      \  }}|j                  ||«       | j                  |= ŒM y )Nr)   rš   )r$   rF   r%   rh   rq   r�   rB   r…   )	rN   r!   r-   Ú	result_idÚparent_pathr–   r‰   ÚstatusrA   s	            r   r“   z$SubgraphsDecoder._apply_tasks_result?  sŠ   € Ø—H‘H˜T“Nˆ	ÙØÜ˜IÓ&ˆÜ"& t§|¡|×'9Ñ'9Ó';Ö"<ÑˆJ˜Ø˜#˜2ˆ +Ò-ØØ×%Ñ%¨Ò2ØÜ7¸Ó=‰MˆF�EØ�N‰N˜6 5Ô)Ø—‘˜ZÑ(ñ #=r   N)rG   útuple[str, ...]r|   rw   rQ   )r!   rv   rR   rS   )r!   rv   r-   údict[str, Any]rR   ÚNone)rT   rU   rV   rc   r]   rP   r”   r“   rM   r   r   r‹   r‹     s   „ ñ
ó1ó1ó:ô)r   r‹   c                  ó    — e Zd ZdZdd„Zdd„Zy)ÚExtensionsDecoderaI  Yields `params.data` from one named custom channel.

    Mirrors `_ExtensionProjection._iter` (`_async/stream.py:1278-1299`), with
    an added name filter so it can share one subscription in interleave.

    Args:
        name: The extension name. Only `custom` events whose `data["name"]`
            matches are consumed.
    c                ó,   — |st        d«      ‚|| _        y )Nz!extension name must be non-empty.)r   Ú_name)rN   r;   s     r   r]   zExtensionsDecoder.__init__Y  s   € ÙÜÐ@ÓAÐAØˆ�
r   c              #  óê   K  — |j                  d«      dk7  ry |j                  d«      xs i }|j                  d«      }t        |t        «      sy |j                  d«      | j                  k7  ry |–— y ­w)Nr\   Úcustomr_   r-   r;   )r$   r"   r#   r©   r`   s       r   rP   zExtensionsDecoder.feed^  se   è ø€ Ø�9‰9�XÓ (Ò*ØØ—‘˜8Ó$Ò*¨ˆØ�z‰z˜&Ó!ˆÜ˜$¤Ô%ØØ�8‰8�FÓ˜tŸz™zÒ)ØØ‹
ùs   ‚A1A3N)r;   r,   rQ   rb   rM   r   r   r§   r§   N  s   „ ñóô
	r   r§   )r   rv   rR   r¥   )r&   r   rR   rv   )r-   r¤   rR   ú
str | NonerL   )r-   r¤   r1   r¬   rR   r,   )r:   r,   rR   ztuple[str, str | None])r-   r¤   rR   z!tuple[SubgraphStatus, str | None])r!   rv   rG   r£   rR   Úbool)rc   Ú
__future__r   Úcollections.abcr   r   r   Útypingr   r   r	   r   Ú	frozensetr   r   r'   r.   r2   ÚSubgraphStatusr>   rB   rH   rJ   rX   re   ry   r‹   r§   rM   r   r   Ú<module>r³      s¹   ðñõ #ç 7Ñ 7ß )Ñ )ð!Ð ñ   )Ò)HÓIÐ óó$Bó?ô
ð ÐHÑI€ó*ð
Ø
ðà&óóXôCˆhô C÷ñ ÷B94ñ 94÷x7ñ 7÷tJ)ñ J)÷Zò r   