@elizaos/plugin-memory 1.0.5 → 2.0.1

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.
Files changed (36) hide show
  1. package/README.md +339 -207
  2. package/dist/browser/index.browser.js +348 -151
  3. package/dist/browser/index.browser.js.map +23 -13
  4. package/dist/cjs/index.node.cjs +2200 -1047
  5. package/dist/cjs/index.node.js.map +23 -13
  6. package/dist/evaluators/consolidation.d.ts +19 -0
  7. package/dist/evaluators/summarization.d.ts +5 -24
  8. package/dist/index.d.ts +152 -30
  9. package/dist/node/index.node.js +2242 -1084
  10. package/dist/node/index.node.js.map +23 -13
  11. package/dist/prompts/consolidation.d.ts +35 -0
  12. package/dist/prompts/summarization.d.ts +25 -0
  13. package/dist/providers/action-results.d.ts +2 -0
  14. package/dist/providers/long-term-memory.d.ts +18 -11
  15. package/dist/providers/recent-conversation-summary.d.ts +2 -0
  16. package/dist/repositories/conversation-summary.d.ts +33 -0
  17. package/dist/repositories/index.d.ts +17 -0
  18. package/dist/repositories/long-term-memory.d.ts +53 -0
  19. package/dist/schemas/conversation-summaries.d.ts +494 -0
  20. package/dist/schemas/index.d.ts +16 -6
  21. package/dist/schemas/long-term-memories.d.ts +308 -70
  22. package/dist/services/memory-service.d.ts +95 -51
  23. package/dist/types/index.d.ts +299 -55
  24. package/dist/utils/db-mapping.d.ts +20 -0
  25. package/dist/utils/decay-scoring.d.ts +41 -0
  26. package/dist/utils/embedding.d.ts +21 -0
  27. package/dist/utils/formatting.d.ts +17 -0
  28. package/dist/utils/index.d.ts +17 -0
  29. package/dist/utils/search-merging.d.ts +18 -0
  30. package/dist/utils/token-counter.d.ts +53 -0
  31. package/package.json +83 -1
  32. package/dist/actions/remember.d.ts +0 -11
  33. package/dist/evaluators/long-term-extraction.d.ts +0 -8
  34. package/dist/providers/short-term-memory.d.ts +0 -19
  35. package/dist/schemas/memory-access-logs.d.ts +0 -154
  36. package/dist/schemas/session-summaries.d.ts +0 -283
@@ -1,11 +0,0 @@
1
- import { type Action } from '@elizaos/core';
2
- /**
3
- * Remember Action
4
- *
5
- * Allows users to explicitly ask the agent to remember information.
6
- * Examples:
7
- * - "Remember that I prefer Python over JavaScript"
8
- * - "Please remember I'm working on a startup project"
9
- * - "Keep in mind that I don't like verbose explanations"
10
- */
11
- export declare const rememberAction: Action;
@@ -1,8 +0,0 @@
1
- import { type Evaluator } from '@elizaos/core';
2
- /**
3
- * Long-term Memory Extraction Evaluator
4
- *
5
- * Analyzes conversations to extract persistent facts about users that should be remembered
6
- * across all future conversations.
7
- */
8
- export declare const longTermExtractionEvaluator: Evaluator;
@@ -1,19 +0,0 @@
1
- import { type Provider } from '@elizaos/core';
2
- /**
3
- * Short-term Memory Provider
4
- *
5
- * Adaptive conversation context provider that optimizes based on conversation length:
6
- *
7
- * SHORT CONVERSATIONS (< threshold, default 5 messages):
8
- * - Shows full message history with complete context
9
- * - No summarization overhead for brief chats
10
- *
11
- * LONG CONVERSATIONS (>= threshold):
12
- * - Shows summaries of older conversation segments
13
- * - Shows recent unsummarized messages in full
14
- * - Optimizes context window while preserving information
15
- *
16
- * This provider can REPLACE recentMessagesProvider when plugin-memory is active,
17
- * providing superior context management for both short and long conversations.
18
- */
19
- export declare const shortTermMemoryProvider: Provider;
@@ -1,154 +0,0 @@
1
- /**
2
- * Memory access logs (optional - for tracking and improving memory retrieval)
3
- */
4
- export declare const memoryAccessLogs: import("drizzle-orm/pg-core").PgTableWithColumns<{
5
- name: "memory_access_logs";
6
- schema: undefined;
7
- columns: {
8
- id: import("drizzle-orm/pg-core").PgColumn<{
9
- name: "id";
10
- tableName: "memory_access_logs";
11
- dataType: "string";
12
- columnType: "PgVarchar";
13
- data: string;
14
- driverParam: string;
15
- notNull: true;
16
- hasDefault: false;
17
- isPrimaryKey: true;
18
- isAutoincrement: false;
19
- hasRuntimeDefault: false;
20
- enumValues: [string, ...string[]];
21
- baseColumn: never;
22
- identity: undefined;
23
- generated: undefined;
24
- }, {}, {
25
- length: 36;
26
- }>;
27
- agentId: import("drizzle-orm/pg-core").PgColumn<{
28
- name: "agent_id";
29
- tableName: "memory_access_logs";
30
- dataType: "string";
31
- columnType: "PgVarchar";
32
- data: string;
33
- driverParam: string;
34
- notNull: true;
35
- hasDefault: false;
36
- isPrimaryKey: false;
37
- isAutoincrement: false;
38
- hasRuntimeDefault: false;
39
- enumValues: [string, ...string[]];
40
- baseColumn: never;
41
- identity: undefined;
42
- generated: undefined;
43
- }, {}, {
44
- length: 36;
45
- }>;
46
- memoryId: import("drizzle-orm/pg-core").PgColumn<{
47
- name: "memory_id";
48
- tableName: "memory_access_logs";
49
- dataType: "string";
50
- columnType: "PgVarchar";
51
- data: string;
52
- driverParam: string;
53
- notNull: true;
54
- hasDefault: false;
55
- isPrimaryKey: false;
56
- isAutoincrement: false;
57
- hasRuntimeDefault: false;
58
- enumValues: [string, ...string[]];
59
- baseColumn: never;
60
- identity: undefined;
61
- generated: undefined;
62
- }, {}, {
63
- length: 36;
64
- }>;
65
- memoryType: import("drizzle-orm/pg-core").PgColumn<{
66
- name: "memory_type";
67
- tableName: "memory_access_logs";
68
- dataType: "string";
69
- columnType: "PgText";
70
- data: string;
71
- driverParam: string;
72
- notNull: true;
73
- hasDefault: false;
74
- isPrimaryKey: false;
75
- isAutoincrement: false;
76
- hasRuntimeDefault: false;
77
- enumValues: [string, ...string[]];
78
- baseColumn: never;
79
- identity: undefined;
80
- generated: undefined;
81
- }, {}, {}>;
82
- accessedAt: import("drizzle-orm/pg-core").PgColumn<{
83
- name: "accessed_at";
84
- tableName: "memory_access_logs";
85
- dataType: "date";
86
- columnType: "PgTimestamp";
87
- data: Date;
88
- driverParam: string;
89
- notNull: true;
90
- hasDefault: true;
91
- isPrimaryKey: false;
92
- isAutoincrement: false;
93
- hasRuntimeDefault: false;
94
- enumValues: undefined;
95
- baseColumn: never;
96
- identity: undefined;
97
- generated: undefined;
98
- }, {}, {}>;
99
- roomId: import("drizzle-orm/pg-core").PgColumn<{
100
- name: "room_id";
101
- tableName: "memory_access_logs";
102
- dataType: "string";
103
- columnType: "PgVarchar";
104
- data: string;
105
- driverParam: string;
106
- notNull: false;
107
- hasDefault: false;
108
- isPrimaryKey: false;
109
- isAutoincrement: false;
110
- hasRuntimeDefault: false;
111
- enumValues: [string, ...string[]];
112
- baseColumn: never;
113
- identity: undefined;
114
- generated: undefined;
115
- }, {}, {
116
- length: 36;
117
- }>;
118
- relevanceScore: import("drizzle-orm/pg-core").PgColumn<{
119
- name: "relevance_score";
120
- tableName: "memory_access_logs";
121
- dataType: "number";
122
- columnType: "PgReal";
123
- data: number;
124
- driverParam: string | number;
125
- notNull: false;
126
- hasDefault: false;
127
- isPrimaryKey: false;
128
- isAutoincrement: false;
129
- hasRuntimeDefault: false;
130
- enumValues: undefined;
131
- baseColumn: never;
132
- identity: undefined;
133
- generated: undefined;
134
- }, {}, {}>;
135
- wasUseful: import("drizzle-orm/pg-core").PgColumn<{
136
- name: "was_useful";
137
- tableName: "memory_access_logs";
138
- dataType: "number";
139
- columnType: "PgInteger";
140
- data: number;
141
- driverParam: string | number;
142
- notNull: false;
143
- hasDefault: false;
144
- isPrimaryKey: false;
145
- isAutoincrement: false;
146
- hasRuntimeDefault: false;
147
- enumValues: undefined;
148
- baseColumn: never;
149
- identity: undefined;
150
- generated: undefined;
151
- }, {}, {}>;
152
- };
153
- dialect: "pg";
154
- }>;
@@ -1,283 +0,0 @@
1
- /**
2
- * Session summaries table
3
- * Stores condensed summaries of conversation sessions
4
- */
5
- export declare const sessionSummaries: import("drizzle-orm/pg-core").PgTableWithColumns<{
6
- name: "session_summaries";
7
- schema: undefined;
8
- columns: {
9
- id: import("drizzle-orm/pg-core").PgColumn<{
10
- name: "id";
11
- tableName: "session_summaries";
12
- dataType: "string";
13
- columnType: "PgVarchar";
14
- data: string;
15
- driverParam: string;
16
- notNull: true;
17
- hasDefault: false;
18
- isPrimaryKey: true;
19
- isAutoincrement: false;
20
- hasRuntimeDefault: false;
21
- enumValues: [string, ...string[]];
22
- baseColumn: never;
23
- identity: undefined;
24
- generated: undefined;
25
- }, {}, {
26
- length: 36;
27
- }>;
28
- agentId: import("drizzle-orm/pg-core").PgColumn<{
29
- name: "agent_id";
30
- tableName: "session_summaries";
31
- dataType: "string";
32
- columnType: "PgVarchar";
33
- data: string;
34
- driverParam: string;
35
- notNull: true;
36
- hasDefault: false;
37
- isPrimaryKey: false;
38
- isAutoincrement: false;
39
- hasRuntimeDefault: false;
40
- enumValues: [string, ...string[]];
41
- baseColumn: never;
42
- identity: undefined;
43
- generated: undefined;
44
- }, {}, {
45
- length: 36;
46
- }>;
47
- roomId: import("drizzle-orm/pg-core").PgColumn<{
48
- name: "room_id";
49
- tableName: "session_summaries";
50
- dataType: "string";
51
- columnType: "PgVarchar";
52
- data: string;
53
- driverParam: string;
54
- notNull: true;
55
- hasDefault: false;
56
- isPrimaryKey: false;
57
- isAutoincrement: false;
58
- hasRuntimeDefault: false;
59
- enumValues: [string, ...string[]];
60
- baseColumn: never;
61
- identity: undefined;
62
- generated: undefined;
63
- }, {}, {
64
- length: 36;
65
- }>;
66
- entityId: import("drizzle-orm/pg-core").PgColumn<{
67
- name: "entity_id";
68
- tableName: "session_summaries";
69
- dataType: "string";
70
- columnType: "PgVarchar";
71
- data: string;
72
- driverParam: string;
73
- notNull: false;
74
- hasDefault: false;
75
- isPrimaryKey: false;
76
- isAutoincrement: false;
77
- hasRuntimeDefault: false;
78
- enumValues: [string, ...string[]];
79
- baseColumn: never;
80
- identity: undefined;
81
- generated: undefined;
82
- }, {}, {
83
- length: 36;
84
- }>;
85
- summary: import("drizzle-orm/pg-core").PgColumn<{
86
- name: "summary";
87
- tableName: "session_summaries";
88
- dataType: "string";
89
- columnType: "PgText";
90
- data: string;
91
- driverParam: string;
92
- notNull: true;
93
- hasDefault: false;
94
- isPrimaryKey: false;
95
- isAutoincrement: false;
96
- hasRuntimeDefault: false;
97
- enumValues: [string, ...string[]];
98
- baseColumn: never;
99
- identity: undefined;
100
- generated: undefined;
101
- }, {}, {}>;
102
- messageCount: import("drizzle-orm/pg-core").PgColumn<{
103
- name: "message_count";
104
- tableName: "session_summaries";
105
- dataType: "number";
106
- columnType: "PgInteger";
107
- data: number;
108
- driverParam: string | number;
109
- notNull: true;
110
- hasDefault: false;
111
- isPrimaryKey: false;
112
- isAutoincrement: false;
113
- hasRuntimeDefault: false;
114
- enumValues: undefined;
115
- baseColumn: never;
116
- identity: undefined;
117
- generated: undefined;
118
- }, {}, {}>;
119
- lastMessageOffset: import("drizzle-orm/pg-core").PgColumn<{
120
- name: "last_message_offset";
121
- tableName: "session_summaries";
122
- dataType: "number";
123
- columnType: "PgInteger";
124
- data: number;
125
- driverParam: string | number;
126
- notNull: true;
127
- hasDefault: true;
128
- isPrimaryKey: false;
129
- isAutoincrement: false;
130
- hasRuntimeDefault: false;
131
- enumValues: undefined;
132
- baseColumn: never;
133
- identity: undefined;
134
- generated: undefined;
135
- }, {}, {}>;
136
- startTime: import("drizzle-orm/pg-core").PgColumn<{
137
- name: "start_time";
138
- tableName: "session_summaries";
139
- dataType: "date";
140
- columnType: "PgTimestamp";
141
- data: Date;
142
- driverParam: string;
143
- notNull: true;
144
- hasDefault: false;
145
- isPrimaryKey: false;
146
- isAutoincrement: false;
147
- hasRuntimeDefault: false;
148
- enumValues: undefined;
149
- baseColumn: never;
150
- identity: undefined;
151
- generated: undefined;
152
- }, {}, {}>;
153
- endTime: import("drizzle-orm/pg-core").PgColumn<{
154
- name: "end_time";
155
- tableName: "session_summaries";
156
- dataType: "date";
157
- columnType: "PgTimestamp";
158
- data: Date;
159
- driverParam: string;
160
- notNull: true;
161
- hasDefault: false;
162
- isPrimaryKey: false;
163
- isAutoincrement: false;
164
- hasRuntimeDefault: false;
165
- enumValues: undefined;
166
- baseColumn: never;
167
- identity: undefined;
168
- generated: undefined;
169
- }, {}, {}>;
170
- topics: import("drizzle-orm/pg-core").PgColumn<{
171
- name: "topics";
172
- tableName: "session_summaries";
173
- dataType: "json";
174
- columnType: "PgJsonb";
175
- data: unknown;
176
- driverParam: unknown;
177
- notNull: false;
178
- hasDefault: false;
179
- isPrimaryKey: false;
180
- isAutoincrement: false;
181
- hasRuntimeDefault: false;
182
- enumValues: undefined;
183
- baseColumn: never;
184
- identity: undefined;
185
- generated: undefined;
186
- }, {}, {}>;
187
- metadata: import("drizzle-orm/pg-core").PgColumn<{
188
- name: "metadata";
189
- tableName: "session_summaries";
190
- dataType: "json";
191
- columnType: "PgJsonb";
192
- data: unknown;
193
- driverParam: unknown;
194
- notNull: false;
195
- hasDefault: false;
196
- isPrimaryKey: false;
197
- isAutoincrement: false;
198
- hasRuntimeDefault: false;
199
- enumValues: undefined;
200
- baseColumn: never;
201
- identity: undefined;
202
- generated: undefined;
203
- }, {}, {}>;
204
- embedding: import("drizzle-orm/pg-core").PgColumn<{
205
- name: "embedding";
206
- tableName: "session_summaries";
207
- dataType: "array";
208
- columnType: "PgArray";
209
- data: number[];
210
- driverParam: string | (string | number)[];
211
- notNull: false;
212
- hasDefault: false;
213
- isPrimaryKey: false;
214
- isAutoincrement: false;
215
- hasRuntimeDefault: false;
216
- enumValues: undefined;
217
- baseColumn: import("drizzle-orm").Column<{
218
- name: "embedding";
219
- tableName: "session_summaries";
220
- dataType: "number";
221
- columnType: "PgReal";
222
- data: number;
223
- driverParam: string | number;
224
- notNull: false;
225
- hasDefault: false;
226
- isPrimaryKey: false;
227
- isAutoincrement: false;
228
- hasRuntimeDefault: false;
229
- enumValues: undefined;
230
- baseColumn: never;
231
- identity: undefined;
232
- generated: undefined;
233
- }, {}, {}>;
234
- identity: undefined;
235
- generated: undefined;
236
- }, {}, {
237
- baseBuilder: import("drizzle-orm/pg-core").PgColumnBuilder<{
238
- name: "embedding";
239
- dataType: "number";
240
- columnType: "PgReal";
241
- data: number;
242
- driverParam: string | number;
243
- enumValues: undefined;
244
- }, {}, {}, import("drizzle-orm").ColumnBuilderExtraConfig>;
245
- size: undefined;
246
- }>;
247
- createdAt: import("drizzle-orm/pg-core").PgColumn<{
248
- name: "created_at";
249
- tableName: "session_summaries";
250
- dataType: "date";
251
- columnType: "PgTimestamp";
252
- data: Date;
253
- driverParam: string;
254
- notNull: true;
255
- hasDefault: true;
256
- isPrimaryKey: false;
257
- isAutoincrement: false;
258
- hasRuntimeDefault: false;
259
- enumValues: undefined;
260
- baseColumn: never;
261
- identity: undefined;
262
- generated: undefined;
263
- }, {}, {}>;
264
- updatedAt: import("drizzle-orm/pg-core").PgColumn<{
265
- name: "updated_at";
266
- tableName: "session_summaries";
267
- dataType: "date";
268
- columnType: "PgTimestamp";
269
- data: Date;
270
- driverParam: string;
271
- notNull: true;
272
- hasDefault: true;
273
- isPrimaryKey: false;
274
- isAutoincrement: false;
275
- hasRuntimeDefault: false;
276
- enumValues: undefined;
277
- baseColumn: never;
278
- identity: undefined;
279
- generated: undefined;
280
- }, {}, {}>;
281
- };
282
- dialect: "pg";
283
- }>;