jaf-py 2.6.5__tar.gz → 2.6.6__tar.gz

{jaf_py-2.6.5 → jaf_py-2.6.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jaf-py
-Version: 2.6.5
+Version: 2.6.6
 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.6-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 → jaf_py-2.6.6}/README.md

@@ -2,7 +2,7 @@
 
 <!-- ![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.6-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 → jaf_py-2.6.6}/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.6"
 __all__ = [
     # Core types and functions
     "TraceId",

{jaf_py-2.6.5 → jaf_py-2.6.6}/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_py-2.6.5 → jaf_py-2.6.6}/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.6",
             httpx_client=client,
         )
         self._httpx_client = client

{jaf_py-2.6.5 → jaf_py-2.6.6}/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_py-2.6.5 → jaf_py-2.6.6}/jaf_py.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jaf-py
-Version: 2.6.5
+Version: 2.6.6
 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.6-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 → jaf_py-2.6.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "jaf-py"
-version = "2.6.5"
+version = "2.6.6"
 description = "A purely functional agent framework with immutable state and composable tools - Python implementation"
 readme = "README.md"
 license = "MIT"