cf-memory-mcp 2.2.0 → 2.3.0

package/README.md

@@ -3,7 +3,18 @@
 [![npm version](https://badge.fury.io/js/cf-memory-mcp.svg)](https://badge.fury.io/js/cf-memory-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-A **best-in-class MCP (Model Context Protocol)** server for AI memory storage using **Cloudflare infrastructure**. This package provides AI coding agents with intelligent memory management featuring **smart auto-features**, **intelligent search**, **memory collections**, and **automated project onboarding workflows**.
+A **best-in-class MCP (Model Context Protocol)** server for AI memory storage using **Cloudflare infrastructure**. This package provides AI coding agents with intelligent memory management featuring **smart auto-features**, **intelligent search**, **memory collections**, **temporal intelligence**, **multi-agent collaboration**, and **advanced analytics**.
+
+## 🎯 Current Version: v2.3.0
+
+**Latest Features:**
+- 🤝 **Multi-Agent Collaboration** - First MCP server with true multi-agent capabilities
+- ⏰ **Temporal Intelligence** - Time-aware memory management and evolution tracking
+- 📊 **Advanced Analytics** - Comprehensive usage and collaboration monitoring
+- 🔄 **Memory Synchronization** - Real-time sync between instances with conflict resolution
+- 📤 **Rich Export/Import** - Multiple formats including graph visualization
+
+**Total Tools Available: 35+** spanning memory management, relationships, temporal intelligence, and collaboration.
 
 ## 🚀 Quick Start
 
@@ -42,6 +53,32 @@ cf-memory-mcp
 - **🚀 Project Onboarding** - Automated workflows for project setup and knowledge extraction
 - **🔄 Query Expansion** - Automatically includes synonyms and related terms
 
+### ⏰ Context-Aware & Temporal Intelligence (v2.2.0)
+
+- **🧠 Conversation Context** - Track and manage conversation-specific memory contexts
+- **⏰ Temporal Relevance** - Time-based memory scoring and decay management
+- **🔄 Memory Evolution** - Version control and evolution tracking for memories
+- **📊 Temporal Analytics** - Analyze how memories and relationships change over time
+- **🎯 Context Activation** - Smart memory activation based on conversation context
+- **📈 Predictive Relevance** - ML-powered predictions for memory importance over time
+
+### 🤝 Multi-Agent Collaboration (v2.3.0)
+
+- **👥 Agent Management** - Register and authenticate multiple AI agents
+- **🏠 Collaborative Spaces** - Shared memory workspaces with permission control
+- **🔐 Access Control** - Fine-grained permissions (read/write/admin) for agents
+- **🔄 Memory Synchronization** - Real-time sync between different instances
+- **⚡ Conflict Resolution** - Smart merge strategies for concurrent edits
+- **📊 Collaboration Analytics** - Track agent interactions and collaboration patterns
+
+### 📤 Advanced Export/Import (v2.3.0)
+
+- **📋 Multi-Format Export** - JSON, XML, Markdown, CSV, GraphML formats
+- **🔄 Batch Operations** - Asynchronous export/import job processing
+- **🕸️ Graph Visualization** - Export memory networks for analysis tools
+- **📦 Rich Metadata** - Full preservation of relationships and collaboration data
+- **🔀 Conflict Handling** - Smart import strategies for existing memories
+
 ### Advanced Features
 
 - **🧠 Semantic Search** - AI-powered vector search using Cloudflare AI Workers
@@ -279,6 +316,243 @@ Smart workflow for automated project onboarding with knowledge extraction.
 
 **Returns:** Complete onboarding results with key concepts, relationship map, knowledge gaps, and documentation suggestions.
 
+## ⏰ Context-Aware & Temporal Intelligence (v2.2.0)
+
+### `create_conversation_context`
+
+Create a new conversation context for tracking related memories.
+
+**Parameters:**
+
+- `context_name` (string, required) - Name for the conversation context
+- `description` (string, optional) - Description of the context
+- `metadata` (object, optional) - Additional context metadata
+
+### `activate_memory_in_context`
+
+Activate a memory within a specific conversation context.
+
+**Parameters:**
+
+- `memory_id` (string, required) - Memory ID to activate
+- `context_id` (string, required) - Context ID to activate memory in
+- `activation_strength` (number, optional) - Strength of activation (0-1)
+
+### `get_context_memories`
+
+Get all memories associated with a conversation context.
+
+**Parameters:**
+
+- `context_id` (string, required) - Context ID to get memories for
+- `include_inactive` (boolean, optional) - Include inactive memories
+- `sort_by_relevance` (boolean, optional) - Sort by temporal relevance
+
+### `evolve_memory`
+
+Create a new version of a memory with evolution tracking.
+
+**Parameters:**
+
+- `memory_id` (string, required) - Original memory ID
+- `new_content` (string, required) - Updated content
+- `evolution_type` (string, required) - Type of evolution (refinement, expansion, correction)
+- `evolution_summary` (string, optional) - Summary of changes
+
+### `analyze_memory_decay`
+
+Analyze temporal decay patterns for memories.
+
+**Parameters:**
+
+- `memory_id` (string, optional) - Specific memory to analyze
+- `time_range_days` (number, optional) - Time range for analysis (default: 30)
+- `include_predictions` (boolean, optional) - Include future decay predictions
+
+### `analyze_temporal_relationships`
+
+Analyze how relationships evolve over time.
+
+**Parameters:**
+
+- `relationship_id` (string, optional) - Specific relationship to analyze
+- `memory_id` (string, optional) - Memory ID to analyze relationships for
+- `time_range_days` (number, optional) - Time range in days (default: 30)
+- `include_predictions` (boolean, optional) - Include future predictions
+
+## 🤝 Multi-Agent Collaboration (v2.3.0)
+
+### `register_agent`
+
+Register a new agent in the system for collaboration.
+
+**Parameters:**
+
+- `name` (string, required) - Agent name
+- `type` (string, required) - Agent type: 'ai_agent', 'human_user', or 'system'
+- `description` (string, optional) - Agent description
+- `capabilities` (array, optional) - Agent capabilities
+- `metadata` (object, optional) - Agent metadata
+
+### `create_memory_space`
+
+Create a collaborative memory space for multi-agent sharing.
+
+**Parameters:**
+
+- `name` (string, required) - Memory space name
+- `description` (string, optional) - Space description
+- `owner_agent_id` (string, required) - Agent ID who owns this space
+- `space_type` (string, optional) - Type: 'private', 'collaborative', or 'public'
+- `access_policy` (string, optional) - Policy: 'open', 'invite_only', or 'restricted'
+
+### `grant_space_permission`
+
+Grant permission to an agent for a memory space.
+
+**Parameters:**
+
+- `space_id` (string, required) - Memory space ID
+- `agent_id` (string, required) - Agent ID to grant permission to
+- `permission_level` (string, required) - Level: 'read', 'write', or 'admin'
+- `granted_by` (string, required) - Agent ID granting the permission
+
+### `add_memory_to_space`
+
+Add a memory to a collaborative space.
+
+**Parameters:**
+
+- `memory_id` (string, required) - Memory ID to add
+- `space_id` (string, required) - Space ID to add memory to
+- `added_by` (string, required) - Agent ID adding the memory
+- `access_level` (string, optional) - Access level for this memory
+
+### `get_agent_spaces`
+
+Get all memory spaces accessible to an agent.
+
+**Parameters:**
+
+- `agent_id` (string, required) - Agent ID to get spaces for
+
+### `get_space_memories`
+
+Get all memories in a space (requires permission).
+
+**Parameters:**
+
+- `space_id` (string, required) - Space ID to get memories from
+- `agent_id` (string, required) - Agent ID requesting access
+
+## 🔄 Memory Synchronization (v2.3.0)
+
+### `sync_memory`
+
+Synchronize a memory with another instance.
+
+**Parameters:**
+
+- `memory_id` (string, required) - Memory ID to synchronize
+- `target_instance` (string, required) - Target instance identifier
+- `force_sync` (boolean, optional) - Force sync even if already synced
+- `conflict_resolution` (string, optional) - Strategy: 'manual', 'auto_merge', 'source_wins', 'target_wins'
+
+### `resolve_sync_conflict`
+
+Resolve a synchronization conflict.
+
+**Parameters:**
+
+- `conflict_id` (string, required) - Conflict ID to resolve
+- `resolution_method` (string, required) - Resolution method
+- `resolved_by` (string, required) - Agent ID resolving the conflict
+- `resolved_version` (object, optional) - Manually resolved version
+
+### `get_sync_status`
+
+Get synchronization status for a memory.
+
+**Parameters:**
+
+- `memory_id` (string, required) - Memory ID to check sync status for
+
+## 📤 Export/Import Operations (v2.3.0)
+
+### `create_export_job`
+
+Create an export job for memories.
+
+**Parameters:**
+
+- `format` (string, required) - Export format: 'json', 'xml', 'markdown', 'csv', 'graphml'
+- `memory_ids` (array, optional) - Specific memory IDs to export
+- `space_ids` (array, optional) - Memory space IDs to export
+- `include_relationships` (boolean, optional) - Include memory relationships
+- `include_metadata` (boolean, optional) - Include full metadata
+- `initiated_by` (string, required) - Agent ID initiating export
+
+### `get_export_job`
+
+Get export job status and download information.
+
+**Parameters:**
+
+- `job_id` (string, required) - Export job ID
+
+### `create_import_job`
+
+Create an import job for memories.
+
+**Parameters:**
+
+- `format` (string, required) - Import format
+- `file_content` (string, required) - File content to import
+- `target_space_id` (string, optional) - Target space to import into
+- `conflict_resolution` (string, optional) - How to handle existing memories
+- `initiated_by` (string, required) - Agent ID initiating import
+
+## 📊 Analytics & Monitoring (v2.3.0)
+
+### `track_memory_analytics`
+
+Track a memory analytics event.
+
+**Parameters:**
+
+- `memory_id` (string, required) - Memory ID
+- `agent_id` (string, required) - Agent ID performing the action
+- `action_type` (string, required) - Action: 'create', 'read', 'update', 'delete', 'search', 'relate'
+- `session_id` (string, optional) - Session identifier
+- `context_data` (object, optional) - Context data about the action
+- `performance_metrics` (object, optional) - Performance metrics
+
+### `get_memory_analytics`
+
+Get memory usage analytics.
+
+**Parameters:**
+
+- `memory_id` (string, optional) - Specific memory ID
+- `agent_id` (string, optional) - Specific agent ID
+- `action_type` (string, optional) - Specific action type
+- `start_date` (string, optional) - Start date for analytics
+- `end_date` (string, optional) - End date for analytics
+- `limit` (number, optional) - Maximum number of results
+
+### `get_collaboration_analytics`
+
+Get collaboration event analytics.
+
+**Parameters:**
+
+- `space_id` (string, optional) - Specific space ID
+- `agent_id` (string, optional) - Specific agent ID
+- `event_type` (string, optional) - Specific event type
+- `start_date` (string, optional) - Start date for analytics
+- `end_date` (string, optional) - End date for analytics
+- `limit` (number, optional) - Maximum number of results
+
 ## 🌐 Architecture
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "cf-memory-mcp",
-	"version": "2.2.0",
+	"version": "2.3.0",
 	"description": "Best-in-class MCP (Model Context Protocol) server for AI memory storage with intelligent search, smart auto-features, memory collections, project onboarding workflows, and advanced lifecycle management",
 	"main": "bin/cf-memory-mcp.js",
 	"bin": {