langgraph 1.2.18__tar.gz → 1.2.19__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (179) hide show
  1. {langgraph-1.2.18 → langgraph-1.2.19}/PKG-INFO +1 -1
  2. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/_internal/_runnable.py +119 -60
  3. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/graph/message.py +8 -11
  4. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/_draw.py +4 -0
  5. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/_messages.py +21 -8
  6. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/_read.py +2 -11
  7. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/_retry.py +9 -3
  8. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/_tools.py +12 -12
  9. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/main.py +53 -50
  10. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/remote.py +10 -0
  11. {langgraph-1.2.18 → langgraph-1.2.19}/pyproject.toml +1 -1
  12. {langgraph-1.2.18 → langgraph-1.2.19}/tests/__snapshots__/test_large_cases.ambr +10 -0
  13. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_pregel.py +33 -0
  14. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_pregel_async.py +97 -0
  15. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_remote_graph.py +83 -0
  16. langgraph-1.2.19/tests/test_stream_namespaces.py +308 -0
  17. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_tool_stream_handler.py +124 -2
  18. langgraph-1.2.19/tests/test_trace_policy.py +338 -0
  19. {langgraph-1.2.18 → langgraph-1.2.19}/uv.lock +5 -5
  20. langgraph-1.2.18/tests/test_trace_policy.py +0 -149
  21. {langgraph-1.2.18 → langgraph-1.2.19}/.gitignore +0 -0
  22. {langgraph-1.2.18 → langgraph-1.2.19}/LICENSE +0 -0
  23. {langgraph-1.2.18 → langgraph-1.2.19}/Makefile +0 -0
  24. {langgraph-1.2.18 → langgraph-1.2.19}/README.md +0 -0
  25. {langgraph-1.2.18 → langgraph-1.2.19}/bench/__init__.py +0 -0
  26. {langgraph-1.2.18 → langgraph-1.2.19}/bench/__main__.py +0 -0
  27. {langgraph-1.2.18 → langgraph-1.2.19}/bench/fanout_to_subgraph.py +0 -0
  28. {langgraph-1.2.18 → langgraph-1.2.19}/bench/pydantic_state.py +0 -0
  29. {langgraph-1.2.18 → langgraph-1.2.19}/bench/react_agent.py +0 -0
  30. {langgraph-1.2.18 → langgraph-1.2.19}/bench/sequential.py +0 -0
  31. {langgraph-1.2.18 → langgraph-1.2.19}/bench/serde_allowlist.py +0 -0
  32. {langgraph-1.2.18 → langgraph-1.2.19}/bench/wide_dict.py +0 -0
  33. {langgraph-1.2.18 → langgraph-1.2.19}/bench/wide_state.py +0 -0
  34. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/_internal/__init__.py +0 -0
  35. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/_internal/_cache.py +0 -0
  36. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/_internal/_config.py +0 -0
  37. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/_internal/_constants.py +0 -0
  38. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/_internal/_fields.py +0 -0
  39. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/_internal/_future.py +0 -0
  40. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/_internal/_pydantic.py +0 -0
  41. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/_internal/_queue.py +0 -0
  42. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/_internal/_replay.py +0 -0
  43. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/_internal/_retry.py +0 -0
  44. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/_internal/_scratchpad.py +0 -0
  45. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/_internal/_serde.py +0 -0
  46. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/_internal/_timeout.py +0 -0
  47. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/_internal/_typing.py +0 -0
  48. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/callbacks.py +0 -0
  49. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/channels/__init__.py +0 -0
  50. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/channels/any_value.py +0 -0
  51. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/channels/base.py +0 -0
  52. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/channels/binop.py +0 -0
  53. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/channels/delta.py +0 -0
  54. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/channels/ephemeral_value.py +0 -0
  55. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/channels/last_value.py +0 -0
  56. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/channels/named_barrier_value.py +0 -0
  57. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/channels/topic.py +0 -0
  58. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/channels/untracked_value.py +0 -0
  59. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/config.py +0 -0
  60. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/constants.py +0 -0
  61. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/errors.py +0 -0
  62. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/func/__init__.py +0 -0
  63. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/graph/__init__.py +0 -0
  64. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/graph/_branch.py +0 -0
  65. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/graph/_node.py +0 -0
  66. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/graph/state.py +0 -0
  67. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/graph/ui.py +0 -0
  68. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/managed/__init__.py +0 -0
  69. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/managed/base.py +0 -0
  70. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/managed/is_last_step.py +0 -0
  71. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/__init__.py +0 -0
  72. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/_algo.py +0 -0
  73. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/_call.py +0 -0
  74. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/_checkpoint.py +0 -0
  75. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/_config.py +0 -0
  76. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/_executor.py +0 -0
  77. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/_io.py +0 -0
  78. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/_log.py +0 -0
  79. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/_loop.py +0 -0
  80. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/_remote_run_stream.py +0 -0
  81. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/_runner.py +0 -0
  82. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/_task_status.py +0 -0
  83. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/_utils.py +0 -0
  84. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/_validate.py +0 -0
  85. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/_write.py +0 -0
  86. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/debug.py +0 -0
  87. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/protocol.py +0 -0
  88. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/pregel/types.py +0 -0
  89. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/py.typed +0 -0
  90. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/runtime.py +0 -0
  91. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/stream/__init__.py +0 -0
  92. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/stream/_convert.py +0 -0
  93. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/stream/_mux.py +0 -0
  94. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/stream/_types.py +0 -0
  95. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/stream/run_stream.py +0 -0
  96. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/stream/stream_channel.py +0 -0
  97. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/stream/transformers.py +0 -0
  98. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/types.py +0 -0
  99. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/typing.py +0 -0
  100. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/utils/__init__.py +0 -0
  101. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/utils/config.py +0 -0
  102. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/utils/runnable.py +0 -0
  103. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/version.py +0 -0
  104. {langgraph-1.2.18 → langgraph-1.2.19}/langgraph/warnings.py +0 -0
  105. {langgraph-1.2.18 → langgraph-1.2.19}/tests/__init__.py +0 -0
  106. {langgraph-1.2.18 → langgraph-1.2.19}/tests/__snapshots__/test_pregel.ambr +0 -0
  107. {langgraph-1.2.18 → langgraph-1.2.19}/tests/__snapshots__/test_pregel_async.ambr +0 -0
  108. {langgraph-1.2.18 → langgraph-1.2.19}/tests/agents.py +0 -0
  109. {langgraph-1.2.18 → langgraph-1.2.19}/tests/any_int.py +0 -0
  110. {langgraph-1.2.18 → langgraph-1.2.19}/tests/any_str.py +0 -0
  111. {langgraph-1.2.18 → langgraph-1.2.19}/tests/compose-postgres.yml +0 -0
  112. {langgraph-1.2.18 → langgraph-1.2.19}/tests/compose-redis.yml +0 -0
  113. {langgraph-1.2.18 → langgraph-1.2.19}/tests/conftest.py +0 -0
  114. {langgraph-1.2.18 → langgraph-1.2.19}/tests/conftest_checkpointer.py +0 -0
  115. {langgraph-1.2.18 → langgraph-1.2.19}/tests/conftest_store.py +0 -0
  116. {langgraph-1.2.18 → langgraph-1.2.19}/tests/example_app/example_graph.py +0 -0
  117. {langgraph-1.2.18 → langgraph-1.2.19}/tests/example_app/langgraph.json +0 -0
  118. {langgraph-1.2.18 → langgraph-1.2.19}/tests/example_app/requirements.txt +0 -0
  119. {langgraph-1.2.18 → langgraph-1.2.19}/tests/fake_chat.py +0 -0
  120. {langgraph-1.2.18 → langgraph-1.2.19}/tests/fake_tracer.py +0 -0
  121. {langgraph-1.2.18 → langgraph-1.2.19}/tests/memory_assert.py +0 -0
  122. {langgraph-1.2.18 → langgraph-1.2.19}/tests/messages.py +0 -0
  123. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_algo.py +0 -0
  124. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_channels.py +0 -0
  125. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_checkpoint_migration.py +0 -0
  126. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_config_async.py +0 -0
  127. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_delta_channel_benchmark.py +0 -0
  128. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_delta_channel_exit_mode.py +0 -0
  129. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_delta_channel_fork.py +0 -0
  130. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_delta_channel_id_stability.py +0 -0
  131. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_delta_channel_migration.py +0 -0
  132. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_delta_channel_node_cache.py +0 -0
  133. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_delta_channel_parallel_order.py +0 -0
  134. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_delta_channel_run_input.py +0 -0
  135. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_delta_channel_seal_subscribers.py +0 -0
  136. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_delta_channel_subgraph.py +0 -0
  137. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_delta_channel_supersteps_bound.py +0 -0
  138. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_delta_channel_to_plain.py +0 -0
  139. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_delta_channel_update_overwrite.py +0 -0
  140. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_delta_channel_update_state.py +0 -0
  141. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_delta_channel_write_failures.py +0 -0
  142. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_deprecation.py +0 -0
  143. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_graph_callbacks.py +0 -0
  144. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_interleave_arrival_order.py +0 -0
  145. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_interrupt_migration.py +0 -0
  146. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_interrupt_state.py +0 -0
  147. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_interruption.py +0 -0
  148. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_large_cases.py +0 -0
  149. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_large_cases_async.py +0 -0
  150. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_managed_values.py +0 -0
  151. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_messages_state.py +0 -0
  152. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_parent_command.py +0 -0
  153. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_parent_command_async.py +0 -0
  154. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_pregel_debug.py +0 -0
  155. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_pregel_stream_events_v3.py +0 -0
  156. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_prune_postgres.py +0 -0
  157. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_pydantic.py +0 -0
  158. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_remote_graph_v3.py +0 -0
  159. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_retry.py +0 -0
  160. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_runnable.py +0 -0
  161. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_runtime.py +0 -0
  162. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_serde_allowlist.py +0 -0
  163. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_state.py +0 -0
  164. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_stream_before_builtins.py +0 -0
  165. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_stream_data_transformers.py +0 -0
  166. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_stream_events_v3.py +0 -0
  167. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_stream_events_v3_e2e.py +0 -0
  168. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_stream_events_v3_kwarg_forwarding.py +0 -0
  169. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_stream_lifecycle_transformer.py +0 -0
  170. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_stream_messages_transformer.py +0 -0
  171. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_stream_subgraph_transformer.py +0 -0
  172. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_subgraph_detection.py +0 -0
  173. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_subgraph_persistence.py +0 -0
  174. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_subgraph_persistence_async.py +0 -0
  175. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_time_travel.py +0 -0
  176. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_time_travel_async.py +0 -0
  177. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_tracing_interops.py +0 -0
  178. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_type_checking.py +0 -0
  179. {langgraph-1.2.18 → langgraph-1.2.19}/tests/test_utils.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: langgraph
3
- Version: 1.2.18
3
+ Version: 1.2.19
4
4
  Summary: Building stateful, multi-actor applications with LLMs
5
5
  Project-URL: Homepage, https://docs.langchain.com/oss/python/langgraph/overview
6
6
  Project-URL: Documentation, https://reference.langchain.com/python/langgraph/
@@ -1,6 +1,7 @@
1
1
  from __future__ import annotations
2
2
 
3
3
  import asyncio
4
+ import copy
4
5
  import enum
5
6
  import inspect
6
7
  import logging
@@ -23,9 +24,16 @@ from typing import (
23
24
  Optional,
24
25
  Protocol,
25
26
  TypeGuard,
27
+ TypeVar,
26
28
  cast,
27
29
  )
28
30
 
31
+ from langchain_core.callbacks.base import BaseCallbackHandler, BaseCallbackManager
32
+ from langchain_core.callbacks.manager import (
33
+ AsyncCallbackManagerForChainRun,
34
+ BaseRunManager,
35
+ CallbackManagerForChainRun,
36
+ )
29
37
  from langchain_core.runnables.base import (
30
38
  Runnable,
31
39
  RunnableConfig,
@@ -41,6 +49,7 @@ from langchain_core.runnables.config import (
41
49
  var_child_runnable_config,
42
50
  )
43
51
  from langchain_core.runnables.utils import Input, Output
52
+ from langchain_core.tracers.base import BaseTracer
44
53
  from langchain_core.tracers.langchain import LangChainTracer
45
54
  from langgraph.store.base import BaseStore
46
55
 
@@ -57,7 +66,7 @@ from langgraph._internal._constants import (
57
66
  )
58
67
  from langgraph._internal._typing import MISSING
59
68
  from langgraph.errors import NodeError
60
- from langgraph.types import StreamWriter
69
+ from langgraph.types import StreamWriter, TracePolicy
61
70
 
62
71
  try:
63
72
  from langchain_core.tracers._streaming import _StreamingCallbackHandler
@@ -85,6 +94,29 @@ def _trace_payload(value: Any, transform: Callable[[Any], Any] | None) -> Any:
85
94
  return value
86
95
 
87
96
 
97
+ def _is_stream_handler(handler: BaseCallbackHandler) -> bool:
98
+ # Inheritance, not isinstance on the runtime-checkable protocol, which also
99
+ # matches any exporter that merely has the tap methods: stream handlers get a
100
+ # node's real payload and its streamed output.
101
+ return _StreamingCallbackHandler in type(handler).__mro__
102
+
103
+
104
+ _M = TypeVar("_M", bound=BaseCallbackManager | BaseRunManager)
105
+
106
+
107
+ def _split_handlers(manager: _M) -> tuple[_M, _M]:
108
+ # The recorded payload exists to keep tracer ingest small, so only tracers get it.
109
+ # `astream_log`'s handler is a tracer too, but it feeds the caller's own stream.
110
+ real, tracers = copy.copy(manager), copy.copy(manager)
111
+ tracers.handlers = [
112
+ h
113
+ for h in manager.handlers
114
+ if isinstance(h, BaseTracer) and not _is_stream_handler(h)
115
+ ]
116
+ real.handlers = [h for h in manager.handlers if h not in tracers.handlers]
117
+ return real, tracers
118
+
119
+
88
120
  def _set_config_context(
89
121
  config: RunnableConfig, run: Any = None
90
122
  ) -> Token[RunnableConfig | None]:
@@ -593,13 +625,15 @@ class RunnableSeq(Runnable):
593
625
  *steps: RunnableLike,
594
626
  name: str | None = None,
595
627
  trace_inputs: Callable[[Any], Any] | None = None,
596
- trace_outputs: Callable[[Any], Any] | None = None,
628
+ trace_policy: TracePolicy | None = None,
597
629
  ) -> None:
598
630
  """Create a new RunnableSeq.
599
631
 
600
632
  Args:
601
633
  steps: The steps to include in the sequence.
602
634
  name: The name of the `Runnable`.
635
+ trace_inputs: Transforms the input every callback handler receives.
636
+ trace_policy: Processes what tracers record, after `trace_inputs`.
603
637
 
604
638
  Raises:
605
639
  ValueError: If the sequence has less than 2 steps.
@@ -619,7 +653,67 @@ class RunnableSeq(Runnable):
619
653
  self.steps = steps_flat
620
654
  self.name = name
621
655
  self.trace_inputs = trace_inputs
622
- self.trace_outputs = trace_outputs
656
+ self.trace_policy = trace_policy or TracePolicy()
657
+
658
+ def _start(self, input: Any, config: RunnableConfig) -> CallbackManagerForChainRun:
659
+ callback_manager = get_callback_manager_for_config(config)
660
+ payload = _trace_payload(input, self.trace_inputs)
661
+ recorded = _trace_payload(payload, self.trace_policy.process_inputs)
662
+ name = config.get("run_name") or self.get_name()
663
+ run_id = config.pop("run_id", None)
664
+ if recorded is payload:
665
+ return callback_manager.on_chain_start(
666
+ None, payload, name=name, run_id=run_id
667
+ )
668
+ real, tracers = _split_handlers(callback_manager)
669
+ run_manager = real.on_chain_start(None, payload, name=name, run_id=run_id)
670
+ tracers.on_chain_start(None, recorded, name=name, run_id=run_manager.run_id)
671
+ run_manager.handlers = callback_manager.handlers
672
+ return run_manager
673
+
674
+ async def _astart(
675
+ self, input: Any, config: RunnableConfig
676
+ ) -> AsyncCallbackManagerForChainRun:
677
+ callback_manager = get_async_callback_manager_for_config(config)
678
+ payload = _trace_payload(input, self.trace_inputs)
679
+ recorded = _trace_payload(payload, self.trace_policy.process_inputs)
680
+ name = config.get("run_name") or self.get_name()
681
+ run_id = config.pop("run_id", None)
682
+ if recorded is payload:
683
+ return await callback_manager.on_chain_start(
684
+ None, payload, name=name, run_id=run_id
685
+ )
686
+ real, tracers = _split_handlers(callback_manager)
687
+ # Tracers start last, so a cancellation before then leaves no tracer run open.
688
+ run_manager = await real.on_chain_start(None, payload, name=name, run_id=run_id)
689
+ await tracers.on_chain_start(
690
+ None, recorded, name=name, run_id=run_manager.run_id
691
+ )
692
+ run_manager.handlers = callback_manager.handlers
693
+ return run_manager
694
+
695
+ def _end(self, run_manager: CallbackManagerForChainRun, output: Any) -> None:
696
+ recorded = _trace_payload(output, self.trace_policy.process_outputs)
697
+ if recorded is output:
698
+ run_manager.on_chain_end(output)
699
+ else:
700
+ real, tracers = _split_handlers(run_manager)
701
+ tracers.on_chain_end(recorded)
702
+ real.on_chain_end(output)
703
+
704
+ async def _aend(
705
+ self, run_manager: AsyncCallbackManagerForChainRun, output: Any
706
+ ) -> None:
707
+ recorded = _trace_payload(output, self.trace_policy.process_outputs)
708
+ if recorded is output:
709
+ await run_manager.on_chain_end(output)
710
+ else:
711
+ real, tracers = _split_handlers(run_manager)
712
+ # Tracers end first: on_chain_end is shielded once it starts, so a
713
+ # cancellation can only skip the other handlers' end, never leave a
714
+ # tracer run open.
715
+ await tracers.on_chain_end(recorded)
716
+ await real.on_chain_end(output)
623
717
 
624
718
  def __or__(
625
719
  self,
@@ -676,15 +770,8 @@ class RunnableSeq(Runnable):
676
770
  ) -> Any:
677
771
  if config is None:
678
772
  config = ensure_config()
679
- # setup callbacks and context
680
- callback_manager = get_callback_manager_for_config(config)
681
773
  # start the root run
682
- run_manager = callback_manager.on_chain_start(
683
- None,
684
- _trace_payload(input, self.trace_inputs),
685
- name=config.get("run_name") or self.get_name(),
686
- run_id=config.pop("run_id", None),
687
- )
774
+ run_manager = self._start(input, config)
688
775
  # invoke all steps in sequence
689
776
  try:
690
777
  for i, step in enumerate(self.steps):
@@ -712,7 +799,7 @@ class RunnableSeq(Runnable):
712
799
  run_manager.on_chain_error(e)
713
800
  raise
714
801
  else:
715
- run_manager.on_chain_end(_trace_payload(input, self.trace_outputs))
802
+ self._end(run_manager, input)
716
803
  return input
717
804
 
718
805
  async def ainvoke(
@@ -723,15 +810,8 @@ class RunnableSeq(Runnable):
723
810
  ) -> Any:
724
811
  if config is None:
725
812
  config = ensure_config()
726
- # setup callbacks
727
- callback_manager = get_async_callback_manager_for_config(config)
728
813
  # start the root run
729
- run_manager = await callback_manager.on_chain_start(
730
- None,
731
- _trace_payload(input, self.trace_inputs),
732
- name=config.get("run_name") or self.get_name(),
733
- run_id=config.pop("run_id", None),
734
- )
814
+ run_manager = await self._astart(input, config)
735
815
 
736
816
  # invoke all steps in sequence
737
817
  try:
@@ -765,7 +845,7 @@ class RunnableSeq(Runnable):
765
845
  await run_manager.on_chain_error(e)
766
846
  raise
767
847
  else:
768
- await run_manager.on_chain_end(_trace_payload(input, self.trace_outputs))
848
+ await self._aend(run_manager, input)
769
849
  return input
770
850
 
771
851
  def stream(
@@ -776,15 +856,8 @@ class RunnableSeq(Runnable):
776
856
  ) -> Iterator[Any]:
777
857
  if config is None:
778
858
  config = ensure_config()
779
- # setup callbacks
780
- callback_manager = get_callback_manager_for_config(config)
781
859
  # start the root run
782
- run_manager = callback_manager.on_chain_start(
783
- None,
784
- _trace_payload(input, self.trace_inputs),
785
- name=config.get("run_name") or self.get_name(),
786
- run_id=config.pop("run_id", None),
787
- )
860
+ run_manager = self._start(input, config)
788
861
  # get the run object
789
862
  for h in run_manager.handlers:
790
863
  if isinstance(h, LangChainTracer):
@@ -814,10 +887,9 @@ class RunnableSeq(Runnable):
814
887
  )
815
888
  iterator = step.transform(iterator, config)
816
889
  # populates streamed_output in astream_log() output if needed
817
- if _StreamingCallbackHandler is not None:
818
- for h in run_manager.handlers:
819
- if isinstance(h, _StreamingCallbackHandler):
820
- iterator = h.tap_output_iter(run_manager.run_id, iterator)
890
+ for h in run_manager.handlers:
891
+ if _is_stream_handler(h):
892
+ iterator = h.tap_output_iter(run_manager.run_id, iterator)
821
893
  # consume into final output
822
894
  output = context.run(_consume_iter, iterator)
823
895
  # sequence doesn't emit output, yield to mark as generator
@@ -826,7 +898,7 @@ class RunnableSeq(Runnable):
826
898
  run_manager.on_chain_error(e)
827
899
  raise
828
900
  else:
829
- run_manager.on_chain_end(_trace_payload(output, self.trace_outputs))
901
+ self._end(run_manager, output)
830
902
 
831
903
  async def astream(
832
904
  self,
@@ -836,15 +908,8 @@ class RunnableSeq(Runnable):
836
908
  ) -> AsyncIterator[Any]:
837
909
  if config is None:
838
910
  config = ensure_config()
839
- # setup callbacks
840
- callback_manager = get_async_callback_manager_for_config(config)
841
911
  # start the root run
842
- run_manager = await callback_manager.on_chain_start(
843
- None,
844
- _trace_payload(input, self.trace_inputs),
845
- name=config.get("run_name") or self.get_name(),
846
- run_id=config.pop("run_id", None),
847
- )
912
+ run_manager = await self._astart(input, config)
848
913
  # stream the last steps
849
914
  # transform the input stream of each step with the next
850
915
  # steps that don't natively support transforming an input stream will
@@ -880,12 +945,11 @@ class RunnableSeq(Runnable):
880
945
  if hasattr(aiterator, "aclose"):
881
946
  stack.push_async_callback(aiterator.aclose)
882
947
  # populates streamed_output in astream_log() output if needed
883
- if _StreamingCallbackHandler is not None:
884
- for h in run_manager.handlers:
885
- if isinstance(h, _StreamingCallbackHandler):
886
- aiterator = h.tap_output_aiter(
887
- run_manager.run_id, aiterator
888
- )
948
+ for h in run_manager.handlers:
949
+ if _is_stream_handler(h):
950
+ aiterator = h.tap_output_aiter(
951
+ run_manager.run_id, aiterator
952
+ )
889
953
  # consume into final output
890
954
  output = await asyncio.create_task(
891
955
  _consume_aiter(aiterator), context=context
@@ -896,9 +960,7 @@ class RunnableSeq(Runnable):
896
960
  await run_manager.on_chain_error(e)
897
961
  raise
898
962
  else:
899
- await run_manager.on_chain_end(
900
- _trace_payload(output, self.trace_outputs)
901
- )
963
+ await self._aend(run_manager, output)
902
964
  else:
903
965
  try:
904
966
  async with AsyncExitStack() as stack:
@@ -914,12 +976,11 @@ class RunnableSeq(Runnable):
914
976
  if hasattr(aiterator, "aclose"):
915
977
  stack.push_async_callback(aiterator.aclose)
916
978
  # populates streamed_output in astream_log() output if needed
917
- if _StreamingCallbackHandler is not None:
918
- for h in run_manager.handlers:
919
- if isinstance(h, _StreamingCallbackHandler):
920
- aiterator = h.tap_output_aiter(
921
- run_manager.run_id, aiterator
922
- )
979
+ for h in run_manager.handlers:
980
+ if _is_stream_handler(h):
981
+ aiterator = h.tap_output_aiter(
982
+ run_manager.run_id, aiterator
983
+ )
923
984
  # consume into final output
924
985
  output = await _consume_aiter(aiterator)
925
986
  # sequence doesn't emit output, yield to mark as generator
@@ -928,9 +989,7 @@ class RunnableSeq(Runnable):
928
989
  await run_manager.on_chain_error(e)
929
990
  raise
930
991
  else:
931
- await run_manager.on_chain_end(
932
- _trace_payload(output, self.trace_outputs)
933
- )
992
+ await self._aend(run_manager, output)
934
993
 
935
994
 
936
995
  def _consume_iter(it: Iterator[Any]) -> Any:
@@ -22,7 +22,7 @@ from langchain_core.messages import (
22
22
  )
23
23
  from typing_extensions import TypedDict, deprecated
24
24
 
25
- from langgraph._internal._constants import CONF, CONFIG_KEY_SEND, NS_SEP
25
+ from langgraph._internal._constants import CONF, CONFIG_KEY_SEND
26
26
  from langgraph.graph.state import StateGraph
27
27
  from langgraph.pregel._messages import (
28
28
  _messages_delta_reducer as _messages_delta_reducer,
@@ -343,7 +343,7 @@ def push_message(
343
343
  )
344
344
 
345
345
  from langgraph.config import get_config
346
- from langgraph.pregel._messages import StreamMessagesHandler
346
+ from langgraph.pregel._messages import StreamMessagesHandler, graph_namespace
347
347
 
348
348
  config = get_config()
349
349
  message = next(x for x in convert_to_messages([message]))
@@ -359,15 +359,12 @@ def push_message(
359
359
  ):
360
360
  handlers = config["callbacks"]
361
361
 
362
- if stream_handler := next(
363
- (x for x in handlers if isinstance(x, StreamMessagesHandler)), None
364
- ):
365
- metadata = config["metadata"]
366
- message_meta = (
367
- tuple(cast(str, metadata["langgraph_checkpoint_ns"]).split(NS_SEP)),
368
- metadata,
369
- )
370
- stream_handler._emit(message_meta, message, dedupe=False)
362
+ metadata = config["metadata"]
363
+ for handler in handlers:
364
+ if isinstance(handler, StreamMessagesHandler):
365
+ ns = graph_namespace(metadata)
366
+ if handler.subgraphs or not ns or ns == handler.parent_ns:
367
+ handler._emit((ns, metadata), message, dedupe=False)
371
368
 
372
369
  if state_key:
373
370
  config[CONF][CONFIG_KEY_SEND]([(state_key, message)])
@@ -228,6 +228,10 @@ def draw_graph(
228
228
  metadata["__interrupt"] = "before"
229
229
  elif name in interrupt_after_nodes:
230
230
  metadata["__interrupt"] = "after"
231
+ # Duck-typed so core doesn't import ToolNode from langgraph-prebuilt.
232
+ tools_by_name = getattr(node.bound, "tools_by_name", None)
233
+ if isinstance(tools_by_name, Mapping) and tools_by_name:
234
+ metadata["__tools"] = list(tools_by_name)
231
235
  graph.add_node(node.bound, name, metadata=metadata or None)
232
236
  # add start node
233
237
  if START not in nodes:
@@ -23,7 +23,7 @@ from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, LLMResul
23
23
  from pydantic import BaseModel
24
24
 
25
25
  from langgraph._internal._config import filter_to_user_tags
26
- from langgraph._internal._constants import NS_SEP
26
+ from langgraph._internal._constants import NS_SEP, PUSH
27
27
  from langgraph.channels.binop import _get_overwrite
28
28
  from langgraph.channels.delta import DeltaChannel
29
29
  from langgraph.constants import TAG_HIDDEN, TAG_NOSTREAM
@@ -55,6 +55,23 @@ def _state_values(obj: Any) -> Sequence[Any]:
55
55
  return ()
56
56
 
57
57
 
58
+ def graph_namespace(metadata: Mapping[str, Any]) -> tuple[str, ...]:
59
+ """Namespace of the graph a task runs in, from the task's run metadata.
60
+
61
+ Drops the task's own segment, plus one per enclosing `@task` call: a call
62
+ runs in its caller's graph but nests its segment under the caller's. A
63
+ call's `langgraph_path` is `(PUSH, <caller's path>, <index>, True)`, while
64
+ a `Send` task's ends in `False`.
65
+ """
66
+ ns = tuple(cast(str, metadata["langgraph_checkpoint_ns"]).split(NS_SEP))
67
+ path = metadata.get("langgraph_path", ())
68
+ drop = 1
69
+ while len(path) == 4 and path[0] == PUSH and path[-1] is True:
70
+ drop += 1
71
+ path = path[1]
72
+ return ns[:-drop]
73
+
74
+
58
75
  class StreamMessagesHandler(BaseCallbackHandler, _StreamingCallbackHandler):
59
76
  """A callback handler that implements stream_mode=messages.
60
77
 
@@ -148,9 +165,7 @@ class StreamMessagesHandler(BaseCallbackHandler, _StreamingCallbackHandler):
148
165
  **kwargs: Any,
149
166
  ) -> Any:
150
167
  if metadata and (not tags or (TAG_NOSTREAM not in tags)):
151
- ns = tuple(cast(str, metadata["langgraph_checkpoint_ns"]).split(NS_SEP))[
152
- :-1
153
- ]
168
+ ns = graph_namespace(metadata)
154
169
  if not self.subgraphs and len(ns) > 0 and ns != self.parent_ns:
155
170
  return
156
171
  if (filtered_tags := filter_to_user_tags(tags)) is not None:
@@ -213,10 +228,8 @@ class StreamMessagesHandler(BaseCallbackHandler, _StreamingCallbackHandler):
213
228
  and kwargs.get("name") == metadata.get("langgraph_node")
214
229
  and (not tags or TAG_HIDDEN not in tags)
215
230
  ):
216
- ns = tuple(cast(str, metadata["langgraph_checkpoint_ns"]).split(NS_SEP))[
217
- :-1
218
- ]
219
- if not self.subgraphs and len(ns) > 0:
231
+ ns = graph_namespace(metadata)
232
+ if not self.subgraphs and len(ns) > 0 and ns != self.parent_ns:
220
233
  return
221
234
  self.metadata[run_id] = (ns, metadata)
222
235
  for value in _state_values(inputs):
@@ -227,23 +227,14 @@ class PregelNode:
227
227
  def node(self) -> Runnable[Any, Any] | None:
228
228
  """Get a runnable that combines `bound` and `writers`."""
229
229
  writers = self.flat_writers
230
- trace_inputs = self.trace_policy.process_inputs if self.trace_policy else None
231
- trace_outputs = self.trace_policy.process_outputs if self.trace_policy else None
232
230
  if self.bound is DEFAULT_BOUND and not writers:
233
231
  return None
234
232
  elif self.bound is DEFAULT_BOUND and len(writers) == 1:
235
233
  return writers[0]
236
234
  elif self.bound is DEFAULT_BOUND:
237
- return RunnableSeq(
238
- *writers, trace_inputs=trace_inputs, trace_outputs=trace_outputs
239
- )
235
+ return RunnableSeq(*writers, trace_policy=self.trace_policy)
240
236
  elif writers:
241
- return RunnableSeq(
242
- self.bound,
243
- *writers,
244
- trace_inputs=trace_inputs,
245
- trace_outputs=trace_outputs,
246
- )
237
+ return RunnableSeq(self.bound, *writers, trace_policy=self.trace_policy)
247
238
  else:
248
239
  return self.bound
249
240
 
@@ -34,6 +34,7 @@ from langgraph._internal._constants import (
34
34
  CONFIG_KEY_THREAD_ID,
35
35
  CONFIG_KEY_TIMED_ATTEMPT_OBSERVER,
36
36
  NS_SEP,
37
+ RETURN,
37
38
  )
38
39
  from langgraph._internal._runnable import create_task_in_config_context
39
40
  from langgraph._internal._timeout import sync_timeout_unsupported
@@ -733,15 +734,14 @@ async def arun_with_retry(
733
734
  if stream:
734
735
  async for _ in task.proc.astream(task.input, config):
735
736
  pass
736
- break
737
+ return _return_value(task)
737
738
  return await task.proc.ainvoke(task.input, config)
738
739
  result = await _arun_with_timeout(
739
740
  task, config, resolved_timeout, attempt_ctx, stream=stream
740
741
  )
741
742
  _finish_timed_attempt(config, attempt_ctx)
742
743
  if stream:
743
- # if successful, end
744
- break
744
+ return _return_value(task)
745
745
  return result
746
746
  except ParentCommand as exc:
747
747
  ns: str = config[CONF][CONFIG_KEY_CHECKPOINT_NS]
@@ -831,6 +831,12 @@ async def arun_with_retry(
831
831
  config = patch_configurable(config, {CONFIG_KEY_RESUMING: True})
832
832
 
833
833
 
834
+ def _return_value(task: PregelExecutableTask) -> Any:
835
+ # Streaming drains the task instead of returning its result, so a caller
836
+ # awaiting a `@task` needs the value the task wrote.
837
+ return next((value for channel, value in task.writes if channel == RETURN), None)
838
+
839
+
834
840
  def _should_retry_on(retry_policy: RetryPolicy, exc: Exception) -> bool:
835
841
  """Check if the given exception should be retried based on the retry policy."""
836
842
  if isinstance(retry_policy.retry_on, Sequence):
@@ -7,8 +7,9 @@ from uuid import UUID
7
7
 
8
8
  from langchain_core.callbacks import BaseCallbackHandler
9
9
 
10
- from langgraph._internal._constants import NS_SEP
11
10
  from langgraph.constants import TAG_NOSTREAM
11
+ from langgraph.errors import GraphDrained, GraphInterrupt
12
+ from langgraph.pregel._messages import graph_namespace
12
13
  from langgraph.pregel.protocol import StreamChunk
13
14
 
14
15
  try:
@@ -91,12 +92,9 @@ class StreamToolCallHandler(BaseCallbackHandler, _StreamingCallbackHandler):
91
92
  ) -> tuple[str, ...] | None:
92
93
  """Resolve the namespace this tool call should emit at, or `None` to skip.
93
94
 
94
- Mirrors `StreamMessagesHandler.on_chat_model_start`'s namespace
95
- derivation: parses `langgraph_checkpoint_ns` (which ends with
96
- the `node_name:task_id` of the calling node), drops that
97
- trailing segment, and returns the containing subgraph's own
98
- namespace. Returns `None` when the call should be silently
99
- suppressed:
95
+ Mirrors `StreamMessagesHandler.on_chat_model_start`: the namespace
96
+ is that of the graph the tool runs in (`graph_namespace`). Returns
97
+ `None` when the call should be silently suppressed:
100
98
 
101
99
  - `metadata` is missing — handler is attached to a context
102
100
  without Pregel routing info.
@@ -109,11 +107,9 @@ class StreamToolCallHandler(BaseCallbackHandler, _StreamingCallbackHandler):
109
107
  return None
110
108
  if tags and TAG_NOSTREAM in tags:
111
109
  return None
112
- nskey = metadata.get("langgraph_checkpoint_ns")
113
- if not nskey:
114
- ns: tuple[str, ...] = ()
115
- else:
116
- ns = tuple(cast(str, nskey).split(NS_SEP))[:-1]
110
+ ns = (
111
+ graph_namespace(metadata) if metadata.get("langgraph_checkpoint_ns") else ()
112
+ )
117
113
  if not self.subgraphs and len(ns) > 0 and ns != self.parent_ns:
118
114
  return None
119
115
  return ns
@@ -188,6 +184,10 @@ class StreamToolCallHandler(BaseCallbackHandler, _StreamingCallbackHandler):
188
184
  return
189
185
  ns, tool_call_id, token = info
190
186
  self._reset_writer(token)
187
+ # An interrupted or drained tool is paused, not failed: it runs again
188
+ # on resume and reports its start and end then.
189
+ if isinstance(error, (GraphInterrupt, GraphDrained)):
190
+ return
191
191
  self.stream(
192
192
  (
193
193
  ns,