> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upsonic.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversation Memory

> Store complete chat history for maintaining context

## Overview

Conversation Memory persists the complete chat history for a session, enabling agents to reference previous messages and maintain context across interactions.

## Save vs Load

| Flag                       | Purpose                                                                                   |
| -------------------------- | ----------------------------------------------------------------------------------------- |
| `full_session_memory`      | **Save**: Persist raw messages to storage                                                 |
| `load_full_session_memory` | **Load**: Inject message history into subsequent runs (defaults to `full_session_memory`) |

You can save history without injecting it — useful when pairing with summary memory to reduce token usage while keeping a full audit trail.

## Basic Usage

```python theme={null}
from upsonic import Agent, Task
from upsonic.storage.memory import Memory
from upsonic.storage.sqlite import SqliteStorage

storage = SqliteStorage(db_file="chat.db")

memory = Memory(
    storage=storage,
    session_id="session_001",
    full_session_memory=True
)

agent = Agent("anthropic/claude-sonnet-4-5", memory=memory)

result1 = agent.do(Task("My name is Alice"))
result2 = agent.do(Task("What's my name?"))
print(result2)  # "Your name is Alice"
```

## Save-Only Mode

Save full history for auditing but don't inject it into context:

```python theme={null}
from upsonic import Agent, Task
from upsonic.storage.memory import Memory
from upsonic.storage.sqlite import SqliteStorage

storage = SqliteStorage(db_file="audit.db")

memory = Memory(
    storage=storage,
    session_id="session_001",
    full_session_memory=True,         # Save raw history
    load_full_session_memory=False,   # Don't inject into context
    summary_memory=True,              # Use summary for context instead
    load_summary_memory=True,
    model="anthropic/claude-sonnet-4-5"
)

agent = Agent("anthropic/claude-sonnet-4-5", memory=memory)

result = agent.do(Task("Continue our discussion"))
print(result)
```

## With Message Limiting

Control memory size by limiting to the last N conversation turns:

```python theme={null}
from upsonic import Agent, Task
from upsonic.storage.memory import Memory
from upsonic.storage.sqlite import SqliteStorage

storage = SqliteStorage(db_file="limited.db")

memory = Memory(
    storage=storage,
    session_id="session_001",
    full_session_memory=True,
    num_last_messages=10  # Keep last 10 turns only
)

agent = Agent("anthropic/claude-sonnet-4-5", memory=memory)

result = agent.do(Task("Let's continue our discussion"))
print(result)
```

## With Tool Call Results

Include tool execution results in the conversation history:

```python theme={null}
from upsonic import Agent, Task
from upsonic.storage.memory import Memory
from upsonic.storage.sqlite import SqliteStorage
from upsonic.tools import tool

@tool
def get_weather(city: str) -> str:
    """Get weather for a city."""
    return f"Weather in {city}: 72°F, Sunny"

storage = SqliteStorage(db_file="tools.db")

memory = Memory(
    storage=storage,
    session_id="session_001",
    full_session_memory=True,
    feed_tool_call_results=True  # Include tool outputs in history
)

agent = Agent("anthropic/claude-sonnet-4-5", tools=[get_weather], memory=memory)

result1 = agent.do(Task("What's the weather in NYC?"))
result2 = agent.do(Task("What was the weather you just told me?"))
print(result2)  # Can reference previous tool results
```

## Parameters

| Parameter                  | Type           | Default        | Description                                                  |
| -------------------------- | -------------- | -------------- | ------------------------------------------------------------ |
| `full_session_memory`      | `bool`         | `False`        | Save conversation history                                    |
| `load_full_session_memory` | `bool \| None` | `None`         | Inject history into runs (defaults to `full_session_memory`) |
| `session_id`               | `str`          | auto-generated | Session identifier                                           |
| `num_last_messages`        | `int \| None`  | `None`         | Limit to last N turns                                        |
| `feed_tool_call_results`   | `bool`         | `False`        | Include tool outputs                                         |