jaf-py 2.6.5__py3-none-any.whl → 2.6.7__py3-none-any.whl

jaf/__init__.py

@@ -201,7 +201,7 @@ def generate_run_id() -> RunId:
     return create_run_id(str(uuid.uuid4()))
 
 
-__version__ = "2.6.5"
+__version__ = "2.6.7"
 __all__ = [
     # Core types and functions
     "TraceId",

jaf/core/agent_tool.py

@@ -78,6 +78,7 @@ def create_agent_tool(
     metadata: Optional[Dict[str, Any]] = None,
     timeout: Optional[float] = None,
     preserve_session: bool = False,
+    preserve_session_id: bool = False,
 ) -> Tool[AgentToolInput, Ctx]:
     """
     Create a tool from an agent.
@@ -91,6 +92,10 @@ def create_agent_tool(
         is_enabled: Whether the tool is enabled (bool, sync function, or async function)
         metadata: Optional metadata for the tool
         timeout: Optional timeout for tool execution
+        preserve_session: When True, inherit parent's conversation_id AND memory (shared session)
+        preserve_session_id: When True, inherit ONLY parent's conversation_id for tracing (no memory).
+                            This allows subagent traces to appear together in Langfuse without
+                            loading previous invocation history. Mutually exclusive with preserve_session.
 
     Returns:
         A Tool that wraps the agent execution
@@ -242,6 +247,24 @@ def create_agent_tool(
             subagent_model_override = parent_config.model_override
             subagent_model_provider = parent_config.model_provider
         
+        # Determine conversation_id and memory inheritance based on session preservation settings:
+        # - preserve_session=True: inherit both conversation_id AND memory (full shared session)
+        # - preserve_session_id=True: inherit ONLY conversation_id for tracing (no memory, stateless calls)
+        # - Both False: completely ephemeral sub-agent run
+        #
+        # preserve_session_id is useful when you want:
+        # 1. Subagent traces to appear together in Langfuse under the same conversation
+        # 2. But each subagent invocation to be stateless (no accumulated history from previous calls)
+        if preserve_session:
+            subagent_memory = parent_config.memory
+            subagent_conversation_id = parent_config.conversation_id
+        elif preserve_session_id:
+            subagent_memory = None  # No memory inheritance - stateless
+            subagent_conversation_id = parent_config.conversation_id  # Only for tracing
+        else:
+            subagent_memory = None
+            subagent_conversation_id = None
+        
         sub_config = RunConfig(
             agent_registry={agent.name: agent, **parent_config.agent_registry},
             model_provider=subagent_model_provider,
@@ -252,8 +275,8 @@ def create_agent_tool(
             on_event=parent_config.on_event,
             before_llm_call=parent_config.before_llm_call,
             after_llm_call=parent_config.after_llm_call,
-            memory=parent_config.memory if preserve_session else None,
-            conversation_id=parent_config.conversation_id if preserve_session else None,
+            memory=subagent_memory,
+            conversation_id=subagent_conversation_id,
             default_tool_timeout=parent_config.default_tool_timeout,
             prefer_streaming=parent_config.prefer_streaming,
         )

jaf/core/tracing.py

@@ -469,7 +469,7 @@ class LangfuseTraceCollector:
             public_key=public_key,
             secret_key=secret_key,
             host=host,
-            release="jaf-py-v2.6.5",
+            release="jaf-py-v2.6.7",
             httpx_client=client,
         )
         self._httpx_client = client

jaf/core/types.py

@@ -428,6 +428,7 @@ class Agent(Generic[Ctx, Out]):
         metadata: Optional[Dict[str, Any]] = None,
         timeout: Optional[float] = None,
         preserve_session: bool = False,
+        preserve_session_id: bool = False,
     ) -> Tool[Any, Ctx]:
         """
         Convert this agent into a tool that can be used by other agents.
@@ -440,6 +441,11 @@ class Agent(Generic[Ctx, Out]):
             is_enabled: Whether the tool is enabled (bool, sync function, or async function)
             metadata: Optional metadata for the tool
             timeout: Optional timeout for the tool execution
+            preserve_session: When True, inherit parent's conversation_id AND memory (shared session)
+            preserve_session_id: When True, inherit ONLY parent's conversation_id for tracing (no memory).
+                                This allows subagent traces to appear together in Langfuse without
+                                loading previous invocation history. Useful for stateless subagent calls
+                                that should still be grouped together in traces.
 
         Returns:
             A Tool that wraps this agent's execution
@@ -456,6 +462,7 @@ class Agent(Generic[Ctx, Out]):
             metadata=metadata,
             timeout=timeout,
             preserve_session=preserve_session,
+            preserve_session_id=preserve_session_id,
         )
 
 

jaf/providers/model.py

@@ -378,6 +378,10 @@ def make_litellm_provider(
                 # Prepare request parameters
                 request_params = {"model": model_name, "messages": messages, "stream": False}
 
+                # Add session_id from conversation_id for LiteLLM tracking
+                if config.conversation_id:
+                    request_params["extra_body"] = {"session_id": config.conversation_id}
+
                 # Add optional parameters
                 if agent.model_config:
                     if agent.model_config.temperature is not None:
@@ -620,6 +624,10 @@ def make_litellm_provider(
                 "messages": messages,
             }
 
+            # Add session_id from conversation_id for LiteLLM tracking
+            if config.conversation_id:
+                request_params["extra_body"] = {"session_id": config.conversation_id}
+
             # Add optional parameters
             if agent.model_config:
                 if agent.model_config.temperature is not None:
@@ -827,6 +835,10 @@ def make_litellm_sdk_provider(
             # Prepare request parameters for LiteLLM
             request_params = {"model": model_name, "messages": messages, **self.litellm_kwargs}
 
+            # Add session_id from conversation_id for LiteLLM tracking
+            if config.conversation_id:
+                request_params["session_id"] = config.conversation_id
+
             # Add API key if provided
             if self.api_key:
                 request_params["api_key"] = self.api_key
@@ -1007,6 +1019,10 @@ def make_litellm_sdk_provider(
                 **self.litellm_kwargs,
             }
 
+            # Add session_id from conversation_id for LiteLLM tracking
+            if config.conversation_id:
+                request_params["session_id"] = config.conversation_id
+
             # Add API key if provided
             if self.api_key:
                 request_params["api_key"] = self.api_key

{jaf_py-2.6.5.dist-info → jaf_py-2.6.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jaf-py
-Version: 2.6.5
+Version: 2.6.7
 Summary: A purely functional agent framework with immutable state and composable tools - Python implementation
 Author: JAF Contributors
 Maintainer: JAF Contributors
@@ -82,7 +82,7 @@ Dynamic: license-file
 
 <!-- ![JAF Banner](docs/cover.png) -->
 
-[![Version](https://img.shields.io/badge/version-2.6.5-blue.svg)](https://github.com/xynehq/jaf-py)
+[![Version](https://img.shields.io/badge/version-2.6.7-blue.svg)](https://github.com/xynehq/jaf-py)
 [![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
 [![Docs](https://img.shields.io/badge/Docs-Live-brightgreen)](https://xynehq.github.io/jaf-py/)
 

{jaf_py-2.6.5.dist-info → jaf_py-2.6.7.dist-info}/RECORD

@@ -1,4 +1,4 @@
-jaf/__init__.py,sha256=clE4UWW2Y5bty2ataCPqnL__bVP8HGO1EBIR1VYI9ZU,8652
+jaf/__init__.py,sha256=nkcZREAFiazg-N4BdAZAWvirwc574BX7FtM4XasfpTM,8652
 jaf/cli.py,sha256=EDMMA5uX0e3TUIedLdyP3p4Qy-aXADvpht3VgJPJagU,8299
 jaf/exceptions.py,sha256=FdLIw7bdCNtBYfqRyJBkRT4Z1vWuvkzrMqFiMAzjL8Y,9158
 jaf/a2a/__init__.py,sha256=r4W-WHZNjoxR8EQ0x41_rY3fl12OH5qcSn0KycXaKKU,7752
@@ -39,7 +39,7 @@ jaf/a2a/tests/test_integration.py,sha256=hfGAtwXOfV9OXrFgS94twMbzxMQ4Vfj0KYoNT5V
 jaf/a2a/tests/test_protocol.py,sha256=3Ov9fTqznDqJLg8PqY2oy9I2Tpvwv_N0aN-rpFpAmjM,22215
 jaf/a2a/tests/test_types.py,sha256=rSUhZmOQcFrgNiEg4hDCZwypj19h6mSamVapWkrzZWc,17329
 jaf/core/__init__.py,sha256=4IqKRspv8gvgAtbmvaMvUgYZB1fSIy3vsyCXkjF8PjU,2013
-jaf/core/agent_tool.py,sha256=bwYQtRK9YfwPM_3s2kjp3Vl-6vR64jUlOnviqM0Z5tM,15411
+jaf/core/agent_tool.py,sha256=l8Dr8-BexrmO3T6o5AymqQbD-nzmF9yP_jyHrSqSDL0,16848
 jaf/core/analytics.py,sha256=ypdhllyOThXZB-TY_eR1t1n2qrnAVN7Ljb8PaOtJft0,23267
 jaf/core/checkpoint.py,sha256=O7mfi7gFOAUgJ3zHzgJsr11uzn-BU-Vj1iKyKjcirMk,8398
 jaf/core/composition.py,sha256=Tj0-FRTVWygmAfsBLld7pnZK4nrGMMBx2YYJW_KQPoo,25393
@@ -56,8 +56,8 @@ jaf/core/state.py,sha256=fdWDc2DQ-o_g_8E4ibg2QM0Vad_XUique3a5iYBwGZo,9516
 jaf/core/streaming.py,sha256=5ntOtJrZVCHuGsygquyCLG2J5yuSxE6DN5OM-BrQiGw,16818
 jaf/core/tool_results.py,sha256=L9U3JDQAjAH5YR7iMpSxfVky2Nxo6FYQs4WE05RATaQ,11283
 jaf/core/tools.py,sha256=rHxzAfGVGpYk3YJKmrq3AQLW0oE3ACkiJBOwle2bLdc,15146
-jaf/core/tracing.py,sha256=p5C7l0X1Is3cNjsINiEsUv01rnUFz9Z0lh4DFWRXsUE,59360
-jaf/core/types.py,sha256=lJXlkL55devvzbc5efT5FdQ_LX3JcsMWA10Hy8Cd5Qs,37015
+jaf/core/tracing.py,sha256=pRenMT87-PlHWNSsuH7gcW6sD7zv-XnOqRkMCk2XQ1s,59360
+jaf/core/types.py,sha256=u93jroIe1fFbRBNpOTBrc3exWrjjvetxsjTtu3jTtVA,37605
 jaf/core/workflows.py,sha256=0825AoD1QwEiGAs5IRlWHmaKrjurx6xF7oDJR6POBsg,25651
 jaf/memory/__init__.py,sha256=YfANOg5vUFSPVG7gpBE4_lYkV5X3_U6Yj9v1_QexfN0,1396
 jaf/memory/approval_storage.py,sha256=DcwtERcoIMH7B-abK9hqND3Moz4zSETsPlgJNkvqcaM,10573
@@ -75,7 +75,7 @@ jaf/policies/handoff.py,sha256=3lPegkSV_2LUf6jEZnj68_g3XUGFB_Fsj1C_6Svr2Kg,8128
 jaf/policies/validation.py,sha256=-zhB5ysH0Y4JnstHzo3I8tt-PFB9FSHBwSUALITBxw4,11016
 jaf/providers/__init__.py,sha256=PfIQkCtXb_yiTEjqs5msGv5-a6De2ujFCEaDGJEe_TQ,2100
 jaf/providers/mcp.py,sha256=fGfrlYx5g7ZX1fBUkPmAYSePKrCc4pG_HKngV_QCdRU,13148
-jaf/providers/model.py,sha256=FCnenKOLwh5JJ8hcXy7pemJb32EO0uvoww5ZTqd4mlE,58619
+jaf/providers/model.py,sha256=LmZMEozLP3EpnESD5Bhgf31427jEVVzA-dCbkaBK8lM,59387
 jaf/server/__init__.py,sha256=cYqdruJCJ3W1AMmmxMjAnDlj9gh3XbHhtegjq4nYRNY,391
 jaf/server/main.py,sha256=usdCRZfDP3GWQchh1o2tHd4KqTTFyQQCD9w4khd9rSo,2113
 jaf/server/server.py,sha256=ZhZ2gmY10eQNaKUlE7ecMkrwMkYkAh-QgKdUJ2q7ktM,51532
@@ -89,9 +89,9 @@ jaf/visualization/functional_core.py,sha256=0Xs2R8ELADKNIgokcbjuxmWwxEyCH1yXIEdG
 jaf/visualization/graphviz.py,sha256=EwWVIRv8Z7gTiO5Spvcm-z_UUQ1oWNPRgdE33ZzFwx8,11569
 jaf/visualization/imperative_shell.py,sha256=N5lWzOLMIU_iCoy3n5WCg49eec8VxV8f7JIG6_wNtVw,2506
 jaf/visualization/types.py,sha256=90G8oClsFa_APqTuMrTW6KjD0oG9I4kVur773dXNW0E,1393
-jaf_py-2.6.5.dist-info/licenses/LICENSE,sha256=LXUQBJxdyr-7C4bk9cQBwvsF_xwA-UVstDTKabpcjlI,1063
-jaf_py-2.6.5.dist-info/METADATA,sha256=sacV8SfppPc9buMj-yoaNvDqrtF7S-k9P51zRZqp6ls,27743
-jaf_py-2.6.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-jaf_py-2.6.5.dist-info/entry_points.txt,sha256=OtIJeNJpb24kgGrqRx9szGgDx1vL9ayq8uHErmu7U5w,41
-jaf_py-2.6.5.dist-info/top_level.txt,sha256=Xu1RZbGaM4_yQX7bpalo881hg7N_dybaOW282F15ruE,4
-jaf_py-2.6.5.dist-info/RECORD,,
+jaf_py-2.6.7.dist-info/licenses/LICENSE,sha256=LXUQBJxdyr-7C4bk9cQBwvsF_xwA-UVstDTKabpcjlI,1063
+jaf_py-2.6.7.dist-info/METADATA,sha256=ZBxUFxg-O8CN9xh_WtdDJsOfwduKX9GoEoSCVMq8mIY,27743
+jaf_py-2.6.7.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+jaf_py-2.6.7.dist-info/entry_points.txt,sha256=OtIJeNJpb24kgGrqRx9szGgDx1vL9ayq8uHErmu7U5w,41
+jaf_py-2.6.7.dist-info/top_level.txt,sha256=Xu1RZbGaM4_yQX7bpalo881hg7N_dybaOW282F15ruE,4
+jaf_py-2.6.7.dist-info/RECORD,,

{jaf_py-2.6.5.dist-info → jaf_py-2.6.7.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.1)
 Root-Is-Purelib: true
 Tag: py3-none-any