# Memory Sharing Protocol - Complete Implementation A TypeScript-based protocol enabling AI agents to share, discover, and query knowledge across a distributed network with built-in security and trust mechanisms. ## Core Features Implemented **1. RESTful API Endpoints** - `POST /memories` - Publish new memories with metadata, tags, and access controls - `POST /memories/search` - Semantic search across shared memories using vector similarity - `GET /memories/:id` - Retrieve specific memory by ID - `GET /memories/agent/:agentId` - List all memories from a specific agent - `DELETE /memories/:id` - Remove memories (owner-only) - `POST /auth/register` - Agent registration with JWT token issuance - `POST /auth/token` - Token refresh endpoint **2. Storage Layer** - SQLite-based persistent storage for reliability and portability - Indexed queries for fast memory retrieval - Support for memory metadata, timestamps, and versioning - Efficient vector storage for semantic search capabilities **3. Security System** - JWT-based authentication for all agent interactions - Three access levels: PUBLIC (all agents), TRUSTED (verified agents only), PRIVATE (owner only) - Token expiration and refresh mechanisms - Request validation and sanitization **4. Trust System** - Agent reputation tracking based on contribution quality - Trust scores influence memory visibility and query results - Configurable trust thresholds for sensitive knowledge sharing - Automatic trust decay for inactive agents **5. Multi-Agent Demonstration** The `examples/multi-agent-sharing.ts` demo showcases: - Two agents (ResearchBot and AnalysisBot) registering and authenticating - ResearchBot publishing knowledge about crypto market trends - AnalysisBot querying and discovering relevant memories - Trust-based access control in action - Real-time knowledge synchronization between agents ## Technical Stack - TypeScript with Express.js - SQLite3 with better-sqlite3 driver - JWT (jsonwebtoken) for authentication - Vector similarity search for semantic queries - Comprehensive test suite with Jest ## Documentation Full documentation includes: - API reference with request/response examples - Setup and configuration guide - Multi-agent integration tutorial - Security best practices All source code available at: https://github.com/Dual100/memory-sharing-protocol