@mastra/memory 1.23.0-alpha.1 → 1.23.0-alpha.2
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.
- package/CHANGELOG.md +8 -0
- package/dist/{chunk-5HE6DK63.cjs → chunk-2ZR7CKDV.cjs} +4 -4
- package/dist/{chunk-5HE6DK63.cjs.map → chunk-2ZR7CKDV.cjs.map} +1 -1
- package/dist/{chunk-HF2E2T6Z.js → chunk-GHFCSEEP.js} +4 -4
- package/dist/{chunk-HF2E2T6Z.js.map → chunk-GHFCSEEP.js.map} +1 -1
- package/dist/docs/SKILL.md +2 -1
- package/dist/docs/assets/SOURCE_MAP.json +37 -37
- package/dist/docs/references/docs-agents-supervisor-agents.md +2 -1
- package/dist/docs/references/docs-memory-observational-memory.md +2 -1
- package/dist/docs/references/docs-memory-overview.md +2 -0
- package/dist/docs/references/docs-memory-semantic-recall.md +1 -1
- package/dist/docs/references/docs-memory-working-memory.md +3 -3
- package/dist/docs/references/reference-file-based-agents-memory.md +58 -0
- package/dist/docs/references/reference-memory-memory-class.md +1 -1
- package/dist/index.cjs +15 -15
- package/dist/index.js +1 -1
- package/dist/{observational-memory-XKEEBG2S.js → observational-memory-HUPMKPOX.js} +3 -3
- package/dist/{observational-memory-XKEEBG2S.js.map → observational-memory-HUPMKPOX.js.map} +1 -1
- package/dist/{observational-memory-LEIZSPQ5.cjs → observational-memory-RJL2PW6O.cjs} +29 -29
- package/dist/{observational-memory-LEIZSPQ5.cjs.map → observational-memory-RJL2PW6O.cjs.map} +1 -1
- package/dist/processors/index.cjs +27 -27
- package/dist/processors/index.js +1 -1
- package/package.json +5 -5
package/dist/docs/SKILL.md
CHANGED
|
@@ -3,7 +3,7 @@ name: mastra-memory
|
|
|
3
3
|
description: Documentation for @mastra/memory. Use when working with @mastra/memory APIs, configuration, or implementation.
|
|
4
4
|
metadata:
|
|
5
5
|
package: "@mastra/memory"
|
|
6
|
-
version: "1.23.0-alpha.
|
|
6
|
+
version: "1.23.0-alpha.2"
|
|
7
7
|
---
|
|
8
8
|
|
|
9
9
|
## When to use
|
|
@@ -35,6 +35,7 @@ Read the individual reference documents for detailed explanations and code examp
|
|
|
35
35
|
|
|
36
36
|
- [Reference: Mastra.getMemory()](references/reference-core-getMemory.md) - Documentation for the `Mastra.getMemory()` method in Mastra, which retrieves a registered memory instance by its registry key.
|
|
37
37
|
- [Reference: Mastra.listMemory()](references/reference-core-listMemory.md) - Documentation for the `Mastra.listMemory()` method in Mastra, which returns all registered memory instances.
|
|
38
|
+
- [Memory](references/reference-file-based-agents-memory.md) - Give a file-based agent persistent memory with a memory.ts module.
|
|
38
39
|
- [Reference: Cloned thread utilities](references/reference-memory-clone-utilities.md) - Documentation for utility methods to work with cloned threads in Mastra Memory.
|
|
39
40
|
- [Reference: Memory.cloneThread()](references/reference-memory-cloneThread.md) - Documentation for the `Memory.cloneThread()` method in Mastra, which creates a copy of a conversation thread with all its messages.
|
|
40
41
|
- [Reference: Memory.createThread()](references/reference-memory-createThread.md) - Documentation for the `Memory.createThread()` method in Mastra, which creates a new conversation thread in the memory system.
|
|
@@ -1,133 +1,133 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "1.23.0-alpha.
|
|
2
|
+
"version": "1.23.0-alpha.2",
|
|
3
3
|
"package": "@mastra/memory",
|
|
4
4
|
"exports": {
|
|
5
5
|
"Extractor": {
|
|
6
6
|
"types": "dist/processors/index.d.ts",
|
|
7
|
-
"implementation": "dist/chunk-
|
|
7
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
8
8
|
"line": 316
|
|
9
9
|
},
|
|
10
10
|
"ModelByInputTokens": {
|
|
11
11
|
"types": "dist/processors/index.d.ts",
|
|
12
|
-
"implementation": "dist/chunk-
|
|
12
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
13
13
|
"line": 1354
|
|
14
14
|
},
|
|
15
15
|
"OBSERVER_SYSTEM_PROMPT": {
|
|
16
16
|
"types": "dist/processors/index.d.ts",
|
|
17
|
-
"implementation": "dist/chunk-
|
|
17
|
+
"implementation": "dist/chunk-GHFCSEEP.js"
|
|
18
18
|
},
|
|
19
19
|
"ObservationalMemory": {
|
|
20
20
|
"types": "dist/processors/index.d.ts",
|
|
21
|
-
"implementation": "dist/chunk-
|
|
21
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
22
22
|
"line": 27685
|
|
23
23
|
},
|
|
24
24
|
"ObservationalMemoryProcessor": {
|
|
25
25
|
"types": "dist/processors/index.d.ts",
|
|
26
|
-
"implementation": "dist/chunk-
|
|
26
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
27
27
|
"line": 30316
|
|
28
28
|
},
|
|
29
29
|
"TokenCounter": {
|
|
30
30
|
"types": "dist/processors/index.d.ts",
|
|
31
|
-
"implementation": "dist/chunk-
|
|
31
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
32
32
|
"line": 21467
|
|
33
33
|
},
|
|
34
34
|
"WorkingMemoryExtractor": {
|
|
35
35
|
"types": "dist/processors/index.d.ts",
|
|
36
|
-
"implementation": "dist/chunk-
|
|
36
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
37
37
|
"line": 22134
|
|
38
38
|
},
|
|
39
39
|
"buildObserverPrompt": {
|
|
40
40
|
"types": "dist/processors/index.d.ts",
|
|
41
|
-
"implementation": "dist/chunk-
|
|
41
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
42
42
|
"line": 4465
|
|
43
43
|
},
|
|
44
44
|
"buildObserverSystemPrompt": {
|
|
45
45
|
"types": "dist/processors/index.d.ts",
|
|
46
|
-
"implementation": "dist/chunk-
|
|
46
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
47
47
|
"line": 3732
|
|
48
48
|
},
|
|
49
49
|
"combineObservationGroupRanges": {
|
|
50
50
|
"types": "dist/processors/index.d.ts",
|
|
51
|
-
"implementation": "dist/chunk-
|
|
51
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
52
52
|
"line": 1446
|
|
53
53
|
},
|
|
54
54
|
"deriveObservationGroupProvenance": {
|
|
55
55
|
"types": "dist/processors/index.d.ts",
|
|
56
|
-
"implementation": "dist/chunk-
|
|
56
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
57
57
|
"line": 1480
|
|
58
58
|
},
|
|
59
59
|
"extractCurrentTask": {
|
|
60
60
|
"types": "dist/processors/index.d.ts",
|
|
61
|
-
"implementation": "dist/chunk-
|
|
61
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
62
62
|
"line": 4588
|
|
63
63
|
},
|
|
64
64
|
"formatMessagesForObserver": {
|
|
65
65
|
"types": "dist/processors/index.d.ts",
|
|
66
|
-
"implementation": "dist/chunk-
|
|
66
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
67
67
|
"line": 4187
|
|
68
68
|
},
|
|
69
69
|
"getObservationsAsOf": {
|
|
70
70
|
"types": "dist/processors/index.d.ts",
|
|
71
|
-
"implementation": "dist/chunk-
|
|
71
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
72
72
|
"line": 30538
|
|
73
73
|
},
|
|
74
74
|
"hasCurrentTaskSection": {
|
|
75
75
|
"types": "dist/processors/index.d.ts",
|
|
76
|
-
"implementation": "dist/chunk-
|
|
76
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
77
77
|
"line": 4576
|
|
78
78
|
},
|
|
79
79
|
"injectAnchorIds": {
|
|
80
80
|
"types": "dist/processors/index.d.ts",
|
|
81
|
-
"implementation": "dist/chunk-
|
|
81
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
82
82
|
"line": 3287
|
|
83
83
|
},
|
|
84
84
|
"optimizeObservationsForContext": {
|
|
85
85
|
"types": "dist/processors/index.d.ts",
|
|
86
|
-
"implementation": "dist/chunk-
|
|
86
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
87
87
|
"line": 4599
|
|
88
88
|
},
|
|
89
89
|
"parseAnchorId": {
|
|
90
90
|
"types": "dist/processors/index.d.ts",
|
|
91
|
-
"implementation": "dist/chunk-
|
|
91
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
92
92
|
"line": 3260
|
|
93
93
|
},
|
|
94
94
|
"parseObservationGroups": {
|
|
95
95
|
"types": "dist/processors/index.d.ts",
|
|
96
|
-
"implementation": "dist/chunk-
|
|
96
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
97
97
|
"line": 1415
|
|
98
98
|
},
|
|
99
99
|
"parseObserverOutput": {
|
|
100
100
|
"types": "dist/processors/index.d.ts",
|
|
101
|
-
"implementation": "dist/chunk-
|
|
101
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
102
102
|
"line": 4479
|
|
103
103
|
},
|
|
104
104
|
"reconcileObservationGroupsFromReflection": {
|
|
105
105
|
"types": "dist/processors/index.d.ts",
|
|
106
|
-
"implementation": "dist/chunk-
|
|
106
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
107
107
|
"line": 1504
|
|
108
108
|
},
|
|
109
109
|
"renderObservationGroupsForReflection": {
|
|
110
110
|
"types": "dist/processors/index.d.ts",
|
|
111
|
-
"implementation": "dist/chunk-
|
|
111
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
112
112
|
"line": 1460
|
|
113
113
|
},
|
|
114
114
|
"stripEphemeralAnchorIds": {
|
|
115
115
|
"types": "dist/processors/index.d.ts",
|
|
116
|
-
"implementation": "dist/chunk-
|
|
116
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
117
117
|
"line": 3317
|
|
118
118
|
},
|
|
119
119
|
"stripObservationGroups": {
|
|
120
120
|
"types": "dist/processors/index.d.ts",
|
|
121
|
-
"implementation": "dist/chunk-
|
|
121
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
122
122
|
"line": 1437
|
|
123
123
|
},
|
|
124
124
|
"summarizeConversation": {
|
|
125
125
|
"types": "dist/processors/index.d.ts",
|
|
126
|
-
"implementation": "dist/chunk-
|
|
126
|
+
"implementation": "dist/chunk-GHFCSEEP.js"
|
|
127
127
|
},
|
|
128
128
|
"wrapInObservationGroup": {
|
|
129
129
|
"types": "dist/processors/index.d.ts",
|
|
130
|
-
"implementation": "dist/chunk-
|
|
130
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
131
131
|
"line": 1408
|
|
132
132
|
},
|
|
133
133
|
"OBSERVATIONAL_MEMORY_DEFAULTS": {
|
|
@@ -148,43 +148,43 @@
|
|
|
148
148
|
},
|
|
149
149
|
"Memory": {
|
|
150
150
|
"types": "dist/index.d.ts",
|
|
151
|
-
"implementation": "dist/chunk-
|
|
151
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
152
152
|
"line": 23559
|
|
153
153
|
},
|
|
154
154
|
"MessageHistory": {
|
|
155
155
|
"types": "dist/index.d.ts",
|
|
156
|
-
"implementation": "dist/chunk-
|
|
156
|
+
"implementation": "dist/chunk-GHFCSEEP.js"
|
|
157
157
|
},
|
|
158
158
|
"SUMMARIZE_THREAD_DEFAULTS": {
|
|
159
159
|
"types": "dist/index.d.ts",
|
|
160
|
-
"implementation": "dist/chunk-
|
|
160
|
+
"implementation": "dist/chunk-GHFCSEEP.js"
|
|
161
161
|
},
|
|
162
162
|
"SemanticRecall": {
|
|
163
163
|
"types": "dist/index.d.ts",
|
|
164
|
-
"implementation": "dist/chunk-
|
|
164
|
+
"implementation": "dist/chunk-GHFCSEEP.js"
|
|
165
165
|
},
|
|
166
166
|
"WorkingMemory": {
|
|
167
167
|
"types": "dist/index.d.ts",
|
|
168
|
-
"implementation": "dist/chunk-
|
|
168
|
+
"implementation": "dist/chunk-GHFCSEEP.js"
|
|
169
169
|
},
|
|
170
170
|
"deepMergeWorkingMemory": {
|
|
171
171
|
"types": "dist/index.d.ts",
|
|
172
|
-
"implementation": "dist/chunk-
|
|
172
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
173
173
|
"line": 23198
|
|
174
174
|
},
|
|
175
175
|
"extractWorkingMemoryContent": {
|
|
176
176
|
"types": "dist/index.d.ts",
|
|
177
|
-
"implementation": "dist/chunk-
|
|
177
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
178
178
|
"line": 23514
|
|
179
179
|
},
|
|
180
180
|
"extractWorkingMemoryTags": {
|
|
181
181
|
"types": "dist/index.d.ts",
|
|
182
|
-
"implementation": "dist/chunk-
|
|
182
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
183
183
|
"line": 23482
|
|
184
184
|
},
|
|
185
185
|
"removeWorkingMemoryTags": {
|
|
186
186
|
"types": "dist/index.d.ts",
|
|
187
|
-
"implementation": "dist/chunk-
|
|
187
|
+
"implementation": "dist/chunk-GHFCSEEP.js",
|
|
188
188
|
"line": 23495
|
|
189
189
|
},
|
|
190
190
|
"WORKING_MEMORY_STATE_ID": {
|
|
@@ -205,7 +205,7 @@
|
|
|
205
205
|
"processors": {
|
|
206
206
|
"index": "dist/processors/index.js",
|
|
207
207
|
"chunks": [
|
|
208
|
-
"chunk-
|
|
208
|
+
"chunk-GHFCSEEP.js",
|
|
209
209
|
"chunk-LSJJAJAF.js"
|
|
210
210
|
]
|
|
211
211
|
}
|
|
@@ -428,4 +428,5 @@ Version overrides propagate automatically through delegation. See [Subagent vers
|
|
|
428
428
|
- [Agent.generate() reference](https://mastra.ai/reference/agents/generate)
|
|
429
429
|
- [Agent approval](https://mastra.ai/docs/agents/agent-approval)
|
|
430
430
|
- [Memory in multi-agent systems](https://mastra.ai/docs/memory/overview)
|
|
431
|
-
- [Concept: Multi-agent systems](https://mastra.ai/guides/concepts/multi-agent-systems)
|
|
431
|
+
- [Concept: Multi-agent systems](https://mastra.ai/guides/concepts/multi-agent-systems)
|
|
432
|
+
- 📹 [Mastra supervisor agents workshop](https://www.youtube.com/watch?v=FNb2fL9WhQg\&t=1872s)
|
|
@@ -714,4 +714,5 @@ In practical terms, OM replaces both working memory and message history, and has
|
|
|
714
714
|
- [Memory Overview](https://mastra.ai/docs/memory/overview)
|
|
715
715
|
- [Message History](https://mastra.ai/docs/memory/message-history)
|
|
716
716
|
- [Memory Processors](https://mastra.ai/docs/memory/memory-processors)
|
|
717
|
-
- [Mastra Code](https://code.mastra.ai/): A coding agent using Observational Memory
|
|
717
|
+
- [Mastra Code](https://code.mastra.ai/): A coding agent using Observational Memory
|
|
718
|
+
- 📹 [Mastra processors and Observational Memory workshop](https://www.youtube.com/watch?v=4Vpp7xQYvl0)
|
|
@@ -15,6 +15,8 @@ If the combined memory exceeds the model's context limit, [memory processors](ht
|
|
|
15
15
|
|
|
16
16
|
Memory results will be stored in one or more of your configured [storage providers](https://mastra.ai/docs/storage/overview).
|
|
17
17
|
|
|
18
|
+
> **📹 Watch:** Watch [Mastra memory concepts](https://www.youtube.com/watch?v=18iIHQtIPmc) for a conceptual overview of the memory layers agents can use.
|
|
19
|
+
|
|
18
20
|
## When to use memory
|
|
19
21
|
|
|
20
22
|
Use memory when your agent needs to maintain multi-turn conversations that reference prior exchanges, recall user preferences or facts from earlier in a session, or build context over time within a conversation thread. Skip memory for single-turn requests where each interaction is independent.
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
If you ask your friend what they did last weekend, they will search in their memory for events associated with "last weekend" and then tell you what they did. That's sort of like how semantic recall works in Mastra.
|
|
6
6
|
|
|
7
|
-
>
|
|
7
|
+
> **📹 Watch:** Watch [Mastra semantic recall](https://www.youtube.com/watch?v=UVZtK8cK8xQ\&pp=ygUVbWFzdHJhIHdvcmtpbmcgbWVtb3J5) to see how agents retrieve relevant messages from past conversations.
|
|
8
8
|
|
|
9
9
|
## How semantic recall works
|
|
10
10
|
|
|
@@ -10,6 +10,8 @@ This is useful for maintaining ongoing state that's always relevant and should a
|
|
|
10
10
|
|
|
11
11
|
If you use [Observational Memory](https://mastra.ai/docs/memory/observational-memory), `observationalMemory.observation.manageWorkingMemory` lets OM update working memory for the agent.
|
|
12
12
|
|
|
13
|
+
> **📹 Watch:** Watch [Mastra working memory](https://www.youtube.com/watch?v=UMy_JHLf1n8\&pp=ygUVbWFzdHJhIHdvcmtpbmcgbWVtb3J5) to see how agents keep persistent user context available across interactions.
|
|
14
|
+
|
|
13
15
|
Working memory can persist at two different scopes:
|
|
14
16
|
|
|
15
17
|
- **Resource-scoped** (default): Memory persists across all conversation threads for the same user
|
|
@@ -43,9 +45,7 @@ const agent = new Agent({
|
|
|
43
45
|
|
|
44
46
|
## How it works
|
|
45
47
|
|
|
46
|
-
Working memory is a block of Markdown text that the agent is able to update over time to store continuously relevant information
|
|
47
|
-
|
|
48
|
-
[YouTube video player](https://www.youtube-nocookie.com/embed/UMy_JHLf1n8)
|
|
48
|
+
Working memory is a block of Markdown text that the agent is able to update over time to store continuously relevant information.
|
|
49
49
|
|
|
50
50
|
## Memory persistence scopes
|
|
51
51
|
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
|
|
2
|
+
|
|
3
|
+
# Memory
|
|
4
|
+
|
|
5
|
+
A file-based agent gets [memory](https://mastra.ai/docs/memory/overview) from a `memory.ts` file that default-exports a [`Memory`](https://mastra.ai/reference/memory/memory-class) instance. Use this page for the file-based convention; use the memory docs for message history, semantic recall, storage, and processors.
|
|
6
|
+
|
|
7
|
+
Without `memory.ts` or `config.memory`, the agent has no memory by default. Each `generate()` or `stream()` call starts without remembered conversation state unless you pass the prior context yourself.
|
|
8
|
+
|
|
9
|
+
## Quickstart
|
|
10
|
+
|
|
11
|
+
Create `memory.ts` next to the agent's `config.ts`:
|
|
12
|
+
|
|
13
|
+
```typescript
|
|
14
|
+
import { Memory } from '@mastra/memory'
|
|
15
|
+
|
|
16
|
+
export default new Memory()
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
The exported instance becomes the agent's `memory`. If your app configures a storage provider on the main Mastra instance, memory data is stored there. See [storage](https://mastra.ai/docs/storage/overview) for more information.
|
|
20
|
+
|
|
21
|
+
Use the same `resource` and `thread` values when calling the agent to continue a conversation:
|
|
22
|
+
|
|
23
|
+
```typescript
|
|
24
|
+
const response = await weatherAgent.generate('Remember that I prefer Celsius.', {
|
|
25
|
+
memory: {
|
|
26
|
+
resource: 'user-123',
|
|
27
|
+
thread: 'weather-chat',
|
|
28
|
+
},
|
|
29
|
+
})
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## Configure memory
|
|
33
|
+
|
|
34
|
+
Pass options to `new Memory()` when the default behavior isn't enough.
|
|
35
|
+
|
|
36
|
+
```typescript
|
|
37
|
+
import { Memory } from '@mastra/memory'
|
|
38
|
+
|
|
39
|
+
export default new Memory({
|
|
40
|
+
options: {
|
|
41
|
+
lastMessages: 20,
|
|
42
|
+
workingMemory: {
|
|
43
|
+
enabled: true,
|
|
44
|
+
scope: 'resource',
|
|
45
|
+
},
|
|
46
|
+
},
|
|
47
|
+
})
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
Visit the [`Memory` reference](https://mastra.ai/reference/memory/memory-class) for constructor options. Use these pages for related memory features:
|
|
51
|
+
|
|
52
|
+
- [Storage](https://mastra.ai/docs/storage/overview): configure persistence for memory data.
|
|
53
|
+
- [Semantic recall](https://mastra.ai/docs/memory/semantic-recall): retrieve relevant past messages by semantic meaning.
|
|
54
|
+
- [Memory processors](https://mastra.ai/docs/memory/memory-processors): filter, trim, or transform messages before memory adds them to model context.
|
|
55
|
+
|
|
56
|
+
## Precedence with config
|
|
57
|
+
|
|
58
|
+
`config.memory` wins over `memory.ts`. If neither is present, the assembled file-based agent has no memory. See [`config.ts` precedence](https://mastra.ai/reference/file-based-agents/config) for the full merge table.
|
|
@@ -37,7 +37,7 @@ export const agent = new Agent({
|
|
|
37
37
|
|
|
38
38
|
**options** (`MemoryConfig`): Memory configuration options.
|
|
39
39
|
|
|
40
|
-
**options.lastMessages** (`number | false`): Number of most recent messages to include in context. Set to false to disable
|
|
40
|
+
**options.lastMessages** (`number | false`): Number of most recent messages to include in context. Set to false to disable the message history feature entirely (messages are not loaded into context or saved). Use Number.MAX\_SAFE\_INTEGER to retrieve all messages with no limit. To load messages without saving new ones, use the readOnly option.
|
|
41
41
|
|
|
42
42
|
**options.readOnly** (`boolean`): When true, prevents memory from saving new messages and provides working memory as read-only context (without the updateWorkingMemory tool). Useful for read-only operations like previews, internal routing agents, or sub agents that should reference but not modify memory.
|
|
43
43
|
|
package/dist/index.cjs
CHANGED
|
@@ -1,65 +1,65 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
|
|
3
|
-
var
|
|
3
|
+
var chunk2ZR7CKDV_cjs = require('./chunk-2ZR7CKDV.cjs');
|
|
4
4
|
var chunk43FJOLKM_cjs = require('./chunk-43FJOLKM.cjs');
|
|
5
5
|
|
|
6
6
|
|
|
7
7
|
|
|
8
8
|
Object.defineProperty(exports, "Extractor", {
|
|
9
9
|
enumerable: true,
|
|
10
|
-
get: function () { return
|
|
10
|
+
get: function () { return chunk2ZR7CKDV_cjs.Extractor; }
|
|
11
11
|
});
|
|
12
12
|
Object.defineProperty(exports, "Memory", {
|
|
13
13
|
enumerable: true,
|
|
14
|
-
get: function () { return
|
|
14
|
+
get: function () { return chunk2ZR7CKDV_cjs.Memory; }
|
|
15
15
|
});
|
|
16
16
|
Object.defineProperty(exports, "MessageHistory", {
|
|
17
17
|
enumerable: true,
|
|
18
|
-
get: function () { return
|
|
18
|
+
get: function () { return chunk2ZR7CKDV_cjs.MessageHistory; }
|
|
19
19
|
});
|
|
20
20
|
Object.defineProperty(exports, "ModelByInputTokens", {
|
|
21
21
|
enumerable: true,
|
|
22
|
-
get: function () { return
|
|
22
|
+
get: function () { return chunk2ZR7CKDV_cjs.ModelByInputTokens; }
|
|
23
23
|
});
|
|
24
24
|
Object.defineProperty(exports, "SUMMARIZE_THREAD_DEFAULTS", {
|
|
25
25
|
enumerable: true,
|
|
26
|
-
get: function () { return
|
|
26
|
+
get: function () { return chunk2ZR7CKDV_cjs.SUMMARIZE_THREAD_DEFAULTS; }
|
|
27
27
|
});
|
|
28
28
|
Object.defineProperty(exports, "SemanticRecall", {
|
|
29
29
|
enumerable: true,
|
|
30
|
-
get: function () { return
|
|
30
|
+
get: function () { return chunk2ZR7CKDV_cjs.SemanticRecall; }
|
|
31
31
|
});
|
|
32
32
|
Object.defineProperty(exports, "WorkingMemory", {
|
|
33
33
|
enumerable: true,
|
|
34
|
-
get: function () { return
|
|
34
|
+
get: function () { return chunk2ZR7CKDV_cjs.WorkingMemory; }
|
|
35
35
|
});
|
|
36
36
|
Object.defineProperty(exports, "WorkingMemoryExtractor", {
|
|
37
37
|
enumerable: true,
|
|
38
|
-
get: function () { return
|
|
38
|
+
get: function () { return chunk2ZR7CKDV_cjs.WorkingMemoryExtractor; }
|
|
39
39
|
});
|
|
40
40
|
Object.defineProperty(exports, "deepMergeWorkingMemory", {
|
|
41
41
|
enumerable: true,
|
|
42
|
-
get: function () { return
|
|
42
|
+
get: function () { return chunk2ZR7CKDV_cjs.deepMergeWorkingMemory; }
|
|
43
43
|
});
|
|
44
44
|
Object.defineProperty(exports, "extractWorkingMemoryContent", {
|
|
45
45
|
enumerable: true,
|
|
46
|
-
get: function () { return
|
|
46
|
+
get: function () { return chunk2ZR7CKDV_cjs.extractWorkingMemoryContent; }
|
|
47
47
|
});
|
|
48
48
|
Object.defineProperty(exports, "extractWorkingMemoryTags", {
|
|
49
49
|
enumerable: true,
|
|
50
|
-
get: function () { return
|
|
50
|
+
get: function () { return chunk2ZR7CKDV_cjs.extractWorkingMemoryTags; }
|
|
51
51
|
});
|
|
52
52
|
Object.defineProperty(exports, "getObservationsAsOf", {
|
|
53
53
|
enumerable: true,
|
|
54
|
-
get: function () { return
|
|
54
|
+
get: function () { return chunk2ZR7CKDV_cjs.getObservationsAsOf; }
|
|
55
55
|
});
|
|
56
56
|
Object.defineProperty(exports, "removeWorkingMemoryTags", {
|
|
57
57
|
enumerable: true,
|
|
58
|
-
get: function () { return
|
|
58
|
+
get: function () { return chunk2ZR7CKDV_cjs.removeWorkingMemoryTags; }
|
|
59
59
|
});
|
|
60
60
|
Object.defineProperty(exports, "summarizeConversation", {
|
|
61
61
|
enumerable: true,
|
|
62
|
-
get: function () { return
|
|
62
|
+
get: function () { return chunk2ZR7CKDV_cjs.summarizeConversation; }
|
|
63
63
|
});
|
|
64
64
|
Object.defineProperty(exports, "WORKING_MEMORY_STATE_ID", {
|
|
65
65
|
enumerable: true,
|
package/dist/index.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export { Extractor, Memory, MessageHistory, ModelByInputTokens, SUMMARIZE_THREAD_DEFAULTS, SemanticRecall, WorkingMemory, WorkingMemoryExtractor, deepMergeWorkingMemory, extractWorkingMemoryContent, extractWorkingMemoryTags, getObservationsAsOf, removeWorkingMemoryTags, summarizeConversation } from './chunk-
|
|
1
|
+
export { Extractor, Memory, MessageHistory, ModelByInputTokens, SUMMARIZE_THREAD_DEFAULTS, SemanticRecall, WorkingMemory, WorkingMemoryExtractor, deepMergeWorkingMemory, extractWorkingMemoryContent, extractWorkingMemoryTags, getObservationsAsOf, removeWorkingMemoryTags, summarizeConversation } from './chunk-GHFCSEEP.js';
|
|
2
2
|
export { WORKING_MEMORY_STATE_ID, WORKING_MEMORY_STATE_PROCESSOR_ID, WorkingMemoryStateProcessor } from './chunk-WCGXQIEN.js';
|
|
3
3
|
//# sourceMappingURL=index.js.map
|
|
4
4
|
//# sourceMappingURL=index.js.map
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export { Extractor, ModelByInputTokens, OBSERVER_SYSTEM_PROMPT, ObservationalMemory, ObservationalMemoryProcessor, TokenCounter, WorkingMemoryExtractor, buildObserverPrompt, buildObserverSystemPrompt, combineObservationGroupRanges, deriveObservationGroupProvenance, extractCurrentTask, formatMessagesForObserver, getObservationsAsOf, hasCurrentTaskSection, injectAnchorIds, optimizeObservationsForContext, parseAnchorId, parseObservationGroups, parseObserverOutput, reconcileObservationGroupsFromReflection, renderObservationGroupsForReflection, stripEphemeralAnchorIds, stripObservationGroups, summarizeConversation, wrapInObservationGroup } from './chunk-
|
|
1
|
+
export { Extractor, ModelByInputTokens, OBSERVER_SYSTEM_PROMPT, ObservationalMemory, ObservationalMemoryProcessor, TokenCounter, WorkingMemoryExtractor, buildObserverPrompt, buildObserverSystemPrompt, combineObservationGroupRanges, deriveObservationGroupProvenance, extractCurrentTask, formatMessagesForObserver, getObservationsAsOf, hasCurrentTaskSection, injectAnchorIds, optimizeObservationsForContext, parseAnchorId, parseObservationGroups, parseObserverOutput, reconcileObservationGroupsFromReflection, renderObservationGroupsForReflection, stripEphemeralAnchorIds, stripObservationGroups, summarizeConversation, wrapInObservationGroup } from './chunk-GHFCSEEP.js';
|
|
2
2
|
export { OBSERVATIONAL_MEMORY_DEFAULTS, OBSERVATION_CONTEXT_INSTRUCTIONS, OBSERVATION_CONTEXT_PROMPT, OBSERVATION_CONTINUATION_HINT } from './chunk-LSJJAJAF.js';
|
|
3
|
-
//# sourceMappingURL=observational-memory-
|
|
4
|
-
//# sourceMappingURL=observational-memory-
|
|
3
|
+
//# sourceMappingURL=observational-memory-HUPMKPOX.js.map
|
|
4
|
+
//# sourceMappingURL=observational-memory-HUPMKPOX.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":[],"names":[],"mappings":"","file":"observational-memory-
|
|
1
|
+
{"version":3,"sources":[],"names":[],"mappings":"","file":"observational-memory-HUPMKPOX.js"}
|
|
@@ -1,113 +1,113 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
|
|
3
|
-
var
|
|
3
|
+
var chunk2ZR7CKDV_cjs = require('./chunk-2ZR7CKDV.cjs');
|
|
4
4
|
var chunkD4J4XPGM_cjs = require('./chunk-D4J4XPGM.cjs');
|
|
5
5
|
|
|
6
6
|
|
|
7
7
|
|
|
8
8
|
Object.defineProperty(exports, "Extractor", {
|
|
9
9
|
enumerable: true,
|
|
10
|
-
get: function () { return
|
|
10
|
+
get: function () { return chunk2ZR7CKDV_cjs.Extractor; }
|
|
11
11
|
});
|
|
12
12
|
Object.defineProperty(exports, "ModelByInputTokens", {
|
|
13
13
|
enumerable: true,
|
|
14
|
-
get: function () { return
|
|
14
|
+
get: function () { return chunk2ZR7CKDV_cjs.ModelByInputTokens; }
|
|
15
15
|
});
|
|
16
16
|
Object.defineProperty(exports, "OBSERVER_SYSTEM_PROMPT", {
|
|
17
17
|
enumerable: true,
|
|
18
|
-
get: function () { return
|
|
18
|
+
get: function () { return chunk2ZR7CKDV_cjs.OBSERVER_SYSTEM_PROMPT; }
|
|
19
19
|
});
|
|
20
20
|
Object.defineProperty(exports, "ObservationalMemory", {
|
|
21
21
|
enumerable: true,
|
|
22
|
-
get: function () { return
|
|
22
|
+
get: function () { return chunk2ZR7CKDV_cjs.ObservationalMemory; }
|
|
23
23
|
});
|
|
24
24
|
Object.defineProperty(exports, "ObservationalMemoryProcessor", {
|
|
25
25
|
enumerable: true,
|
|
26
|
-
get: function () { return
|
|
26
|
+
get: function () { return chunk2ZR7CKDV_cjs.ObservationalMemoryProcessor; }
|
|
27
27
|
});
|
|
28
28
|
Object.defineProperty(exports, "TokenCounter", {
|
|
29
29
|
enumerable: true,
|
|
30
|
-
get: function () { return
|
|
30
|
+
get: function () { return chunk2ZR7CKDV_cjs.TokenCounter; }
|
|
31
31
|
});
|
|
32
32
|
Object.defineProperty(exports, "WorkingMemoryExtractor", {
|
|
33
33
|
enumerable: true,
|
|
34
|
-
get: function () { return
|
|
34
|
+
get: function () { return chunk2ZR7CKDV_cjs.WorkingMemoryExtractor; }
|
|
35
35
|
});
|
|
36
36
|
Object.defineProperty(exports, "buildObserverPrompt", {
|
|
37
37
|
enumerable: true,
|
|
38
|
-
get: function () { return
|
|
38
|
+
get: function () { return chunk2ZR7CKDV_cjs.buildObserverPrompt; }
|
|
39
39
|
});
|
|
40
40
|
Object.defineProperty(exports, "buildObserverSystemPrompt", {
|
|
41
41
|
enumerable: true,
|
|
42
|
-
get: function () { return
|
|
42
|
+
get: function () { return chunk2ZR7CKDV_cjs.buildObserverSystemPrompt; }
|
|
43
43
|
});
|
|
44
44
|
Object.defineProperty(exports, "combineObservationGroupRanges", {
|
|
45
45
|
enumerable: true,
|
|
46
|
-
get: function () { return
|
|
46
|
+
get: function () { return chunk2ZR7CKDV_cjs.combineObservationGroupRanges; }
|
|
47
47
|
});
|
|
48
48
|
Object.defineProperty(exports, "deriveObservationGroupProvenance", {
|
|
49
49
|
enumerable: true,
|
|
50
|
-
get: function () { return
|
|
50
|
+
get: function () { return chunk2ZR7CKDV_cjs.deriveObservationGroupProvenance; }
|
|
51
51
|
});
|
|
52
52
|
Object.defineProperty(exports, "extractCurrentTask", {
|
|
53
53
|
enumerable: true,
|
|
54
|
-
get: function () { return
|
|
54
|
+
get: function () { return chunk2ZR7CKDV_cjs.extractCurrentTask; }
|
|
55
55
|
});
|
|
56
56
|
Object.defineProperty(exports, "formatMessagesForObserver", {
|
|
57
57
|
enumerable: true,
|
|
58
|
-
get: function () { return
|
|
58
|
+
get: function () { return chunk2ZR7CKDV_cjs.formatMessagesForObserver; }
|
|
59
59
|
});
|
|
60
60
|
Object.defineProperty(exports, "getObservationsAsOf", {
|
|
61
61
|
enumerable: true,
|
|
62
|
-
get: function () { return
|
|
62
|
+
get: function () { return chunk2ZR7CKDV_cjs.getObservationsAsOf; }
|
|
63
63
|
});
|
|
64
64
|
Object.defineProperty(exports, "hasCurrentTaskSection", {
|
|
65
65
|
enumerable: true,
|
|
66
|
-
get: function () { return
|
|
66
|
+
get: function () { return chunk2ZR7CKDV_cjs.hasCurrentTaskSection; }
|
|
67
67
|
});
|
|
68
68
|
Object.defineProperty(exports, "injectAnchorIds", {
|
|
69
69
|
enumerable: true,
|
|
70
|
-
get: function () { return
|
|
70
|
+
get: function () { return chunk2ZR7CKDV_cjs.injectAnchorIds; }
|
|
71
71
|
});
|
|
72
72
|
Object.defineProperty(exports, "optimizeObservationsForContext", {
|
|
73
73
|
enumerable: true,
|
|
74
|
-
get: function () { return
|
|
74
|
+
get: function () { return chunk2ZR7CKDV_cjs.optimizeObservationsForContext; }
|
|
75
75
|
});
|
|
76
76
|
Object.defineProperty(exports, "parseAnchorId", {
|
|
77
77
|
enumerable: true,
|
|
78
|
-
get: function () { return
|
|
78
|
+
get: function () { return chunk2ZR7CKDV_cjs.parseAnchorId; }
|
|
79
79
|
});
|
|
80
80
|
Object.defineProperty(exports, "parseObservationGroups", {
|
|
81
81
|
enumerable: true,
|
|
82
|
-
get: function () { return
|
|
82
|
+
get: function () { return chunk2ZR7CKDV_cjs.parseObservationGroups; }
|
|
83
83
|
});
|
|
84
84
|
Object.defineProperty(exports, "parseObserverOutput", {
|
|
85
85
|
enumerable: true,
|
|
86
|
-
get: function () { return
|
|
86
|
+
get: function () { return chunk2ZR7CKDV_cjs.parseObserverOutput; }
|
|
87
87
|
});
|
|
88
88
|
Object.defineProperty(exports, "reconcileObservationGroupsFromReflection", {
|
|
89
89
|
enumerable: true,
|
|
90
|
-
get: function () { return
|
|
90
|
+
get: function () { return chunk2ZR7CKDV_cjs.reconcileObservationGroupsFromReflection; }
|
|
91
91
|
});
|
|
92
92
|
Object.defineProperty(exports, "renderObservationGroupsForReflection", {
|
|
93
93
|
enumerable: true,
|
|
94
|
-
get: function () { return
|
|
94
|
+
get: function () { return chunk2ZR7CKDV_cjs.renderObservationGroupsForReflection; }
|
|
95
95
|
});
|
|
96
96
|
Object.defineProperty(exports, "stripEphemeralAnchorIds", {
|
|
97
97
|
enumerable: true,
|
|
98
|
-
get: function () { return
|
|
98
|
+
get: function () { return chunk2ZR7CKDV_cjs.stripEphemeralAnchorIds; }
|
|
99
99
|
});
|
|
100
100
|
Object.defineProperty(exports, "stripObservationGroups", {
|
|
101
101
|
enumerable: true,
|
|
102
|
-
get: function () { return
|
|
102
|
+
get: function () { return chunk2ZR7CKDV_cjs.stripObservationGroups; }
|
|
103
103
|
});
|
|
104
104
|
Object.defineProperty(exports, "summarizeConversation", {
|
|
105
105
|
enumerable: true,
|
|
106
|
-
get: function () { return
|
|
106
|
+
get: function () { return chunk2ZR7CKDV_cjs.summarizeConversation; }
|
|
107
107
|
});
|
|
108
108
|
Object.defineProperty(exports, "wrapInObservationGroup", {
|
|
109
109
|
enumerable: true,
|
|
110
|
-
get: function () { return
|
|
110
|
+
get: function () { return chunk2ZR7CKDV_cjs.wrapInObservationGroup; }
|
|
111
111
|
});
|
|
112
112
|
Object.defineProperty(exports, "OBSERVATIONAL_MEMORY_DEFAULTS", {
|
|
113
113
|
enumerable: true,
|
|
@@ -125,5 +125,5 @@ Object.defineProperty(exports, "OBSERVATION_CONTINUATION_HINT", {
|
|
|
125
125
|
enumerable: true,
|
|
126
126
|
get: function () { return chunkD4J4XPGM_cjs.OBSERVATION_CONTINUATION_HINT; }
|
|
127
127
|
});
|
|
128
|
-
//# sourceMappingURL=observational-memory-
|
|
129
|
-
//# sourceMappingURL=observational-memory-
|
|
128
|
+
//# sourceMappingURL=observational-memory-RJL2PW6O.cjs.map
|
|
129
|
+
//# sourceMappingURL=observational-memory-RJL2PW6O.cjs.map
|
package/dist/{observational-memory-LEIZSPQ5.cjs.map → observational-memory-RJL2PW6O.cjs.map}
RENAMED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":[],"names":[],"mappings":"","file":"observational-memory-
|
|
1
|
+
{"version":3,"sources":[],"names":[],"mappings":"","file":"observational-memory-RJL2PW6O.cjs"}
|