memoryagent-lib 0.1.2__py3-none-any.whl → 0.1.3__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {memoryagent_lib-0.1.2.dist-info → memoryagent_lib-0.1.3.dist-info}/METADATA +23 -22
- {memoryagent_lib-0.1.2.dist-info → memoryagent_lib-0.1.3.dist-info}/RECORD +4 -4
- {memoryagent_lib-0.1.2.dist-info → memoryagent_lib-0.1.3.dist-info}/WHEEL +0 -0
- {memoryagent_lib-0.1.2.dist-info → memoryagent_lib-0.1.3.dist-info}/top_level.txt +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: memoryagent-lib
|
|
3
|
-
Version: 0.1.
|
|
3
|
+
Version: 0.1.3
|
|
4
4
|
Summary: Add your description here
|
|
5
5
|
Author-email: Jiawei Zheng <jw.zhengai@gmail.com>
|
|
6
6
|
License: MIT
|
|
@@ -13,10 +13,8 @@ Requires-Dist: openai>=2.16.0
|
|
|
13
13
|
Requires-Dist: pydantic>=2.0
|
|
14
14
|
Requires-Dist: sqlite-vec>=0.1.6
|
|
15
15
|
|
|
16
|
-
#
|
|
17
|
-
|
|
18
16
|
<div align="center">
|
|
19
|
-
<img src="https://raw.githubusercontent.com/jia-wei-zheng/MemoryAgent/refs/heads/master/memoryagent_logo.jpg
|
|
17
|
+
<img src="https://raw.githubusercontent.com/jia-wei-zheng/MemoryAgent/refs/heads/master/memoryagent_logo.jpg" alt="MemoryAgent" width="500">
|
|
20
18
|
<h1>MemoryAgent: An Open, Modular Memory Framework for Agents (Beta)</h1>
|
|
21
19
|
</div>
|
|
22
20
|
|
|
@@ -123,23 +121,6 @@ config = MemorySystemConfig(
|
|
|
123
121
|
)
|
|
124
122
|
```
|
|
125
123
|
|
|
126
|
-
## Policies
|
|
127
|
-
### Conversation storage policy
|
|
128
|
-
`HeuristicMemoryPolicy` decides whether a turn should be stored and whether it becomes episodic or semantic memory.
|
|
129
|
-
|
|
130
|
-
### Routing policy
|
|
131
|
-
`MemoryRoutingPolicy` decides where a memory should be written:
|
|
132
|
-
- **Hot** metadata store
|
|
133
|
-
- **Vector index**
|
|
134
|
-
- **Feature store** (perceptual)
|
|
135
|
-
- **Cold** archive (via workers)
|
|
136
|
-
|
|
137
|
-
## Background Workers
|
|
138
|
-
- `ConsolidationWorker`: working → episodic/semantic
|
|
139
|
-
- `ArchiverWorker`: hot → cold + archive index
|
|
140
|
-
- `RehydratorWorker`: cold → hot (based on access)
|
|
141
|
-
- `Compactor`: cleanup/TTL
|
|
142
|
-
|
|
143
124
|
## Examples
|
|
144
125
|
### OpenAI Agent (CLI)
|
|
145
126
|
```bash
|
|
@@ -160,13 +141,31 @@ http://127.0.0.1:8000/memory_viz.html
|
|
|
160
141
|
|
|
161
142
|
An example (System records semantic memory and updating working memory):
|
|
162
143
|
|
|
163
|
-

|
|
164
145
|
|
|
165
146
|
|
|
166
147
|
The page calls:
|
|
167
148
|
- `GET /api/memory?owner=user-001`
|
|
168
149
|
- `POST /api/chat`
|
|
169
150
|
|
|
151
|
+
## Policies
|
|
152
|
+
### Conversation storage policy
|
|
153
|
+
`HeuristicMemoryPolicy` decides whether a turn should be stored and whether it becomes episodic or semantic memory.
|
|
154
|
+
|
|
155
|
+
### Routing policy
|
|
156
|
+
`MemoryRoutingPolicy` decides where a memory should be written:
|
|
157
|
+
- **Hot** metadata store
|
|
158
|
+
- **Vector index**
|
|
159
|
+
- **Feature store** (perceptual)
|
|
160
|
+
- **Cold** archive (via workers)
|
|
161
|
+
|
|
162
|
+
## Background Workers
|
|
163
|
+
- `ConsolidationWorker`: working -> episodic/semantic
|
|
164
|
+
- `ArchiverWorker`: hot -> cold + archive index
|
|
165
|
+
- `RehydratorWorker`: cold -> hot (based on access)
|
|
166
|
+
- `Compactor`: cleanup/TTL
|
|
167
|
+
|
|
168
|
+
|
|
170
169
|
## Data Stores
|
|
171
170
|
- **Hot metadata**: `.memoryagent_hot.sqlite`
|
|
172
171
|
- **Vector index**: `.memoryagent_vectors.sqlite` (sqlite-vec)
|
|
@@ -176,6 +175,7 @@ The page calls:
|
|
|
176
175
|
## Data Root (Installed Usage)
|
|
177
176
|
The system auto-detects a project root by walking up from the current working directory and looking for `pyproject.toml` or `.git`. If it can’t find one, it uses the current directory.
|
|
178
177
|
|
|
178
|
+
|
|
179
179
|
## Configuration
|
|
180
180
|
See `memoryagent/config.py` for defaults:
|
|
181
181
|
- `working_ttl_seconds`
|
|
@@ -187,3 +187,4 @@ See `memoryagent/config.py` for defaults:
|
|
|
187
187
|
- Episodic/semantic memories are candidates for cold archive.
|
|
188
188
|
|
|
189
189
|
## License
|
|
190
|
+
MIT License
|
|
@@ -16,7 +16,7 @@ memoryagent/examples/openai_agent.py,sha256=u31uMM7SM-RYSotail49hs5CpRy01DTyrKOL
|
|
|
16
16
|
memoryagent/storage/base.py,sha256=JYT0HcGIwUz-uydpy9huQ5ABK3G8XshDE6aM3PLpG2s,2453
|
|
17
17
|
memoryagent/storage/in_memory.py,sha256=-AfeYc9TO1EtD59vd2_JTZdJMmTlQYAYQK7fcpKhYAk,3373
|
|
18
18
|
memoryagent/storage/local_disk.py,sha256=EejHxueMmjL7PPPVVl6p8nNmrvJEdxyXQNORly9Nzow,15768
|
|
19
|
-
memoryagent_lib-0.1.
|
|
20
|
-
memoryagent_lib-0.1.
|
|
21
|
-
memoryagent_lib-0.1.
|
|
22
|
-
memoryagent_lib-0.1.
|
|
19
|
+
memoryagent_lib-0.1.3.dist-info/METADATA,sha256=__eZ4043KocPFbVKMd3IyIG3oOsgVc_zUew2LdHVbhM,5872
|
|
20
|
+
memoryagent_lib-0.1.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
|
|
21
|
+
memoryagent_lib-0.1.3.dist-info/top_level.txt,sha256=0svscYmHfWNY9RQMcUEEmE5I6ksCYfy4wR7P-CLrcIU,12
|
|
22
|
+
memoryagent_lib-0.1.3.dist-info/RECORD,,
|
|
File without changes
|
|
File without changes
|