@sentry/junior-memory 0.122.1 → 0.124.0

package/dist/events.d.ts

@@ -0,0 +1,19 @@
+import type { MemoryRecord } from "./store";
+/** Durable transcript event emitted after background memory capture. */
+export declare const memoriesCapturedEvent: import("@sentry/junior-plugin-api").DefinedConversationEvent<{
+    memories: {
+        content: string;
+        id: string;
+        kind: "preference" | "procedure" | "knowledge";
+        observedAtMs: number;
+        scope: "personal" | "conversation";
+    }[];
+}>;
+/** Select the stable, safe memory fields retained in conversation history. */
+export declare function capturedMemory(memory: MemoryRecord): {
+    content: string;
+    id: string;
+    kind: "preference" | "procedure" | "knowledge";
+    observedAtMs: number;
+    scope: "personal" | "conversation";
+};

package/dist/index.js

@@ -527,7 +527,7 @@ async function findByIdempotencyKey(args) {
     )
   ).limit(1);
   if (activeRows[0]) {
-    return parseMemoryRow(activeRows[0]);
+    return { memory: parseMemoryRow(activeRows[0]), outcome: "created" };
   }
   const aliasRows = await args.db.select({ supersededById: juniorMemoryMemories.supersededById }).from(juniorMemoryMemories).where(
     and(
@@ -565,7 +565,7 @@ async function findByIdempotencyKey(args) {
       )
     ).limit(1);
     if (rows[0]) {
-      return parseMemoryRow(rows[0]);
+      return { memory: parseMemoryRow(rows[0]), outcome: "duplicate" };
     }
   }
   return void 0;
@@ -1023,13 +1023,13 @@ function createMemoryStore(db, context, options = {}) {
       });
       if (idempotent2) {
         await storeEmbedding({
-          content: idempotent2.content,
+          content: idempotent2.memory.content,
           db,
           embedder,
-          memoryId: idempotent2.id,
+          memoryId: idempotent2.memory.id,
           nowMs
         });
-        return { created: false, memory: idempotent2 };
+        return idempotent2.outcome === "created" ? { created: false, idempotent: true, memory: idempotent2.memory } : { created: false, memory: idempotent2.memory };
       }
     }
     const exactDuplicate = await findExactDuplicateMemory({
@@ -1088,7 +1088,7 @@ function createMemoryStore(db, context, options = {}) {
       }
     }
     const id = randomUUID();
-    const rows = await db.transaction(async (tx) => {
+    const write = await db.transaction(async (tx) => {
       const inserted = await tx.insert(juniorMemoryMemories).values({
         content,
         createdAtMs: nowMs,
@@ -1113,7 +1113,7 @@ function createMemoryStore(db, context, options = {}) {
       }).returning();
       const insertedMemory = inserted[0];
       if (!insertedMemory || supersededIds.length === 0) {
-        return inserted;
+        return { inserted, supersededIds: [] };
       }
       const superseded = await tx.update(juniorMemoryMemories).set({
         supersededAtMs: nowMs,
@@ -1133,10 +1133,10 @@ function createMemoryStore(db, context, options = {}) {
       if (idsToClean.length > 0) {
         await tx.delete(juniorMemoryEmbeddings).where(inArray(juniorMemoryEmbeddings.memoryId, idsToClean));
       }
-      return inserted;
+      return { inserted, supersededIds: idsToClean };
     });
-    if (rows[0]) {
-      const memory = parseMemoryRow(rows[0]);
+    if (write.inserted[0]) {
+      const memory = parseMemoryRow(write.inserted[0]);
       await storeEmbedding({
         content: memory.content,
         db,
@@ -1145,7 +1145,11 @@ function createMemoryStore(db, context, options = {}) {
         memoryId: memory.id,
         nowMs
       });
-      return { created: true, memory };
+      return {
+        created: true,
+        memory,
+        ...write.supersededIds.length > 0 ? { supersededIds: write.supersededIds } : {}
+      };
     }
     const idempotent = await findByIdempotencyKey({
       db,
@@ -1157,13 +1161,13 @@ function createMemoryStore(db, context, options = {}) {
       throw new Error("Memory idempotency conflict did not resolve.");
     }
     await storeEmbedding({
-      content: idempotent.content,
+      content: idempotent.memory.content,
       db,
       embedder,
-      memoryId: idempotent.id,
+      memoryId: idempotent.memory.id,
       nowMs
     });
-    return { created: false, memory: idempotent };
+    return idempotent.outcome === "created" ? { created: false, idempotent: true, memory: idempotent.memory } : { created: false, memory: idempotent.memory };
   }
   async function retrieveVisibleMemories(rawInput, vectorMaxDistance) {
     const input = searchMemoriesInputSchema.parse(rawInput);
@@ -2438,6 +2442,12 @@ function memoryToolResult(target, data) {
 }
 function createMemoryCreateTool(context) {
   return definePluginTool({
+    annotations: {
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false,
+      readOnlyHint: false
+    },
     description: "Explicit memory-write tool. Use only when the latest user message directly asks Junior to remember, store, save, or forget-and-replace a public/shareable fact. Do not use for ordinary statements like 'I prefer X', 'I use Y', or 'X goes before Y' unless the user also asks you to remember/store/save it; passive memory learning handles those after the visible reply. Pass one self-contained natural-language candidate preserving the user's explicit memory intent. Do not ask the user to rephrase ordinary first-person facts, and do not rewrite them into display-name or third-person wording. Do not include secrets, private personal details, medical/legal/financial/sensitive facts, or another person's personal preference, opinion, habit, identity, relationship, workflow, or private life. Runtime context derives actor, scope, source, and subject ids; the memory agent decides canonical stored content and memory kind, then the plugin derives storage target from kind.",
     executionMode: "sequential",
     inputSchema: createMemoryInputSchema2,
@@ -2510,6 +2520,12 @@ function createMemoryCreateTool(context) {
 }
 function createMemoryRemoveTool(context) {
   return definePluginTool({
+    annotations: {
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: false,
+      readOnlyHint: false
+    },
     description: "Forget one memory visible in the active context. Use only ids or short id prefixes returned by listMemories or searchMemories. Never remove memories by hidden actor, Slack, scope, or subject identifiers.",
     executionMode: "sequential",
     inputSchema: removeMemoryInputSchema,
@@ -2535,7 +2551,12 @@ function createMemoryRemoveTool(context) {
 function createMemoryListTool(context) {
   return definePluginTool({
     description: "List active memories visible in the current context. Use when the user asks what Junior remembers or when memory ids are needed before removing a memory.",
-    annotations: { readOnlyHint: true, destructiveHint: false },
+    annotations: {
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false,
+      readOnlyHint: true
+    },
     inputSchema: listMemoriesInputSchema2,
     outputSchema: memoryManyOutputSchema,
     execute: async (input) => {
@@ -2552,7 +2573,12 @@ function createMemoryListTool(context) {
 function createMemorySearchTool(context) {
   return definePluginTool({
     description: "Search active memories visible in the current context. Use when the model needs targeted memory recall. The tool searches only the current actor and active conversation scopes.",
-    annotations: { readOnlyHint: true, destructiveHint: false },
+    annotations: {
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false,
+      readOnlyHint: true
+    },
     inputSchema: searchMemoriesInputSchema2,
     outputSchema: memoryManyOutputSchema,
     execute: async (input) => {
@@ -2577,7 +2603,54 @@ import {
   getSourceKey as getSourceKey2,
   isPrivateSource as isPrivateSource2
 } from "@sentry/junior-plugin-api";
+import { z as z9 } from "zod";
+
+// src/events.ts
+import { defineConversationEvent } from "@sentry/junior-plugin-api";
 import { z as z8 } from "zod";
+var MAX_EVENT_PREVIEW_CHARS = 500;
+var capturedMemorySchema = z8.object({
+  content: z8.string().min(1),
+  id: z8.string().min(1),
+  kind: z8.enum(MEMORY_KINDS),
+  observedAtMs: z8.number().finite(),
+  scope: z8.enum(MEMORY_SCOPES)
+}).strict();
+function eventPreview(content) {
+  const trimmed = content.trim();
+  if (trimmed.length <= MAX_EVENT_PREVIEW_CHARS) return trimmed;
+  return `${trimmed.slice(0, MAX_EVENT_PREVIEW_CHARS - 3).trimEnd()}...`;
+}
+var memoriesCapturedEvent = defineConversationEvent({
+  name: "memories_captured",
+  version: 1,
+  schema: z8.object({
+    memories: z8.array(capturedMemorySchema).min(1).max(100)
+  }).strict(),
+  renderEvent(event) {
+    const count = event.memories.length;
+    return {
+      icon: "brain",
+      title: count === 1 ? "Memory captured" : "Memories captured",
+      preview: count === 1 ? eventPreview(event.memories[0].content) : `${count} memories`,
+      details: event.memories.map((memory) => ({
+        title: memory.content,
+        metadata: [memory.kind, memory.scope]
+      }))
+    };
+  }
+});
+function capturedMemory(memory) {
+  return {
+    content: memory.content,
+    id: memory.id,
+    kind: memory.kind,
+    observedAtMs: memory.observedAtMs,
+    scope: memory.scope
+  };
+}
+
+// src/process-session.ts
 var MEMORY_TOOL_NAMES = /* @__PURE__ */ new Set([
   "createMemory",
   "listMemories",
@@ -2585,14 +2658,25 @@ var MEMORY_TOOL_NAMES = /* @__PURE__ */ new Set([
   "searchMemories"
 ]);
 var MEMORY_TASK_STATE_TTL_MS = 7 * 24 * 60 * 60 * 1e3;
-var extractedMemoryCacheSchema = z8.array(
-  z8.object({
-    content: z8.string().min(1),
-    expiresAtMs: z8.number().finite().nullable(),
-    kind: z8.enum(MEMORY_KINDS),
-    evidenceMessageIndices: z8.array(z8.number().int().nonnegative()).min(1).max(10)
+var extractedMemoryCacheSchema = z9.array(
+  z9.object({
+    content: z9.string().min(1),
+    expiresAtMs: z9.number().finite().nullable(),
+    kind: z9.enum(MEMORY_KINDS),
+    evidenceMessageIndices: z9.array(z9.number().int().nonnegative()).min(1).max(10)
   }).strict().transform(parseExtractedMemory)
 );
+function recordCapturedMemory(captured, result) {
+  const supersededIds = new Set(result.supersededIds ?? []);
+  for (let index2 = captured.length - 1; index2 >= 0; index2 -= 1) {
+    if (supersededIds.has(captured[index2].id)) {
+      captured.splice(index2, 1);
+    }
+  }
+  if (result.created || result.idempotent) {
+    captured.push(capturedMemory(result.memory));
+  }
+}
 function isRunActorInstruction(entry) {
   return entry.type === "message" && entry.role === "user" && entry.provenance?.authority === "instruction" && entry.isRunActor === true;
 }
@@ -2711,6 +2795,7 @@ async function processMemorySession(context) {
   if (memories.length === 0) {
     return;
   }
+  const captured = [];
   for (const memory of memories) {
     const target = routeExtractedMemory(memory, transcript, run);
     if (target === "drop") {
@@ -2718,10 +2803,15 @@ async function processMemorySession(context) {
     }
     const input = passiveInput(run.runId, memory, sourceKey2, target);
     if (target === "conversation") {
-      await store.createConversationMemory(input);
+      const result2 = await store.createConversationMemory(input);
+      recordCapturedMemory(captured, result2);
       continue;
     }
-    await store.createMemory(input);
+    const result = await store.createMemory(input);
+    recordCapturedMemory(captured, result);
+  }
+  if (captured.length > 0) {
+    await context.events.emit(memoriesCapturedEvent({ memories: captured }));
   }
 }
 
@@ -2729,7 +2819,7 @@ async function processMemorySession(context) {
 import {
   definePromptContext
 } from "@sentry/junior-plugin-api";
-import { z as z9 } from "zod";
+import { z as z10 } from "zod";
 var DEFAULT_RECALL_LIMIT = 5;
 var RECALL_CANDIDATE_LIMIT = 20;
 var MAX_PROMPT_CHARS = 4e3;
@@ -2744,15 +2834,15 @@ function trimContent(content, maxLength) {
 function formatObservedDate(observedAtMs) {
   return new Date(observedAtMs).toISOString().slice(0, 10);
 }
-var recalledMemorySchema = z9.object({
-  id: z9.string().min(1),
-  content: z9.string().min(1).max(MAX_MEMORY_LINE_CHARS),
-  observedAtMs: z9.number().finite(),
-  scope: z9.enum(["personal", "conversation"]),
-  kind: z9.enum(["preference", "procedure", "knowledge"])
+var recalledMemorySchema = z10.object({
+  id: z10.string().min(1),
+  content: z10.string().min(1).max(MAX_MEMORY_LINE_CHARS),
+  observedAtMs: z10.number().finite(),
+  scope: z10.enum(["personal", "conversation"]),
+  kind: z10.enum(["preference", "procedure", "knowledge"])
 }).strict();
-var memoryRecallContextSchema = z9.object({
-  memories: z9.array(recalledMemorySchema).min(1).max(DEFAULT_RECALL_LIMIT)
+var memoryRecallContextSchema = z10.object({
+  memories: z10.array(recalledMemorySchema).min(1).max(DEFAULT_RECALL_LIMIT)
 }).strict();
 function selectPromptMemories(memories) {
   const header = "Relevant memories for this request:";
@@ -2834,13 +2924,13 @@ async function createMemoryPromptContributions(context) {
 
 // src/operational-report.ts
 import { and as and4, eq as eq5, gt as gt4, isNull as isNull3, or as or4, sql as sql4 } from "drizzle-orm";
-import { z as z10 } from "zod";
+import { z as z11 } from "zod";
 var DAY_MS = 24 * 60 * 60 * 1e3;
 var WINDOWS = [7, 30, 90];
-var memoryDaySchema = z10.object({
-  conversation: z10.number().int().nonnegative(),
-  date: z10.string().date(),
-  personal: z10.number().int().nonnegative()
+var memoryDaySchema = z11.object({
+  conversation: z11.number().int().nonnegative(),
+  date: z11.string().date(),
+  personal: z11.number().int().nonnegative()
 }).strict();
 function queryRows(result) {
   if (typeof result !== "object" || result === null || !("rows" in result) || !Array.isArray(result.rows)) {
@@ -2893,7 +2983,7 @@ async function aggregateMemoryDays(args) {
     LEFT JOIN daily ON daily.day = days.day
     ORDER BY days.day
   `);
-  return z10.array(memoryDaySchema).parse(queryRows(result));
+  return z11.array(memoryDaySchema).parse(queryRows(result));
 }
 function formatCount(value) {
   return new Intl.NumberFormat("en-US").format(value);
@@ -3092,6 +3182,7 @@ function memoryPlugin(options = {}) {
     },
     model: modelId ? { structuredModelId: modelId } : { structuredModel: "default" },
     packageName: "@sentry/junior-memory",
+    conversationEvents: [memoriesCapturedEvent],
     cli: {
       commands: [createMemoryCliCommand()]
     },