@sentry/junior-memory 0.100.0 → 0.101.0
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/README.md +60 -0
- package/package.json +2 -2
package/README.md
ADDED
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# @sentry/junior-memory
|
|
2
|
+
|
|
3
|
+
The memory plugin stores durable, actor-scoped facts, recalls relevant facts
|
|
4
|
+
into prompts, and learns candidates from completed sessions. SQL schemas,
|
|
5
|
+
exported types, tools, and tests are authoritative.
|
|
6
|
+
|
|
7
|
+
## Surfaces
|
|
8
|
+
|
|
9
|
+
- `createMemory`, `removeMemory`, `listMemories`, and `searchMemories` are
|
|
10
|
+
model-visible tools registered by `src/plugin.ts`.
|
|
11
|
+
- `userPrompt` recall contributes bounded memory context before a run.
|
|
12
|
+
- `processSession` reviews completed sessions asynchronously for passive
|
|
13
|
+
learning.
|
|
14
|
+
- The `memory` CLI namespace provides explicit administrative search and
|
|
15
|
+
inspection.
|
|
16
|
+
|
|
17
|
+
## Scope And Visibility
|
|
18
|
+
|
|
19
|
+
- Memory scope is derived from the active actor and source, never from
|
|
20
|
+
model-supplied ownership fields.
|
|
21
|
+
- Private conversations and local sources remain private by default.
|
|
22
|
+
- Recall filters candidates by actor, source, visibility, status, and relevance
|
|
23
|
+
before content reaches the model.
|
|
24
|
+
- Administrative reads require explicit selectors and safe output defaults.
|
|
25
|
+
- Memory content, embeddings, source excerpts, and review prompts must not be
|
|
26
|
+
logged or traced.
|
|
27
|
+
|
|
28
|
+
## Storage
|
|
29
|
+
|
|
30
|
+
- The Drizzle schema in `src/db/schema.ts` and generated migrations define the
|
|
31
|
+
database contract.
|
|
32
|
+
- Records retain provenance, lifecycle status, supersession relationships, and
|
|
33
|
+
timestamps needed for review and deletion.
|
|
34
|
+
- Embeddings are derived indexes, not independent memory authority.
|
|
35
|
+
- Writes are idempotent where a completed session or tool retry can repeat.
|
|
36
|
+
- Removal and supersession preserve enough lifecycle information to prevent
|
|
37
|
+
deleted facts from being recalled or silently recreated.
|
|
38
|
+
|
|
39
|
+
## Learning And Recall
|
|
40
|
+
|
|
41
|
+
- Explicit user requests to remember or forget take priority over passive
|
|
42
|
+
learning.
|
|
43
|
+
- Passive extraction creates only durable, reusable facts—not transient tasks,
|
|
44
|
+
conversation summaries, secrets, or speculative interpretation.
|
|
45
|
+
- Candidate review resolves duplicates and supersession before activation.
|
|
46
|
+
- Recall is bounded and relevance-ranked; an empty result contributes no filler
|
|
47
|
+
prompt text.
|
|
48
|
+
- Model or embedding failures fail the owning hook/task without corrupting
|
|
49
|
+
existing memory state.
|
|
50
|
+
|
|
51
|
+
## Configuration
|
|
52
|
+
|
|
53
|
+
- `AI_MEMORY_MODEL` or `createMemoryPlugin({ modelId })` selects the structured
|
|
54
|
+
review model.
|
|
55
|
+
- `MEMORY_RECALL_MAX_VECTOR_DISTANCE` or
|
|
56
|
+
`recallMaxVectorDistance` configures the vector candidate threshold.
|
|
57
|
+
- Generate schema changes with `pnpm --filter @sentry/junior-memory db:generate`.
|
|
58
|
+
|
|
59
|
+
Follow `../../policies/data-redaction.md`, `../../policies/security.md`, and the
|
|
60
|
+
plugin contract in `../junior-plugin-api/README.md`.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sentry/junior-memory",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.101.0",
|
|
4
4
|
"private": false,
|
|
5
5
|
"publishConfig": {
|
|
6
6
|
"access": "public"
|
|
@@ -27,7 +27,7 @@
|
|
|
27
27
|
"commander": "^14.0.3",
|
|
28
28
|
"drizzle-orm": "^0.45.2",
|
|
29
29
|
"zod": "^4.4.3",
|
|
30
|
-
"@sentry/junior-plugin-api": "0.
|
|
30
|
+
"@sentry/junior-plugin-api": "0.101.0"
|
|
31
31
|
},
|
|
32
32
|
"devDependencies": {
|
|
33
33
|
"@types/node": "^25.9.1",
|