Breaking Changes in v1.0.0

# This was supported in v0.x
config = {
    "version": "v1.0"  # ❌ No longer supported
}

result = m.add(
    "memory content",
    user_id="alice"
)

# v1.1 is the minimum supported version
config = {
    "version": "v1.1"  # ✅ Required minimum
}

result = m.add(
    "memory content",
    user_id="alice"
)

ValueError: The v1.0 API format is no longer supported in mem0ai 1.0.0+.
Please use v1.1 format which returns a dict with 'results' key.

result = m.add("content", user_id="alice", version="v1.0")

result = m.add("content", user_id="alice")

from mem0 import MemoryClient

client = MemoryClient(api_key="your-key")
result = client.add("content", user_id="alice", async_mode=True)
result = client.add("content", user_id="alice", async_mode=False)

from mem0 import MemoryClient

client = MemoryClient(api_key="your-key")

# async_mode now defaults to True, but you can still override it
result = client.add("content", user_id="alice")  # Uses async_mode=True by default

# You can still explicitly set it to False if needed
result = client.add("content", user_id="alice", async_mode=False)

# Could return different formats based on version configuration
result = m.add("content", user_id="alice")
# With v1.0: Returns [{"id": "...", "memory": "...", "event": "ADD"}]
# With v1.1: Returns {"results": [{"id": "...", "memory": "...", "event": "ADD"}]}

# Always returns standardized format
result = m.add("content", user_id="alice")
# Always returns: {"results": [{"id": "...", "memory": "...", "event": "ADD"}]}

# Access results consistently
for memory in result["results"]:
    print(memory["memory"])

# v1.0 was supported
config = {
    "version": "v1.0"  # ❌ No longer supported
}

# v1.1 is minimum, v1.1 is default
config = {
    "version": "v1.1"  # ✅ Minimum supported
}

# Or omit for default
config = {
    # version defaults to v1.1
}

from mem0 import Memory

# Default configuration in v0.x
m = Memory()  # Used default settings suitable for v0.x

from mem0 import Memory

# Default configuration optimized for v1.0.0 
m = Memory()  # Uses v1.1+ optimized defaults

# Explicit configuration recommended
config = {
    "version": "v1.1",
    "vector_store": {
        "provider": "qdrant",
        "config": {
            "host": "localhost",
            "port": 6333
        }
    }
}
m = Memory.from_config(config)

results = m.search(
    "query",
    user_id="alice",
    filters={"key": "value"}  # Simple key-value only
)

# Basic usage remains the same
results = m.search("query", user_id="alice")

# Enhanced filtering available (optional)
results = m.search(
    "query",
    user_id="alice",
    filters={
        "AND": [
            {"key": "value"},
            {"score": {"gte": 0.8}}
        ]
    },
    rerank=True  # New parameter
)

try:
    result = m.add("content", user_id="alice", version="v1.0")
except Exception as e:
    print(f"Generic error: {e}")

try:
    result = m.add("content", user_id="alice")
except ValueError as e:
    if "v1.0 API format is no longer supported" in str(e):
        # Handle version error specifically
        print("Please upgrade your code to use v1.1+ format")
    else:
        print(f"Value error: {e}")
except Exception as e:
    print(f"Unexpected error: {e}")

# Some invalid parameters might have been ignored
result = m.add(
    "content",
    user_id="alice",
    invalid_param="ignored"  # Might have been silently ignored
)

# Strict validation - unknown parameters cause errors
try:
    result = m.add(
        "content",
        user_id="alice",
        invalid_param="value"  # ❌ Will raise TypeError
    )
except TypeError as e:
    print(f"Invalid parameter: {e}")

# These imports work in both v0.x and v1.0.0 
from mem0 import Memory, AsyncMemory
from mem0 import MemoryConfig

# Check for conflicts after upgrade
pip install --upgrade mem0ai
pip check  # Verify no dependency conflicts

def test_add_memory():
    result = m.add("content", user_id="alice")
    assert isinstance(result, list)  # ❌ No longer true
    assert len(result) > 0

def test_add_memory():
    result = m.add("content", user_id="alice")
    assert isinstance(result, dict)  # ✅ Always dict
    assert "results" in result       # ✅ Always has results key
    assert len(result["results"]) > 0

# 1. Rollback package
pip install mem0ai==0.1.20  # Last stable v0.x

# 2. Revert code changes
git checkout previous_commit

# 3. Test functionality
python test_mem0_functionality.py