MemoryOS 2.0.14__tar.gz → 2.0.16__tar.gz

{memoryos-2.0.14 → memoryos-2.0.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: MemoryOS
-Version: 2.0.14
+Version: 2.0.16
 Summary: Intelligence Begins with Memory
 License: Apache-2.0
 License-File: LICENSE
@@ -88,51 +88,24 @@ Description-Content-Type: text/markdown
   </a>
 
   <h1 align="center">
-    <img src="https://statics.memtensor.com.cn/logo/memos_color_m.png" alt="MemOS Logo" width="50"/>
-    MemOS 2.0: 星尘（Stardust）
-    <img src="https://img.shields.io/badge/status-Preview-blue" alt="Preview Badge"/>
+    <img src="https://statics.memtensor.com.cn/logo/memos_color_m.png" alt="MemOS Logo" width="48"/>&nbsp;
+    MemOS 2.0&ensp;Stardust（星尘）
+
   </h1>
 
-  <p>
-    <a href="https://www.memtensor.com.cn/">
-      <img alt="Static Badge" src="https://img.shields.io/badge/Maintained_by-MemTensor-blue">
-    </a>
-    <a href="https://pypi.org/project/MemoryOS">
-      <img src="https://img.shields.io/pypi/v/MemoryOS?label=pypi%20package" alt="PyPI Version">
-    </a>
-    <a href="https://pypi.org/project/MemoryOS">
-      <img src="https://img.shields.io/pypi/pyversions/MemoryOS.svg" alt="Supported Python versions">
-    </a>
-    <a href="https://pypi.org/project/MemoryOS">
-      <img src="https://img.shields.io/badge/Platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey" alt="Supported Platforms">
-    </a>
-    <a href="https://memos-docs.openmem.net/home/overview/">
-      <img src="https://img.shields.io/badge/Documentation-view-blue.svg" alt="Documentation">
-    </a>
-    <a href="https://arxiv.org/abs/2507.03724">
-      <img src="https://img.shields.io/badge/arXiv-2507.03724-b31b1b.svg" alt="ArXiv Paper">
-    </a>
-    <a href="https://github.com/MemTensor/MemOS/discussions">
-      <img src="https://img.shields.io/badge/GitHub-Discussions-181717.svg?logo=github" alt="GitHub Discussions">
-    </a>
-    <a href="https://discord.gg/Txbx3gebZR">
-      <img src="https://img.shields.io/badge/Discord-join%20chat-7289DA.svg?logo=discord" alt="Discord">
-    </a>
-    <a href="https://statics.memtensor.com.cn/memos/qr-code.png">
-      <img src="https://img.shields.io/badge/WeChat-Group-07C160.svg?logo=wechat" alt="WeChat Group">
-    </a>
-    <a href="https://opensource.org/license/apache-2-0/">
-      <img src="https://img.shields.io/badge/License-Apache_2.0-green.svg?logo=apache" alt="License">
-    </a>
-    <a href="https://github.com/IAAR-Shanghai/Awesome-AI-Memory">
-      <img alt="Awesome AI Memory" src="https://img.shields.io/badge/Resources-Awesome--AI--Memory-8A2BE2">
-    </a>
-  </p>
+<p align="center">
+  <br>
+  <a href="https://memos-docs.openmem.net/home/overview/"><img src="https://img.shields.io/badge/Docs-Get--Start-002FA7?labelColor=gray&style=for-the-badge&logo=googledocs&logoColor=white" alt="Docs"></a>
+  <a href="https://arxiv.org/abs/2507.03724"><img src="https://img.shields.io/badge/ArXiv-2507.03724-B31B1B?labelColor=gray&style=for-the-badge&logo=arxiv&logoColor=white" alt="ArXiv"></a>
+  <a href="https://x.com/MemOS_dev"><img src="https://img.shields.io/badge/Follow-MemOS-000000?labelColor=gray&style=for-the-badge&logo=x&logoColor=white" alt="X"></a>
+  <a href="https://discord.gg/Txbx3gebZR"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdiscord.com%2Fapi%2Fv10%2Finvites%2FTxbx3gebZR%3Fwith_counts%3Dtrue&query=%24.approximate_presence_count&suffix=%20online&label=Discord&color=404EED&labelColor=gray&style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
+  <a href="https://github.com/IAAR-Shanghai/Awesome-AI-Memory"><img src="https://img.shields.io/badge/Resources-Awesome--AI--Memory-8A2BE2?labelColor=gray&style=for-the-badge&logo=awesomelists&logoColor=white" alt="Resources"></a>
+</p>
 
 <p align="center">
   <strong>🎯 +43.70% Accuracy vs. OpenAI Memory</strong><br/>
-  <strong>🏆 Top-tier long-term memory + personalization</strong><br/>
-  <strong>💰 Saves 35.24% memory tokens</strong><br/>
+  <strong>🏆 Top-tier Long-term Memory + Personalization</strong><br/>
+  <strong>💰 Saves 35.24% Memory Tokens</strong><br/>
   <sub>LoCoMo 75.80 • LongMemEval +40.43% • PrefEval-10 +2568% • PersonaMem +40.75%</sub>
   <!-- <a href="https://memos.openmem.net/">
     <img src="https://statics.memtensor.com.cn/memos/github_api_free_banner.gif" alt="MemOS Free API Banner">
@@ -148,35 +121,27 @@ Description-Content-Type: text/markdown
 
 <!-- <br> -->
 
-## 🦞 Enhanced OpenClaw with MemOS Plugin
-
-![](https://cdn.memtensor.com.cn/img/1770612303123_mnaisk_compressed.png)
-
-🦞 Your lobster now has a working memory system — choose **Cloud** or **Local** to get started.
-
-### ☁️ Cloud Plugin — Hosted Memory Service
-
-- [**72% lower token usage**](https://x.com/MemOS_dev/status/2020854044583924111) — intelligent memory retrieval instead of loading full chat history
-- [**Multi-agent memory sharing**](https://x.com/MemOS_dev/status/2020538135487062094) — multi-instance agents share memory via same user_id, automatic context handoff
+## 🧠 MemOS Plugin: Persistent Memory for Your AI Agents ✨
 
-Get your API key: [MemOS Dashboard](https://memos-dashboard.openmem.net/cn/login/)
-Full tutorial → [MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/MemOS-Cloud-OpenClaw-Plugin)
+<div align="center">
+  
+<img width="1660" height="664" alt="MemOS Plugin Banner" src="https://github.com/user-attachments/assets/9d15dde2-196e-4f71-a364-dd5a33062117" />
 
-### 🧠 Local Plugin — 100% On-Device Memory
+Your lobsters and Hermes Agents now have **the best** memory system — choose ***Cloud Service*** or ***Self-hosted*** to get started 🏃🏻
 
-- **Zero cloud dependency** — all data stays on your machine, persistent local SQLite storage
-- **Hybrid search + task & skill evolution** — FTS5 + vector search, auto task summarization, reusable skills that self-upgrade
-- **Multi-agent collaboration + Memory Viewer** — memory isolation, skill sharing, full web dashboard with 7 management pages
+| 🔌 Plugin | <div align="center"> 💡 Core Features </div> | 🧩 Resources |
+| :----: | :--- | :---: |
+| 🧠 [**memos-local-plugin 2.0**](https://github.com/hijzy/MemOS/tree/main/apps/memos-local-plugin) | <ul><li>One local-first memory core for **Hermes Agent** and **OpenClaw**.</li><li>Self-evolving memory: L1 trace, L2 policy, L3 world model,<br>and crystallized Skills driven by feedback.</li></ul> | 🌐 [Website](https://memos-claw.openmem.net/) · 📖 [Docs](https://memos-docs.openmem.net/cn/openclaw/local_plugin) · 🐙 [GitHub](https://github.com/hijzy/MemOS/tree/main/apps/memos-local-plugin) · 📦 [NPM](https://www.npmjs.com/package/@memtensor/memos-local-plugin) |
+| ☁️ [**OpenClaw Cloud Plugin**](https://x.com/MemOS_dev/status/2019254160919769171?s=20) | <ul><li>[Reduces token usage by 72%.](https://x.com/MemOS_dev/status/2020854044583924111)</li><li>[Multi-agent memory sharing by `user_id`.](https://x.com/MemOS_dev/status/2020538135487062094)</li></ul> | 🖥️ [MemOS Dashboard](https://memos-dashboard.openmem.net/login/) · 📖 [Full Tutorial](https://memos-docs.openmem.net/openclaw/guide#_4-update-plugin) |
 
- 🌐 [Homepage](https://memos-claw.openmem.net) ·
-📖 [Documentation](https://memos-claw.openmem.net/docs/index.html) · 📦 [NPM](https://www.npmjs.com/package/@memtensor/memos-local-openclaw-plugin)
+</div>
+<br>
 
-## 📌 MemOS: Memory Operating System for AI Agents
+## 👾 MemOS: Memory Operating System for LLM & AI Agents
 
 **MemOS** is a Memory Operating System for LLMs and AI agents that unifies **store / retrieve / manage** for long-term memory, enabling **context-aware and personalized** interactions with **KB**, **multi-modal**, **tool memory**, and **enterprise-grade** optimizations built in.
 
 
-
 ### Key Features
 
 - **Unified Memory API**: A single API to add, retrieve, edit, and delete memory—structured as a graph, inspectable and editable by design, not a black-box embedding store.
@@ -188,6 +153,12 @@ Full tutorial → [MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/Mem
 
 ### News
 
+- **2026-05-09** · 🧠 **memos-local-plugin 2.0**
+  Official local memory plugin for **Hermes Agent** and **OpenClaw**. One core powers self-evolving memory across L1 traces, L2 policies, L3 world models, and crystallized Skills, with local-first storage and feedback-driven retrieval.
+
+- **2026-04-10** · 👧🏻 **MemOS Hermes Agent Local Plugin**
+  Official Hermes Agent memory plugins launched: Hybrid retrieval (FTS5 + vector), smart dedup, tiered skill evolution, multi-agent collaboration. 100% local, zero cloud dependency.
+  
 - **2026-03-08** · 🦞 **MemOS OpenClaw Plugin — Cloud & Local**
   Official OpenClaw memory plugins launched. **Cloud Plugin**: hosted memory service with 72% lower token usage and multi-agent memory sharing ([MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/MemOS-Cloud-OpenClaw-Plugin)). **Local Plugin** (`v1.0.0`): 100% on-device memory with persistent SQLite, hybrid search (FTS5 + vector), task summarization & skill evolution, multi-agent collaboration, and a full Memory Viewer dashboard.
 
@@ -285,7 +256,7 @@ Full tutorial → [MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/Mem
 
 <br>
 
-## 🚀 Quickstart Guide
+## 🚀 Quick-start Guide
 
 ### ☁️ 1、Cloud API (Hosted)
 #### Get API Key
@@ -372,17 +343,18 @@ Full tutorial → [MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/Mem
     res = requests.post(url=url, headers=headers, data=json.dumps(data))
     print(f"result: {res.json()}")
     ```
-
+    
 <br>
 
 ## 📚 Resources
 
 - **Awesome-AI-Memory**
- This is a curated repository dedicated to resources on memory and memory systems for large language models. It systematically collects relevant research papers, frameworks, tools, and practical insights. The repository aims to organize and present the rapidly evolving research landscape of LLM memory, bridging multiple research directions including natural language processing, information retrieval, agentic systems, and cognitive science.
-- **Get started** 👉 [IAAR-Shanghai/Awesome-AI-Memory](https://github.com/IAAR-Shanghai/Awesome-AI-Memory)
+ This is a curated repository dedicated to resources on memory and memory systems for large language models. It systematically collects relevant research papers, frameworks, tools, and practical insights. The repository aims to organize and present the rapidly evolving research landscape of LLM memory, bridging multiple research directions including natural language processing, information retrieval, agentic systems, and cognitive science.<br/>
+**Get started** 👉🏻 [IAAR-Shanghai/Awesome-AI-Memory](https://github.com/IAAR-Shanghai/Awesome-AI-Memory)
+
 - **MemOS Cloud OpenClaw Plugin**
-  Official OpenClaw lifecycle plugin for MemOS Cloud. It automatically recalls context from MemOS before the agent starts and saves the conversation back to MemOS after the agent finishes.
-- **Get started** 👉 [MemTensor/MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/MemOS-Cloud-OpenClaw-Plugin)
+  Official OpenClaw lifecycle plugin for MemOS Cloud. It automatically recalls context from MemOS before the agent starts and saves the conversation back to MemOS after the agent finishes.<br/>
+**Get started** 👉🏻 [MemTensor/MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/MemOS-Cloud-OpenClaw-Plugin)
 
 <br>
 

{memoryos-2.0.14 → memoryos-2.0.16}/README.md

@@ -4,51 +4,24 @@
   </a>
 
   <h1 align="center">
-    <img src="https://statics.memtensor.com.cn/logo/memos_color_m.png" alt="MemOS Logo" width="50"/>
-    MemOS 2.0: 星尘（Stardust）
-    <img src="https://img.shields.io/badge/status-Preview-blue" alt="Preview Badge"/>
+    <img src="https://statics.memtensor.com.cn/logo/memos_color_m.png" alt="MemOS Logo" width="48"/>&nbsp;
+    MemOS 2.0&ensp;Stardust（星尘）
+
   </h1>
 
-  <p>
-    <a href="https://www.memtensor.com.cn/">
-      <img alt="Static Badge" src="https://img.shields.io/badge/Maintained_by-MemTensor-blue">
-    </a>
-    <a href="https://pypi.org/project/MemoryOS">
-      <img src="https://img.shields.io/pypi/v/MemoryOS?label=pypi%20package" alt="PyPI Version">
-    </a>
-    <a href="https://pypi.org/project/MemoryOS">
-      <img src="https://img.shields.io/pypi/pyversions/MemoryOS.svg" alt="Supported Python versions">
-    </a>
-    <a href="https://pypi.org/project/MemoryOS">
-      <img src="https://img.shields.io/badge/Platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey" alt="Supported Platforms">
-    </a>
-    <a href="https://memos-docs.openmem.net/home/overview/">
-      <img src="https://img.shields.io/badge/Documentation-view-blue.svg" alt="Documentation">
-    </a>
-    <a href="https://arxiv.org/abs/2507.03724">
-      <img src="https://img.shields.io/badge/arXiv-2507.03724-b31b1b.svg" alt="ArXiv Paper">
-    </a>
-    <a href="https://github.com/MemTensor/MemOS/discussions">
-      <img src="https://img.shields.io/badge/GitHub-Discussions-181717.svg?logo=github" alt="GitHub Discussions">
-    </a>
-    <a href="https://discord.gg/Txbx3gebZR">
-      <img src="https://img.shields.io/badge/Discord-join%20chat-7289DA.svg?logo=discord" alt="Discord">
-    </a>
-    <a href="https://statics.memtensor.com.cn/memos/qr-code.png">
-      <img src="https://img.shields.io/badge/WeChat-Group-07C160.svg?logo=wechat" alt="WeChat Group">
-    </a>
-    <a href="https://opensource.org/license/apache-2-0/">
-      <img src="https://img.shields.io/badge/License-Apache_2.0-green.svg?logo=apache" alt="License">
-    </a>
-    <a href="https://github.com/IAAR-Shanghai/Awesome-AI-Memory">
-      <img alt="Awesome AI Memory" src="https://img.shields.io/badge/Resources-Awesome--AI--Memory-8A2BE2">
-    </a>
-  </p>
+<p align="center">
+  <br>
+  <a href="https://memos-docs.openmem.net/home/overview/"><img src="https://img.shields.io/badge/Docs-Get--Start-002FA7?labelColor=gray&style=for-the-badge&logo=googledocs&logoColor=white" alt="Docs"></a>
+  <a href="https://arxiv.org/abs/2507.03724"><img src="https://img.shields.io/badge/ArXiv-2507.03724-B31B1B?labelColor=gray&style=for-the-badge&logo=arxiv&logoColor=white" alt="ArXiv"></a>
+  <a href="https://x.com/MemOS_dev"><img src="https://img.shields.io/badge/Follow-MemOS-000000?labelColor=gray&style=for-the-badge&logo=x&logoColor=white" alt="X"></a>
+  <a href="https://discord.gg/Txbx3gebZR"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdiscord.com%2Fapi%2Fv10%2Finvites%2FTxbx3gebZR%3Fwith_counts%3Dtrue&query=%24.approximate_presence_count&suffix=%20online&label=Discord&color=404EED&labelColor=gray&style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
+  <a href="https://github.com/IAAR-Shanghai/Awesome-AI-Memory"><img src="https://img.shields.io/badge/Resources-Awesome--AI--Memory-8A2BE2?labelColor=gray&style=for-the-badge&logo=awesomelists&logoColor=white" alt="Resources"></a>
+</p>
 
 <p align="center">
   <strong>🎯 +43.70% Accuracy vs. OpenAI Memory</strong><br/>
-  <strong>🏆 Top-tier long-term memory + personalization</strong><br/>
-  <strong>💰 Saves 35.24% memory tokens</strong><br/>
+  <strong>🏆 Top-tier Long-term Memory + Personalization</strong><br/>
+  <strong>💰 Saves 35.24% Memory Tokens</strong><br/>
   <sub>LoCoMo 75.80 • LongMemEval +40.43% • PrefEval-10 +2568% • PersonaMem +40.75%</sub>
   <!-- <a href="https://memos.openmem.net/">
     <img src="https://statics.memtensor.com.cn/memos/github_api_free_banner.gif" alt="MemOS Free API Banner">
@@ -64,35 +37,27 @@
 
 <!-- <br> -->
 
-## 🦞 Enhanced OpenClaw with MemOS Plugin
-
-![](https://cdn.memtensor.com.cn/img/1770612303123_mnaisk_compressed.png)
-
-🦞 Your lobster now has a working memory system — choose **Cloud** or **Local** to get started.
-
-### ☁️ Cloud Plugin — Hosted Memory Service
-
-- [**72% lower token usage**](https://x.com/MemOS_dev/status/2020854044583924111) — intelligent memory retrieval instead of loading full chat history
-- [**Multi-agent memory sharing**](https://x.com/MemOS_dev/status/2020538135487062094) — multi-instance agents share memory via same user_id, automatic context handoff
+## 🧠 MemOS Plugin: Persistent Memory for Your AI Agents ✨
 
-Get your API key: [MemOS Dashboard](https://memos-dashboard.openmem.net/cn/login/)
-Full tutorial → [MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/MemOS-Cloud-OpenClaw-Plugin)
+<div align="center">
+  
+<img width="1660" height="664" alt="MemOS Plugin Banner" src="https://github.com/user-attachments/assets/9d15dde2-196e-4f71-a364-dd5a33062117" />
 
-### 🧠 Local Plugin — 100% On-Device Memory
+Your lobsters and Hermes Agents now have **the best** memory system — choose ***Cloud Service*** or ***Self-hosted*** to get started 🏃🏻
 
-- **Zero cloud dependency** — all data stays on your machine, persistent local SQLite storage
-- **Hybrid search + task & skill evolution** — FTS5 + vector search, auto task summarization, reusable skills that self-upgrade
-- **Multi-agent collaboration + Memory Viewer** — memory isolation, skill sharing, full web dashboard with 7 management pages
+| 🔌 Plugin | <div align="center"> 💡 Core Features </div> | 🧩 Resources |
+| :----: | :--- | :---: |
+| 🧠 [**memos-local-plugin 2.0**](https://github.com/hijzy/MemOS/tree/main/apps/memos-local-plugin) | <ul><li>One local-first memory core for **Hermes Agent** and **OpenClaw**.</li><li>Self-evolving memory: L1 trace, L2 policy, L3 world model,<br>and crystallized Skills driven by feedback.</li></ul> | 🌐 [Website](https://memos-claw.openmem.net/) · 📖 [Docs](https://memos-docs.openmem.net/cn/openclaw/local_plugin) · 🐙 [GitHub](https://github.com/hijzy/MemOS/tree/main/apps/memos-local-plugin) · 📦 [NPM](https://www.npmjs.com/package/@memtensor/memos-local-plugin) |
+| ☁️ [**OpenClaw Cloud Plugin**](https://x.com/MemOS_dev/status/2019254160919769171?s=20) | <ul><li>[Reduces token usage by 72%.](https://x.com/MemOS_dev/status/2020854044583924111)</li><li>[Multi-agent memory sharing by `user_id`.](https://x.com/MemOS_dev/status/2020538135487062094)</li></ul> | 🖥️ [MemOS Dashboard](https://memos-dashboard.openmem.net/login/) · 📖 [Full Tutorial](https://memos-docs.openmem.net/openclaw/guide#_4-update-plugin) |
 
- 🌐 [Homepage](https://memos-claw.openmem.net) ·
-📖 [Documentation](https://memos-claw.openmem.net/docs/index.html) · 📦 [NPM](https://www.npmjs.com/package/@memtensor/memos-local-openclaw-plugin)
+</div>
+<br>
 
-## 📌 MemOS: Memory Operating System for AI Agents
+## 👾 MemOS: Memory Operating System for LLM & AI Agents
 
 **MemOS** is a Memory Operating System for LLMs and AI agents that unifies **store / retrieve / manage** for long-term memory, enabling **context-aware and personalized** interactions with **KB**, **multi-modal**, **tool memory**, and **enterprise-grade** optimizations built in.
 
 
-
 ### Key Features
 
 - **Unified Memory API**: A single API to add, retrieve, edit, and delete memory—structured as a graph, inspectable and editable by design, not a black-box embedding store.
@@ -104,6 +69,12 @@ Full tutorial → [MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/Mem
 
 ### News
 
+- **2026-05-09** · 🧠 **memos-local-plugin 2.0**
+  Official local memory plugin for **Hermes Agent** and **OpenClaw**. One core powers self-evolving memory across L1 traces, L2 policies, L3 world models, and crystallized Skills, with local-first storage and feedback-driven retrieval.
+
+- **2026-04-10** · 👧🏻 **MemOS Hermes Agent Local Plugin**
+  Official Hermes Agent memory plugins launched: Hybrid retrieval (FTS5 + vector), smart dedup, tiered skill evolution, multi-agent collaboration. 100% local, zero cloud dependency.
+  
 - **2026-03-08** · 🦞 **MemOS OpenClaw Plugin — Cloud & Local**
   Official OpenClaw memory plugins launched. **Cloud Plugin**: hosted memory service with 72% lower token usage and multi-agent memory sharing ([MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/MemOS-Cloud-OpenClaw-Plugin)). **Local Plugin** (`v1.0.0`): 100% on-device memory with persistent SQLite, hybrid search (FTS5 + vector), task summarization & skill evolution, multi-agent collaboration, and a full Memory Viewer dashboard.
 
@@ -201,7 +172,7 @@ Full tutorial → [MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/Mem
 
 <br>
 
-## 🚀 Quickstart Guide
+## 🚀 Quick-start Guide
 
 ### ☁️ 1、Cloud API (Hosted)
 #### Get API Key
@@ -288,17 +259,18 @@ Full tutorial → [MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/Mem
     res = requests.post(url=url, headers=headers, data=json.dumps(data))
     print(f"result: {res.json()}")
     ```
-
+    
 <br>
 
 ## 📚 Resources
 
 - **Awesome-AI-Memory**
- This is a curated repository dedicated to resources on memory and memory systems for large language models. It systematically collects relevant research papers, frameworks, tools, and practical insights. The repository aims to organize and present the rapidly evolving research landscape of LLM memory, bridging multiple research directions including natural language processing, information retrieval, agentic systems, and cognitive science.
-- **Get started** 👉 [IAAR-Shanghai/Awesome-AI-Memory](https://github.com/IAAR-Shanghai/Awesome-AI-Memory)
+ This is a curated repository dedicated to resources on memory and memory systems for large language models. It systematically collects relevant research papers, frameworks, tools, and practical insights. The repository aims to organize and present the rapidly evolving research landscape of LLM memory, bridging multiple research directions including natural language processing, information retrieval, agentic systems, and cognitive science.<br/>
+**Get started** 👉🏻 [IAAR-Shanghai/Awesome-AI-Memory](https://github.com/IAAR-Shanghai/Awesome-AI-Memory)
+
 - **MemOS Cloud OpenClaw Plugin**
-  Official OpenClaw lifecycle plugin for MemOS Cloud. It automatically recalls context from MemOS before the agent starts and saves the conversation back to MemOS after the agent finishes.
-- **Get started** 👉 [MemTensor/MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/MemOS-Cloud-OpenClaw-Plugin)
+  Official OpenClaw lifecycle plugin for MemOS Cloud. It automatically recalls context from MemOS before the agent starts and saves the conversation back to MemOS after the agent finishes.<br/>
+**Get started** 👉🏻 [MemTensor/MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/MemOS-Cloud-OpenClaw-Plugin)
 
 <br>
 

{memoryos-2.0.14 → memoryos-2.0.16}/pyproject.toml

@@ -4,7 +4,7 @@
 ##############################################################################
 
 name = "MemoryOS"
-version = "2.0.14"
+version = "2.0.16"
 description = "Intelligence Begins with Memory"
 license = {text = "Apache-2.0"}
 readme = "README.md"

{memoryos-2.0.14 → memoryos-2.0.16}/src/memos/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "2.0.14"
+__version__ = "2.0.16"
 
 from memos.configs.mem_cube import GeneralMemCubeConfig
 from memos.configs.mem_os import MOSConfig

{memoryos-2.0.14 → memoryos-2.0.16}/src/memos/api/handlers/component_init.py

@@ -179,6 +179,7 @@ def init_server() -> dict[str, Any]:
     plugin_context = build_plugin_context(
         graph_db=graph_db,
         embedder=embedder,
+        llm=llm,
         default_cube_config=default_cube_config,
         nli_client_config=nli_client_config,
         mem_reader_config=mem_reader_config,
@@ -285,6 +286,12 @@ def init_server() -> dict[str, Any]:
     # Initialize SchedulerAPIModule
     api_module = mem_scheduler.api_module
 
+    # Plugins keep a reference to the original context dict, so updating the shared
+    # section here makes the runtime handles visible without adding a second init step.
+    plugin_context["shared"]["mem_scheduler"] = mem_scheduler
+    plugin_context["shared"]["submit_scheduler_messages"] = mem_scheduler.submit_messages
+    plugin_context["shared"]["api_module"] = api_module
+
     # Start scheduler if enabled
     if os.getenv("API_SCHEDULER_ON", "true").lower() == "true":
         mem_scheduler.start()

{memoryos-2.0.14 → memoryos-2.0.16}/src/memos/api/handlers/search_handler.py

@@ -20,6 +20,7 @@ from memos.memories.textual.tree_text_memory.retrieve.retrieve_utils import (
 from memos.multi_mem_cube.composite_cube import CompositeCubeView
 from memos.multi_mem_cube.single_cube import SingleCubeView
 from memos.multi_mem_cube.views import MemCubeView
+from memos.plugins.hooks import hookable
 
 
 logger = get_logger(__name__)
@@ -44,6 +45,7 @@ class SearchHandler(BaseHandler):
             "naive_mem_cube", "mem_scheduler", "searcher", "deepsearch_agent"
         )
 
+    @hookable("search")
     def handle_search_memories(self, search_req: APISearchRequest) -> SearchResponse:
         """
         Main handler for search memories endpoint.

{memoryos-2.0.14 → memoryos-2.0.16}/src/memos/api/product_models.py

@@ -438,6 +438,14 @@ class APISearchRequest(BaseRequest):
     )
 
     # ==== Context ====
+    reference_time: str | None = Field(
+        None,
+        description=(
+            "Optional reference time for time-sensitive search parsing. "
+            "If omitted, search uses the current server time."
+        ),
+    )
+
     chat_history: MessageList | None = Field(
         None,
         description=(
@@ -608,6 +616,17 @@ class APIADDRequest(BaseRequest):
         description=("Whether this request represents user feedback. Default: False."),
     )
 
+    # ==== Upload skill flag ====
+    is_upload_skill: bool = Field(
+        False,
+        description=(
+            "Whether this request is an upload skill request. "
+            "When True, the messages field should contain file items "
+            "with zip file download URLs for pre-built skill packages. "
+            "Default: False."
+        ),
+    )
+
     # ==== Backward compatibility fields (will delete later) ====
     mem_cube_id: str | None = Field(
         None,

memoryos-2.0.16/src/memos/dream/__init__.py

@@ -0,0 +1,11 @@
+"""Built-in Dream plugin package.
+
+The default Dream implementation lives inside the core repository so it can be
+discovered like any other MemOS plugin. Enterprise builds can swap the entry
+point to an external plugin without changing the scheduler contract.
+"""
+
+from memos.dream.plugin import CommunityDreamPlugin
+
+
+__all__ = ["CommunityDreamPlugin"]

memoryos-2.0.16/src/memos/dream/hook_defs.py

@@ -0,0 +1,25 @@
+"""Dream plugin-owned hooks.
+
+These hooks are plugin-scoped and allow extensions to observe or modify Dream
+persistence behavior without changing the core pipeline.
+"""
+
+from memos.plugins.hook_defs import define_hook
+
+
+class DreamH:
+    DREAM_BEFORE_PERSIST = "dream.before_persist"
+    DREAM_AFTER_PERSIST = "dream.after_persist"
+
+
+define_hook(
+    DreamH.DREAM_BEFORE_PERSIST,
+    description="Allow plugins to inspect/modify Dream results before persistence",
+    params=["mem_cube_id", "results"],
+)
+
+define_hook(
+    DreamH.DREAM_AFTER_PERSIST,
+    description="Allow plugins to react after Dream persistence completes",
+    params=["mem_cube_id", "results"],
+)

memoryos-2.0.16/src/memos/dream/hooks.py

@@ -0,0 +1,88 @@
+from __future__ import annotations
+
+from typing import Any
+
+
+def on_dream_execute(
+    plugin,
+    *,
+    mem_cube_id: str,
+    user_id: str,
+    user_name: str,
+    signal_snapshot,
+    text_mem,
+    scheduler_context,
+    **kwargs,
+):
+    """Single-provider Dream execution hook.
+
+    The scheduler handler always calls this hook. The active Dream plugin decides
+    which pipeline implementation to run. After the pipeline finishes, the hook
+    resets the signal store so the next accumulation cycle starts fresh.
+    """
+
+    results = plugin.pipeline.run(
+        mem_cube_id=mem_cube_id,
+        user_id=user_id,
+        cube_id=mem_cube_id,
+        signal_snapshot=signal_snapshot,
+        text_mem=text_mem,
+    )
+    plugin.signal_store.reset(mem_cube_id=mem_cube_id)
+    return results
+
+
+def on_add_signal(plugin, *, request, result, **kwargs) -> None:
+    """Built-in Dream signal capture hook.
+
+    The current implementation only extracts enough information to build a scheduler payload.
+    If a runtime scheduler handle is not available yet, the signal is still kept
+    locally so manual triggering and future auto-trigger logic use the same store.
+    """
+
+    mem_cube_id = _extract_mem_cube_id(request=request, result=result)
+    if not mem_cube_id:
+        return
+
+    memory_ids = _extract_memory_ids(result)
+    snapshot = plugin.signal_store.record_add(
+        mem_cube_id=mem_cube_id,
+        user_id=getattr(request, "user_id", "") or "",
+        user_name=getattr(request, "user_name", "") or "",
+        session_id=getattr(request, "session_id", "") or "",
+        memory_ids=memory_ids,
+    )
+    if plugin.signal_store.should_trigger(mem_cube_id=mem_cube_id):
+        plugin.submit_dream_task(
+            mem_cube_id=mem_cube_id,
+            user_id=snapshot.user_id,
+            user_name=snapshot.user_name,
+            signal_snapshot=snapshot,
+        )
+
+
+def _extract_mem_cube_id(*, request, result) -> str:
+    writable_cube_ids = getattr(request, "writable_cube_ids", None) or []
+    if writable_cube_ids:
+        return writable_cube_ids[0]
+
+    data = getattr(result, "data", None) or []
+    for item in data:
+        if isinstance(item, dict) and item.get("mem_cube_id"):
+            return item["mem_cube_id"]
+        mem_cube_id = getattr(item, "mem_cube_id", None)
+        if mem_cube_id:
+            return mem_cube_id
+    return ""
+
+
+def _extract_memory_ids(result) -> list[str]:
+    ids: list[str] = []
+    data = getattr(result, "data", None) or []
+    for item in data:
+        candidate: Any = (
+            item.get("memory_id") if isinstance(item, dict) else getattr(item, "memory_id", None)
+        )
+        if candidate:
+            ids.append(str(candidate))
+    return ids

memoryos-2.0.16/src/memos/dream/maintenance.py

@@ -0,0 +1,56 @@
+"""Dream memory lifecycle maintenance.
+
+This module is responsible for periodic cleanup of Dream-produced memories.
+It is intentionally left unimplemented as a contribution entry point.
+
+────────────────────────────────────────────────────────────────────────────
+CONTRIBUTION GUIDE — Dream Memory Maintenance
+────────────────────────────────────────────────────────────────────────────
+
+Dream memories are not permanent. Each Dream-produced memory carries
+`DreamMemoryLifecycle` metadata (see types.py) and should be periodically
+evaluated for continued relevance.
+
+Cleanup rules to implement:
+
+1. STALE — Long time not hit
+   - If `last_hit_at` is older than a configurable TTL (e.g. 7 days),
+     the memory should be decayed or archived.
+   - Suggested approach: query graph_db for nodes where
+     metadata.source == "dream" and lifecycle.last_hit_at < threshold.
+
+2. LOW USEFULNESS — Hit but not helpful
+   - If the memory is retrieved during queries but `usefulness_score`
+     remains below a threshold, it is noise rather than signal.
+   - Suggested approach: integrate with the retrieval layer to update
+     usefulness_score when a Dream memory is included in a response
+     but receives low relevance feedback.
+
+3. INVALIDATED — Overturned by feedback
+   - If `invalidated_by_feedback` is set to True (e.g. by the feedback
+     API or a contradicting new memory), archive immediately.
+   - Suggested approach: register a hook on the feedback endpoint to
+     mark conflicting Dream memories.
+
+Implementation hints:
+
+- Create a `DreamMaintenanceTask` that runs on a scheduler interval
+  (e.g. daily) or is triggered by a hook.
+- Use `graph_db.update_node(id, None, {"status": "archived", ...})` to
+  archive memories that fail the above checks.
+- Consider a gradual decay: lower confidence over time rather than
+  hard-deleting on first miss.
+- The `DreamMemoryLifecycle` model in types.py already provides the
+  fields you need: `last_hit_at`, `hit_count`, `usefulness_score`,
+  `invalidated_by_feedback`, `status`.
+
+Entry point suggestion:
+
+    class DreamMaintenanceStrategy:
+        def run_maintenance(self, *, user_name: str, mem_cube_id: str) -> MaintenanceReport:
+            ...
+
+Register it in plugin.py and wire it to a scheduler interval or a
+dedicated API endpoint (e.g. POST /dream/maintenance/run).
+────────────────────────────────────────────────────────────────────────────
+"""

memoryos-2.0.16/src/memos/dream/pipeline/__init__.py

@@ -0,0 +1,16 @@
+from memos.dream.pipeline.base import AbstractDreamPipeline
+from memos.dream.pipeline.diary import StructuredDiarySummary
+from memos.dream.pipeline.motive import MotiveFormation
+from memos.dream.pipeline.persistence import DreamPersistence
+from memos.dream.pipeline.reasoning import ConsolidationReasoning
+from memos.dream.pipeline.recall import DirectRecall
+
+
+__all__ = [
+    "AbstractDreamPipeline",
+    "ConsolidationReasoning",
+    "DirectRecall",
+    "DreamPersistence",
+    "MotiveFormation",
+    "StructuredDiarySummary",
+]