memtap 2.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 psifactory LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,122 @@
+# MemTap — Graph-Based Agent Memory for OpenClaw
+
+[![npm](https://img.shields.io/npm/v/memtap)](https://www.npmjs.com/package/memtap)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+
+**MemTap** gives your OpenClaw agent a persistent, graph-based long-term memory powered by ArangoDB.
+
+Instead of simple vector recall, MemTap builds a **knowledge graph** — memories are connected through entities, relationships, and temporal context. Your agent remembers facts, tracks decisions, discovers connections through multi-hop graph traversal, and consolidates knowledge over time.
+
+## Quick Start
+
+```bash
+# Install the plugin
+openclaw plugins install memtap
+
+# Sign up and get your API key at https://memtap.ai
+
+# Configure
+openclaw config set plugins.entries.memtap.config.apiKey "mt_live_your_key_here"
+openclaw config set plugins.entries.memtap.config.serverUrl "https://api.memtap.ai"
+
+# Restart gateway
+openclaw gateway restart
+```
+
+That's it. Your agent now has memory.
+
+## What It Does
+
+### 14 Tools
+
+| Tool | Description |
+|------|-------------|
+| `memtap_recall` | Semantic search across the knowledge graph |
+| `memtap_remember` | Store a new memory with auto-extracted entities |
+| `memtap_bulletin` | Context bulletin with graph expansion — agent "knows" related things |
+| `memtap_graphrag` | Multi-hop GraphRAG: vector/BM25 search + graph traversal |
+| `memtap_maintenance` | Memory hygiene: decay reports, contradiction detection, dedup |
+| `memtap_graph` | Graph analysis: overview, gaps, clusters, connections, traverse |
+| `memtap_decide` | Decision tracking: create, list, resolve, defer |
+| `memtap_memory` | CRUD operations on individual memories |
+| `memtap_entities` | Entity management: list, get linked memories, merge duplicates |
+| `memtap_edges` | Create relationships between memories |
+| `memtap_health` | Server health check and memory statistics |
+| `memtap_monitor` | Neural performance monitoring and analytics |
+| `memtap_alerts` | Anomaly detection and alerting system |
+| `memtap_dashboard` | Comprehensive system overview dashboard |
+
+### 5 Hooks
+
+- **Pre-message recall** — Automatically loads relevant context before each conversation turn
+- **Post-message capture** — Extracts and stores important information from conversations
+- **Bootstrap bulletin** — Injects a memory context bulletin when an agent session starts
+- **Periodic consolidation** — Background memory maintenance and knowledge consolidation
+- **Session analytics** — Performance monitoring across sessions
+
+## Configuration
+
+```json5
+{
+  "plugins": {
+    "entries": {
+      "memtap": {
+        "enabled": true,
+        "config": {
+          "serverUrl": "https://api.memtap.ai",
+          "apiKey": "mt_live_...",
+          "agentId": "main",              // optional: scope memories per agent
+          "autoCapture": true,            // auto-extract memories from conversations
+          "bulletinOnBoot": true,         // inject memory context on session start
+          "bulletinTopics": ["projects", "preferences"],
+          "decayRate": 0.005              // memory importance decay per day
+        }
+      }
+    }
+  }
+}
+```
+
+### Optional: Embedding Support
+
+For vector-enhanced GraphRAG search, configure an embedding provider:
+
+```json5
+{
+  "embeddingUrl": "https://api.openai.com/v1/embeddings",
+  "embeddingModel": "text-embedding-3-small",
+  "embeddingApiKey": "sk-..."
+}
+```
+
+## Pricing
+
+| Plan | Price | Memories | Agents | API Calls |
+|------|-------|----------|--------|-----------|
+| Free | $0/mo | 1,000 | 1 | 10,000 |
+| Starter | $13/mo | 50,000 | 3 | 500,000 |
+| Pro | $43/mo | 500,000 | 15 | 5,000,000 |
+| Team | $109/mo | 2,000,000 | Unlimited | 50,000,000 |
+| Enterprise | $1,299/mo | 10,000,000 | Custom | Custom |
+
+Sign up at [memtap.ai](https://memtap.ai) to get your API key.
+
+## Why MemTap?
+
+- **Graph-based**: Full knowledge graph, not just vector similarity
+- **GraphRAG**: Multi-hop traversal discovers connections vector search misses
+- **Decision tracking**: Unique decision management for AI agents
+- **Auto-capture**: Learns from conversations without explicit commands
+- **Memory decay**: Natural forgetting keeps the graph relevant
+- **8x cheaper**: $13/mo vs $99/mo (Mem0, Zep)
+
+## Links
+
+- **Website**: [memtap.ai](https://memtap.ai)
+- **API Docs**: [api.memtap.ai](https://api.memtap.ai)
+- **GitHub**: [github.com/memtap/openclaw-plugin](https://github.com/memtap/openclaw-plugin)
+- **Support**: [github.com/memtap/openclaw-plugin/issues](https://github.com/memtap/openclaw-plugin/issues)
+
+## License
+
+MIT — [psifactory LLC](https://psifactory.io)