livellm 1.4.5__py3-none-any.whl → 1.5.2__py3-none-any.whl

livellm/livellm.py

@@ -36,6 +36,7 @@ class BaseLivellmClient(ABC):
         model: str,
         messages: list,
         tools: Optional[list] = None,
+        include_history: bool = False,
         **kwargs
     ) -> AgentResponse:
         ...
@@ -53,6 +54,7 @@ class BaseLivellmClient(ABC):
         model: Optional[str] = None,
         messages: Optional[list] = None,
         tools: Optional[list] = None,
+        include_history: bool = False,
         **kwargs
     ) -> AgentResponse:
         """
@@ -69,7 +71,8 @@ class BaseLivellmClient(ABC):
                provider_uid="...",
                model="gpt-4",
                messages=[TextMessage(...)],
-               tools=[]
+               tools=[],
+               include_history=False
            )
         
         Args:
@@ -79,6 +82,7 @@ class BaseLivellmClient(ABC):
             messages: List of messages
             tools: Optional list of tools
             gen_config: Optional generation configuration
+            include_history: Whether to include full conversation history in the response
             
         Returns:
             AgentResponse with the agent's output
@@ -103,7 +107,8 @@ class BaseLivellmClient(ABC):
             model=model,
             messages=messages,
             tools=tools or [],
-            gen_config=kwargs or None
+            gen_config=kwargs or None,
+            include_history=include_history
         )
         return await self.handle_agent_run(agent_request)
     
@@ -122,6 +127,7 @@ class BaseLivellmClient(ABC):
         model: str,
         messages: list,
         tools: Optional[list] = None,
+        include_history: bool = False,
         **kwargs
     ) -> AsyncIterator[AgentResponse]:
         ...
@@ -139,6 +145,7 @@ class BaseLivellmClient(ABC):
         model: Optional[str] = None,
         messages: Optional[list] = None,
         tools: Optional[list] = None,
+        include_history: bool = False,
         **kwargs
     ) -> AsyncIterator[AgentResponse]:
         """
@@ -157,7 +164,8 @@ class BaseLivellmClient(ABC):
                provider_uid="...",
                model="gpt-4",
                messages=[TextMessage(...)],
-               tools=[]
+               tools=[],
+               include_history=False
            ):
                ...
         
@@ -168,6 +176,7 @@ class BaseLivellmClient(ABC):
             messages: List of messages
             tools: Optional list of tools
             gen_config: Optional generation configuration
+            include_history: Whether to include full conversation history in the response
             
         Returns:
             AsyncIterator of AgentResponse chunks
@@ -192,7 +201,8 @@ class BaseLivellmClient(ABC):
                 model=model,
                 messages=messages,
                 tools=tools or [],
-                gen_config=kwargs or None
+                gen_config=kwargs or None,
+                include_history=include_history
             )
             stream = self.handle_agent_run_stream(agent_request)
         

livellm/models/__init__.py

@@ -1,7 +1,7 @@
 from .common import BaseRequest, ProviderKind, Settings, SuccessResponse
 from .fallback import AgentFallbackRequest, AudioFallbackRequest, TranscribeFallbackRequest, FallbackStrategy
 from .agent.agent import AgentRequest, AgentResponse, AgentResponseUsage
-from .agent.chat import Message, MessageRole, TextMessage, BinaryMessage
+from .agent.chat import Message, MessageRole, TextMessage, BinaryMessage, ToolCallMessage, ToolReturnMessage
 from .agent.tools import Tool, ToolInput, ToolKind, WebSearchInput, MCPStreamableServerInput
 from .audio.speak import SpeakMimeType, SpeakRequest, SpeakStreamResponse
 from .audio.transcribe import TranscribeRequest, TranscribeResponse, File
@@ -27,6 +27,8 @@ __all__ = [
     "MessageRole",
     "TextMessage",
     "BinaryMessage",
+    "ToolCallMessage",
+    "ToolReturnMessage",
     "Tool",
     "ToolInput",
     "ToolKind",

livellm/models/agent/__init__.py

@@ -1,5 +1,5 @@
 from .agent import AgentRequest, AgentResponse, AgentResponseUsage
-from .chat import Message, MessageRole, TextMessage, BinaryMessage
+from .chat import Message, MessageRole, TextMessage, BinaryMessage, ToolCallMessage, ToolReturnMessage
 from .tools import Tool, ToolInput, ToolKind, WebSearchInput, MCPStreamableServerInput
 
 
@@ -11,6 +11,8 @@ __all__ = [
     "MessageRole",
     "TextMessage",
     "BinaryMessage",
+    "ToolCallMessage",
+    "ToolReturnMessage",
     "Tool",
     "ToolInput",
     "ToolKind",

livellm/models/agent/agent.py

@@ -2,7 +2,7 @@
 
 from pydantic import BaseModel, Field, field_validator
 from typing import Optional, List, Union
-from .chat import TextMessage, BinaryMessage
+from .chat import TextMessage, BinaryMessage, ToolCallMessage, ToolReturnMessage
 from .tools import WebSearchInput, MCPStreamableServerInput
 from ..common import BaseRequest
 
@@ -12,6 +12,7 @@ class AgentRequest(BaseRequest):
     messages: List[Union[TextMessage, BinaryMessage]] = Field(..., description="The messages to use")
     tools: List[Union[WebSearchInput, MCPStreamableServerInput]] = Field(default_factory=list, description="The tools to use")
     gen_config: Optional[dict] = Field(default=None, description="The configuration for the generation")
+    include_history: bool = Field(default=False, description="Whether to include full conversation history in the response")
 
 class AgentResponseUsage(BaseModel):
     input_tokens: int = Field(..., description="The number of input tokens used")
@@ -19,4 +20,5 @@ class AgentResponseUsage(BaseModel):
 
 class AgentResponse(BaseModel):
     output: str = Field(..., description="The output of the response")
-    usage: AgentResponseUsage = Field(..., description="The usage of the response")
+    usage: AgentResponseUsage = Field(..., description="The usage of the response")
+    history: Optional[List[Union[TextMessage, BinaryMessage, ToolCallMessage, ToolReturnMessage]]] = Field(default=None, description="Full conversation history including tool calls and returns (only included when include_history=true)")

livellm/models/agent/chat.py

@@ -7,6 +7,8 @@ class MessageRole(str, Enum):
     USER = "user"
     MODEL = "model"
     SYSTEM = "system"
+    TOOL_CALL = "tool_call"
+    TOOL_RETURN = "tool_return"
 
 
 class Message(BaseModel):
@@ -27,3 +29,13 @@ class BinaryMessage(Message):
             raise ValueError("MIME type are meant for user messages only")
         return self
 
+class ToolCallMessage(Message):
+    """Message representing a tool call made by the agent"""
+    tool_name: str = Field(..., description="The name of the tool being called")
+    args: dict = Field(..., description="The arguments passed to the tool")
+
+class ToolReturnMessage(Message):
+    """Message representing the return value from a tool call"""
+    tool_name: str = Field(..., description="The name of the tool that was called")
+    content: str = Field(..., description="The return value from the tool")
+

{livellm-1.4.5.dist-info → livellm-1.5.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: livellm
-Version: 1.4.5
+Version: 1.5.2
 Summary: Python client for the LiveLLM Server
 Project-URL: Homepage, https://github.com/qalby-tech/livellm-client-py
 Project-URL: Repository, https://github.com/qalby-tech/livellm-client-py
@@ -257,6 +257,51 @@ response = await client.agent_run(
 )
 ```
 
+#### Agent with Conversation History
+
+You can request the full conversation history (including tool calls and returns) by setting `include_history=True`:
+
+```python
+from livellm.models import TextMessage, ToolCallMessage, ToolReturnMessage
+
+# Request with history enabled
+response = await client.agent_run(
+    provider_uid="openai",
+    model="gpt-4",
+    messages=[TextMessage(role="user", content="Search for latest AI news")],
+    tools=[WebSearchInput(kind=ToolKind.WEB_SEARCH)],
+    include_history=True  # Enable history in response
+)
+
+print(f"Output: {response.output}")
+
+# Access full conversation history including tool interactions
+if response.history:
+    for msg in response.history:
+        if isinstance(msg, TextMessage):
+            print(f"{msg.role}: {msg.content}")
+        elif isinstance(msg, ToolCallMessage):
+            print(f"Tool Call: {msg.tool_name}({msg.args})")
+        elif isinstance(msg, ToolReturnMessage):
+            print(f"Tool Return from {msg.tool_name}: {msg.content}")
+```
+
+**History Message Types:**
+- `TextMessage` - Regular text messages (user, model, system)
+- `BinaryMessage` - Images or other binary content
+- `ToolCallMessage` - Tool invocations made by the agent
+  - `tool_name` - Name of the tool called
+  - `args` - Arguments passed to the tool
+- `ToolReturnMessage` - Results returned from tool calls
+  - `tool_name` - Name of the tool that was called
+  - `content` - The return value from the tool
+
+**Use cases:**
+- Debugging tool interactions
+- Maintaining conversation state across multiple requests
+- Auditing and logging complete conversations
+- Building conversational UIs with full context visibility
+
 ### Audio Services
 
 #### Text-to-Speech
@@ -557,10 +602,12 @@ response = await client.ping()
 **Messages**
 - `TextMessage(role, content)` - Text message
 - `BinaryMessage(role, content, mime_type, caption?)` - Image/audio message
-- `MessageRole` - `USER` | `MODEL` | `SYSTEM` (or use strings: `"user"`, `"model"`, `"system"`)
+- `ToolCallMessage(role, tool_name, args)` - Tool invocation by agent
+- `ToolReturnMessage(role, tool_name, content)` - Tool execution result
+- `MessageRole` - `USER` | `MODEL` | `SYSTEM` | `TOOL_CALL` | `TOOL_RETURN` (or use strings)
 
 **Requests**
-- `AgentRequest(provider_uid, model, messages, tools?, gen_config?)`
+- `AgentRequest(provider_uid, model, messages, tools?, gen_config?, include_history?)` - Set `include_history=True` to get full conversation
 - `SpeakRequest(provider_uid, model, text, voice, mime_type, sample_rate, gen_config?)`
 - `TranscribeRequest(provider_uid, file, model, language?, gen_config?)`
 - `TranscriptionInitWsRequest(provider_uid, model, language?, input_sample_rate?, input_audio_format?, gen_config?)`
@@ -576,7 +623,7 @@ response = await client.ping()
 - `FallbackStrategy` - `SEQUENTIAL` | `PARALLEL`
 
 **Responses**
-- `AgentResponse(output, usage{input_tokens, output_tokens}, ...)`
+- `AgentResponse(output, usage{input_tokens, output_tokens}, history?)` - `history` included when `include_history=True`
 - `TranscribeResponse(text, language)`
 - `TranscriptionWsResponse(transcription, is_end)` - Real-time transcription result
 

{livellm-1.4.5.dist-info → livellm-1.5.2.dist-info}/RECORD

@@ -1,20 +1,20 @@
 livellm/__init__.py,sha256=p2Szx7PELGYi-PTnSNnRPGVbU438ZBTFXYAQoMToUfE,440
-livellm/livellm.py,sha256=McMt9OSME0Sr7NGpwqyr_VGEpXv4XcVb1EP-BwOuK0A,34092
+livellm/livellm.py,sha256=d-1PlWKtMkw44575KZlhRr-c7p0B34W78F4PS_rhwUA,34598
 livellm/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 livellm/transcripton.py,sha256=WtL2PEFEVQ3RP2WOyjXqQFziQWKJvzJbG3T5cqfJ5qc,4187
-livellm/models/__init__.py,sha256=tCX_Q3ALjO0jbqhLFsVoITSm1AV--3pF5ZZc_l0VC1o,1447
+livellm/models/__init__.py,sha256=4w8yDf_79kNwBfct-jHjAPNPxz4nFzMSWqlIo_7MFwc,1531
 livellm/models/common.py,sha256=nx0w7Th9xeHeQg6Ssxi7jEEh3aEcGyzGAP0uk9l072c,1772
 livellm/models/fallback.py,sha256=zGG_MjdbaTx0fqKZTEg3ullej-CJznPfwaon0jEvRvI,1170
 livellm/models/transcription.py,sha256=LQG5u7hgXuw6WyCxS-us0VGh9eky-f16JPpeT3jHULc,1608
 livellm/models/ws.py,sha256=OCoJwAjQLOz6ErTiTtb-qD22N4wSsEGvi_4JQqCHIPQ,1111
-livellm/models/agent/__init__.py,sha256=KVm6AgQoWEaoq47QAG4Ou4NimoXOTkjXC-0-gnMRLZ8,476
-livellm/models/agent/agent.py,sha256=-UcGv5Bzw5ALmWX4lIqpbWqMVjCsjBc0KIE6_JKbCXM,1106
-livellm/models/agent/chat.py,sha256=zGfeEHx0luwq23pqWF1megcuEDUl6IhV4keLJeZry_A,1028
+livellm/models/agent/__init__.py,sha256=CvP3xzDAiBZ4giQZUBQsqAJd1rWO4cvHhqr2Oh346A0,560
+livellm/models/agent/agent.py,sha256=qndsqcnX0MqbnblOA3niUWpU9873FU-PIH0vZkPoqAU,1504
+livellm/models/agent/chat.py,sha256=WOs5h-D7hNsnucw6rxQkDCdHH2R5kiEe5kcmh25ivMU,1599
 livellm/models/agent/tools.py,sha256=wVWfx6_jxL3IcmX_Nt_PonZ3RQLtpfqJnszHz32BQiU,1403
 livellm/models/audio/__init__.py,sha256=sz2NxCOfFGVvp-XQUsdgOR_TYBO1Wb-8LLXaZDEiAZk,282
 livellm/models/audio/speak.py,sha256=lDITZ7fiLRuDhA-LxCPQ6Yraxr33B6Lg7VyR4CkuGk8,1872
 livellm/models/audio/transcribe.py,sha256=Leji2lk5zfq4GE-fw-z2dZR8BuijzW8TJ12GHw_UZJY,2085
-livellm-1.4.5.dist-info/METADATA,sha256=F7TfOu8TBhFuDXzwfRxWqerIvXYcS_irHy7zoMFaZ0A,18735
-livellm-1.4.5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-livellm-1.4.5.dist-info/licenses/LICENSE,sha256=yapGO2C_00ymEx6TADdbU8Oyc1bWOrZY-fjP-agmFL4,1071
-livellm-1.4.5.dist-info/RECORD,,
+livellm-1.5.2.dist-info/METADATA,sha256=hg26D85D8M3JpnzeIW-Y-Ey3SkQz9yv9P_7FmzirfH4,20664
+livellm-1.5.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+livellm-1.5.2.dist-info/licenses/LICENSE,sha256=yapGO2C_00ymEx6TADdbU8Oyc1bWOrZY-fjP-agmFL4,1071
+livellm-1.5.2.dist-info/RECORD,,