@sentry/junior-memory 0.133.0 → 0.135.0

package/dist/plugin.d.ts

@@ -1,7 +1,9 @@
 export interface MemoryPluginOptions {
+    /** Disable automatic prompt recall while keeping explicit memory tools available. */
+    disableRecall?: boolean;
+    /** Disable passive memory extraction from completed sessions. */
+    disableExtraction?: boolean;
     modelId?: string;
-    /** Maximum cosine distance for vector recall candidates. Defaults to MEMORY_RECALL_MAX_VECTOR_DISTANCE env or 0.45. */
-    recallMaxVectorDistance?: number;
 }
 /** Register Junior's long-term memory plugin. */
 export declare function memoryPlugin(options?: MemoryPluginOptions): import("@sentry/junior-plugin-api").PluginRegistration;

package/dist/ranking.d.ts

@@ -12,5 +12,9 @@ export interface MemoryMatch {
 /** Fuse lexical and vector ranks without comparing provider raw scores. */
 export declare function rankMemoryMatches(matches: MemoryMatch[], options: {
     channelPrefix?: string;
+    /** Optional RRF weight for the lexical leg. Defaults to 1. */
+    lexicalWeight?: number;
     nowMs: number;
+    /** Optional RRF weight for the vector leg. Defaults to 1. */
+    vectorWeight?: number;
 }): MemoryMatch[];

package/dist/recall.d.ts

@@ -9,8 +9,6 @@ export interface MemoryRecallContext {
     embedder?: MemoryEmbeddingProvider;
     events?: PluginConversationEvents;
     log: PluginLogger;
-    /** Maximum cosine distance for vector recall. Passed through to the memory store. */
-    maxVectorDistance?: number;
     actor?: Actor;
     source: Source;
     text: string;

package/dist/store.d.ts

@@ -156,8 +156,6 @@ export interface MemorySupersessionDecider {
 }
 export interface MemoryStoreOptions {
     embedder?: MemoryEmbeddingProvider;
-    /** Maximum cosine distance for vector recall candidates. Model-dependent; tune when changing AI_EMBEDDING_MODEL. */
-    maxVectorDistance?: number;
     now?: () => number;
     supersessionDecider?: MemorySupersessionDecider;
 }

package/migrations/0007_military_tyger_tiger.sql

@@ -0,0 +1 @@
+CREATE INDEX "junior_memory_embeddings_embedding_hnsw_idx" ON "junior_memory_embeddings" USING hnsw ("embedding" vector_cosine_ops) WITH (m=16,ef_construction=64);

package/migrations/meta/0007_snapshot.json

@@ -0,0 +1,409 @@
+{
+  "id": "eeef198b-34d7-4ab8-9e1e-1a238ce8bdd5",
+  "prevId": "f18fa309-6485-40f3-921a-5d65552fbdf6",
+  "version": "7",
+  "dialect": "postgresql",
+  "tables": {
+    "public.junior_memory_embeddings": {
+      "name": "junior_memory_embeddings",
+      "schema": "",
+      "columns": {
+        "memory_id": {
+          "name": "memory_id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true
+        },
+        "provider": {
+          "name": "provider",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "model": {
+          "name": "model",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "dimensions": {
+          "name": "dimensions",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "metric": {
+          "name": "metric",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "content_hash": {
+          "name": "content_hash",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "embedding": {
+          "name": "embedding",
+          "type": "vector(1536)",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "created_at_ms": {
+          "name": "created_at_ms",
+          "type": "bigint",
+          "primaryKey": false,
+          "notNull": true
+        }
+      },
+      "indexes": {
+        "junior_memory_embeddings_model_idx": {
+          "name": "junior_memory_embeddings_model_idx",
+          "columns": [
+            {
+              "expression": "provider",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "model",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "dimensions",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "metric",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "junior_memory_embeddings_embedding_hnsw_idx": {
+          "name": "junior_memory_embeddings_embedding_hnsw_idx",
+          "columns": [
+            {
+              "expression": "embedding",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last",
+              "opclass": "vector_cosine_ops"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "hnsw",
+          "with": {
+            "m": 16,
+            "ef_construction": 64
+          }
+        }
+      },
+      "foreignKeys": {
+        "junior_memory_embeddings_memory_id_junior_memory_memories_id_fk": {
+          "name": "junior_memory_embeddings_memory_id_junior_memory_memories_id_fk",
+          "tableFrom": "junior_memory_embeddings",
+          "tableTo": "junior_memory_memories",
+          "columnsFrom": [
+            "memory_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {
+        "junior_memory_embeddings_metric_check": {
+          "name": "junior_memory_embeddings_metric_check",
+          "value": "\"junior_memory_embeddings\".\"metric\" IN ('cosine')"
+        },
+        "junior_memory_embeddings_dimensions_check": {
+          "name": "junior_memory_embeddings_dimensions_check",
+          "value": "\"junior_memory_embeddings\".\"dimensions\" = 1536"
+        }
+      },
+      "isRLSEnabled": false
+    },
+    "public.junior_memory_memories": {
+      "name": "junior_memory_memories",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true
+        },
+        "scope": {
+          "name": "scope",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "scope_key": {
+          "name": "scope_key",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "type": {
+          "name": "type",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "subject_type": {
+          "name": "subject_type",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "subject_key": {
+          "name": "subject_key",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "content": {
+          "name": "content",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "search_vector": {
+          "name": "search_vector",
+          "type": "tsvector",
+          "primaryKey": false,
+          "notNull": false,
+          "generated": {
+            "as": "to_tsvector('english', \"content\")",
+            "type": "stored"
+          }
+        },
+        "source_platform": {
+          "name": "source_platform",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "source_key": {
+          "name": "source_key",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "idempotency_key": {
+          "name": "idempotency_key",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "observed_at_ms": {
+          "name": "observed_at_ms",
+          "type": "bigint",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "created_at_ms": {
+          "name": "created_at_ms",
+          "type": "bigint",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "expires_at_ms": {
+          "name": "expires_at_ms",
+          "type": "bigint",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "superseded_at_ms": {
+          "name": "superseded_at_ms",
+          "type": "bigint",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "superseded_by_id": {
+          "name": "superseded_by_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "archived_at_ms": {
+          "name": "archived_at_ms",
+          "type": "bigint",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "archive_reason": {
+          "name": "archive_reason",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        }
+      },
+      "indexes": {
+        "junior_memory_memories_visible_idx": {
+          "name": "junior_memory_memories_visible_idx",
+          "columns": [
+            {
+              "expression": "scope",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "scope_key",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "created_at_ms",
+              "isExpression": false,
+              "asc": false,
+              "nulls": "last"
+            },
+            {
+              "expression": "id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "where": "\"junior_memory_memories\".\"archived_at_ms\" IS NULL AND \"junior_memory_memories\".\"superseded_at_ms\" IS NULL AND \"junior_memory_memories\".\"superseded_by_id\" IS NULL",
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "junior_memory_memories_expiration_idx": {
+          "name": "junior_memory_memories_expiration_idx",
+          "columns": [
+            {
+              "expression": "expires_at_ms",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "where": "\"junior_memory_memories\".\"archived_at_ms\" IS NULL AND \"junior_memory_memories\".\"expires_at_ms\" IS NOT NULL",
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "junior_memory_memories_search_idx": {
+          "name": "junior_memory_memories_search_idx",
+          "columns": [
+            {
+              "expression": "scope",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "scope_key",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "search_vector",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "where": "\"junior_memory_memories\".\"archived_at_ms\" IS NULL AND \"junior_memory_memories\".\"superseded_at_ms\" IS NULL AND \"junior_memory_memories\".\"superseded_by_id\" IS NULL",
+          "concurrently": false,
+          "method": "gin",
+          "with": {}
+        },
+        "junior_memory_memories_idempotency_idx": {
+          "name": "junior_memory_memories_idempotency_idx",
+          "columns": [
+            {
+              "expression": "scope",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "scope_key",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "idempotency_key",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": true,
+          "where": "\"junior_memory_memories\".\"idempotency_key\" IS NOT NULL AND \"junior_memory_memories\".\"archived_at_ms\" IS NULL AND \"junior_memory_memories\".\"superseded_at_ms\" IS NULL AND \"junior_memory_memories\".\"superseded_by_id\" IS NULL",
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {
+        "junior_memory_memories_scope_check": {
+          "name": "junior_memory_memories_scope_check",
+          "value": "\"junior_memory_memories\".\"scope\" IN ('personal', 'conversation')"
+        },
+        "junior_memory_memories_kind_check": {
+          "name": "junior_memory_memories_kind_check",
+          "value": "\"junior_memory_memories\".\"type\" IN (\n        'preference',\n        'procedure',\n        'knowledge'\n      )"
+        },
+        "junior_memory_memories_subject_type_check": {
+          "name": "junior_memory_memories_subject_type_check",
+          "value": "\"junior_memory_memories\".\"subject_type\" IN ('user', 'conversation', 'general')"
+        },
+        "junior_memory_memories_subject_key_check": {
+          "name": "junior_memory_memories_subject_key_check",
+          "value": "(\"junior_memory_memories\".\"subject_type\" = 'general' AND \"junior_memory_memories\".\"subject_key\" IS NULL) OR (\"junior_memory_memories\".\"subject_type\" IN ('user', 'conversation') AND \"junior_memory_memories\".\"subject_key\" IS NOT NULL AND length(\"junior_memory_memories\".\"subject_key\") > 0)"
+        },
+        "junior_memory_memories_source_platform_check": {
+          "name": "junior_memory_memories_source_platform_check",
+          "value": "\"junior_memory_memories\".\"source_platform\" IN ('slack', 'local')"
+        }
+      },
+      "isRLSEnabled": false
+    }
+  },
+  "enums": {},
+  "schemas": {},
+  "sequences": {},
+  "roles": {},
+  "policies": {},
+  "views": {},
+  "_meta": {
+    "columns": {},
+    "schemas": {},
+    "tables": {}
+  }
+}

package/migrations/meta/_journal.json

@@ -50,6 +50,13 @@
       "when": 1785878952301,
       "tag": "0006_friendly_hydra",
       "breakpoints": true
+    },
+    {
+      "idx": 7,
+      "version": "7",
+      "when": 1785910292191,
+      "tag": "0007_military_tyger_tiger",
+      "breakpoints": true
     }
   ]
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/junior-memory",
-  "version": "0.133.0",
+  "version": "0.135.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -27,7 +27,7 @@
     "commander": "^14.0.3",
     "drizzle-orm": "^0.45.2",
     "zod": "^4.4.3",
-    "@sentry/junior-plugin-api": "0.133.0"
+    "@sentry/junior-plugin-api": "0.135.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",

package/src/db/schema.ts

@@ -128,6 +128,11 @@ export const juniorMemoryEmbeddings = pgTable(
       table.dimensions,
       table.metric,
     ),
+    // Cosine ANN for vector recall/search. Ops must match cosineDistance (<=>).
+    // Keep this unfiltered so planners can use HNSW before scope/status joins.
+    index("junior_memory_embeddings_embedding_hnsw_idx")
+      .using("hnsw", table.embedding.op("vector_cosine_ops"))
+      .with({ m: 16, ef_construction: 64 }),
     check(
       "junior_memory_embeddings_metric_check",
       sql`${table.metric} IN ('cosine')`,

package/src/plugin.ts

@@ -23,14 +23,13 @@ import type { MemoryDb } from "./store";
 import { createMemoryUserPage } from "./user-pages";
 
 const MEMORY_MODEL_ENV = "AI_MEMORY_MODEL";
-const MEMORY_RECALL_MAX_VECTOR_DISTANCE_ENV =
-  "MEMORY_RECALL_MAX_VECTOR_DISTANCE";
-const DEFAULT_RECALL_MAX_VECTOR_DISTANCE = 0.45;
 
 export interface MemoryPluginOptions {
+  /** Disable automatic prompt recall while keeping explicit memory tools available. */
+  disableRecall?: boolean;
+  /** Disable passive memory extraction from completed sessions. */
+  disableExtraction?: boolean;
   modelId?: string;
-  /** Maximum cosine distance for vector recall candidates. Defaults to MEMORY_RECALL_MAX_VECTOR_DISTANCE env or 0.45. */
-  recallMaxVectorDistance?: number;
 }
 
 function memoryModelId(options: MemoryPluginOptions): string | undefined {
@@ -42,20 +41,6 @@ function memoryModelId(options: MemoryPluginOptions): string | undefined {
   return envModelId || undefined;
 }
 
-function recallMaxVectorDistance(options: MemoryPluginOptions): number {
-  if (options.recallMaxVectorDistance !== undefined) {
-    return options.recallMaxVectorDistance;
-  }
-  const raw = process.env[MEMORY_RECALL_MAX_VECTOR_DISTANCE_ENV]?.trim();
-  if (raw) {
-    const parsed = Number(raw);
-    if (Number.isFinite(parsed) && parsed > 0) {
-      return Math.min(parsed, 1);
-    }
-  }
-  return DEFAULT_RECALL_MAX_VECTOR_DISTANCE;
-}
-
 function memoryToolContext(ctx: {
   agent: MemoryReviewer;
   conversationId?: string;
@@ -113,13 +98,15 @@ export function memoryPlugin(options: MemoryPluginOptions = {}) {
     cli: {
       commands: [createMemoryCliCommand()],
     },
-    tasks: {
-      processSession: {
-        async run(ctx) {
-          await processMemorySession(ctx);
+    tasks: options.disableExtraction
+      ? {}
+      : {
+          processSession: {
+            async run(ctx) {
+              await processMemorySession(ctx);
+            },
+          },
         },
-      },
-    },
     userPages: [createMemoryUserPage()],
     hooks: {
       async operationalReport(ctx) {
@@ -163,20 +150,25 @@ export function memoryPlugin(options: MemoryPluginOptions = {}) {
           searchMemories: createMemorySearchTool(context),
         };
       },
-      async userPrompt(ctx) {
-        return await createMemoryPromptContributions({
-          agent: createMemoryAgent(ctx.model),
-          ...(ctx.conversationId ? { conversationId: ctx.conversationId } : {}),
-          ...(ctx.actor ? { actor: ctx.actor } : {}),
-          db: ctx.db as MemoryDb,
-          embedder: ctx.embedder,
-          events: ctx.events,
-          log: ctx.log,
-          maxVectorDistance: recallMaxVectorDistance(options),
-          source: ctx.source,
-          text: ctx.text,
-        });
-      },
+      ...(!options.disableRecall
+        ? {
+            async userPrompt(ctx) {
+              return await createMemoryPromptContributions({
+                agent: createMemoryAgent(ctx.model),
+                ...(ctx.conversationId
+                  ? { conversationId: ctx.conversationId }
+                  : {}),
+                ...(ctx.actor ? { actor: ctx.actor } : {}),
+                db: ctx.db as MemoryDb,
+                embedder: ctx.embedder,
+                events: ctx.events,
+                log: ctx.log,
+                source: ctx.source,
+                text: ctx.text,
+              });
+            },
+          }
+        : {}),
     },
   });
 }