mirror of
https://github.com/supermemoryai/supermemory.git
synced 2026-05-17 12:20:04 +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 |
||
|---|---|---|
| .. | ||
| .cursor/rules | ||
| add-memories | ||
| ai-sdk | ||
| changelog | ||
| concepts | ||
| connectors | ||
| cookbook | ||
| deployment | ||
| images | ||
| integrations | ||
| list-memories | ||
| logo | ||
| memory-api | ||
| memory-graph | ||
| memory-router | ||
| memorybench | ||
| migration | ||
| model-enhancement | ||
| openai-sdks | ||
| overview | ||
| search | ||
| snippets | ||
| supermemory-mcp | ||
| update-delete-memories | ||
| user-profiles | ||
| .gitignore | ||
| add-memories.mdx | ||
| analytics.mdx | ||
| authentication.mdx | ||
| docs.json | ||
| document-operations.mdx | ||
| favicon.png | ||
| install.md | ||
| intro.mdx | ||
| introduction.mdx | ||
| memory-operations.mdx | ||
| n8n.mdx | ||
| package.json | ||
| quickstart.mdx | ||
| README.md | ||
| search.mdx | ||
| style.css | ||
| test.py | ||
| test.ts | ||
| user-profiles.mdx | ||
| vibe-coding.mdx | ||
| zapier.mdx | ||
