livellm 1.4.5__tar.gz → 1.5.1__tar.gz

{livellm-1.4.5 → livellm-1.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: livellm
-Version: 1.4.5
+Version: 1.5.1
 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 → livellm-1.5.1}/README.md

@@ -230,6 +230,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
@@ -530,10 +575,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?)`
@@ -549,7 +596,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 → livellm-1.5.1}/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-1.4.5 → livellm-1.5.1}/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-1.4.5 → livellm-1.5.1}/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-1.4.5 → livellm-1.5.1}/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 → livellm-1.5.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "livellm"
-version = "1.4.5"
+version = "1.5.1"
 description = "Python client for the LiveLLM Server"
 readme = "README.md"
 requires-python = ">=3.10"