mirror of
https://github.com/supermemoryai/supermemory.git
synced 2026-05-17 03:56:18 +00:00
984297b62d
## Summary This PR introduces comprehensive Supermemory integration for the Microsoft Agent Framework, providing three complementary approaches to add persistent memory capabilities to agents: middleware for automatic memory injection, context providers for session-based memory management, and tools for explicit memory operations. ## Key Changes - **SupermemoryChatMiddleware**: Automatic memory injection middleware that fetches relevant memories from Supermemory before LLM calls and optionally saves conversations. Supports three modes: - `"profile"`: Injects all static and dynamic profile memories - `"query"`: Searches for memories relevant to the current user message - `"full"`: Combines both profile and query modes - **SupermemoryContextProvider**: Idiomatic context provider following the Agent Framework pattern (similar to built-in Mem0 integration). Integrates with the session pipeline via `before_run()` and `after_run()` hooks for automatic memory retrieval and storage. - **SupermemoryTools**: FunctionTool-compatible tools that agents can use for explicit memory operations: - `search_memories()`: Search for specific memories - `add_memory()`: Add new memories - `get_profile()`: Retrieve user profile - **Utility Functions**: Helper functions for: - Memory deduplication across static, dynamic, and search result sources - Profile-to-markdown conversion for LLM consumption - Message extraction and conversation formatting - Logging with configurable verbosity - **Exception Hierarchy**: Custom exceptions for better error handling: - `SupermemoryConfigurationError`: Missing/invalid configuration - `SupermemoryAPIError`: API request failures - `SupermemoryNetworkError`: Network connectivity issues - `SupermemoryMemoryOperationError`: Memory operation failures - **Comprehensive Documentation**: README with quick start examples, configuration options, and API reference for all three integration approaches. - **Test Suite**: Unit tests covering middleware, context provider, tools, and utility functions with proper mocking and error scenarios. ## Implementation Details - Supports both async (aiohttp) and sync (requests) HTTP clients with automatic fallback - Handles multiple message formats (dict, objects with attributes, content arrays) - Configurable memory storage with optional conversation grouping via `conversation_id` - Environment variable fallback for API key configuration (`SUPERMEMORY_API_KEY`) - Background task management for non-blocking memory operations in middleware - Proper async/sync compatibility for the Supermemory SDK https://claude.ai/code/session_012idB5y6UGK3zmeFULgTc4z
49 lines
1.6 KiB
Python
49 lines
1.6 KiB
Python
"""Tests for Supermemory tools."""
|
|
|
|
import pytest
|
|
|
|
from supermemory_agent_framework import AgentSupermemory, SupermemoryTools
|
|
|
|
|
|
def _make_conn(**kwargs):
|
|
kwargs.setdefault("api_key", "test-key")
|
|
kwargs.setdefault("container_tag", "msft_agent_chat")
|
|
return AgentSupermemory(**kwargs)
|
|
|
|
|
|
class TestSupermemoryTools:
|
|
def test_create_tools_instance(self) -> None:
|
|
conn = _make_conn()
|
|
tools = SupermemoryTools(conn)
|
|
assert tools._connection.container_tag == "msft_agent_chat"
|
|
|
|
def test_create_tools_with_custom_tag(self) -> None:
|
|
conn = _make_conn(container_tag="custom-tag")
|
|
tools = SupermemoryTools(conn)
|
|
assert tools._connection.container_tag == "custom-tag"
|
|
|
|
def test_get_tools_returns_list(self) -> None:
|
|
conn = _make_conn()
|
|
tools = SupermemoryTools(conn)
|
|
result = tools.get_tools()
|
|
assert isinstance(result, list)
|
|
assert len(result) == 3
|
|
|
|
def test_get_tools_names(self) -> None:
|
|
conn = _make_conn()
|
|
tools = SupermemoryTools(conn)
|
|
result = tools.get_tools()
|
|
names = [t.name for t in result]
|
|
assert "search_memories" in names
|
|
assert "add_memory" in names
|
|
assert "get_profile" in names
|
|
|
|
def test_uses_connection_client(self) -> None:
|
|
conn = _make_conn()
|
|
tools = SupermemoryTools(conn)
|
|
assert tools._client is conn.client
|
|
|
|
def test_shares_custom_id_with_connection(self) -> None:
|
|
conn = _make_conn(conversation_id="conv-123")
|
|
tools = SupermemoryTools(conn)
|
|
assert tools._connection.custom_id == "conversation_conv-123"
|