@sentry/junior-memory 0.91.0 → 0.92.1

package/src/recall.ts

@@ -1,8 +1,4 @@
-import type {
-  PromptMessage,
-  Requester,
-  Source,
-} from "@sentry/junior-plugin-api";
+import type { PromptMessage, Actor, Source } from "@sentry/junior-plugin-api";
 import {
   createMemoryStore,
   type MemoryDb,
@@ -21,7 +17,7 @@ export interface MemoryRecallContext {
   embedder?: MemoryEmbeddingProvider;
   /** Maximum cosine distance for vector recall. Passed through to the memory store. */
   maxVectorDistance?: number;
-  requester?: Requester;
+  actor?: Actor;
   source: Source;
   text: string;
 }
@@ -74,19 +70,15 @@ export async function createMemoryPromptMessages(
     ...(context.conversationId
       ? { conversationId: context.conversationId }
       : {}),
-    ...(context.requester ? { requester: context.requester } : {}),
+    ...(context.actor ? { actor: context.actor } : {}),
     source: context.source,
   });
-  const memories = await createMemoryStore(
-    context.db,
-    runtimeContext,
-    {
-      ...(context.embedder ? { embedder: context.embedder } : {}),
-      ...(context.maxVectorDistance !== undefined
-        ? { maxVectorDistance: context.maxVectorDistance }
-        : {}),
-    },
-  ).searchMemories({
+  const memories = await createMemoryStore(context.db, runtimeContext, {
+    ...(context.embedder ? { embedder: context.embedder } : {}),
+    ...(context.maxVectorDistance !== undefined
+      ? { maxVectorDistance: context.maxVectorDistance }
+      : {}),
+  }).searchMemories({
     query: context.text,
     limit: DEFAULT_RECALL_LIMIT,
   });

package/src/scope.ts

@@ -31,15 +31,15 @@ function sourceConversationKey(ctx: MemoryRuntimeContext): string | undefined {
   return `slack:${ctx.source.teamId}:${ctx.source.channelId}:${threadKey}`;
 }
 
-function requesterScopeKey(ctx: MemoryRuntimeContext): string | undefined {
-  const requester = ctx.requester;
-  if (!requester?.userId) {
+function actorScopeKey(ctx: MemoryRuntimeContext): string | undefined {
+  const actor = ctx.actor;
+  if (!actor?.userId) {
     return undefined;
   }
-  if (requester.platform === "slack") {
-    return `slack:${requester.teamId}:${requester.userId}`;
+  if (actor.platform === "slack") {
+    return `slack:${actor.teamId}:${actor.userId}`;
   }
-  return `local:${requester.userId}`;
+  return `local:${actor.userId}`;
 }
 
 /** Derive the authority-bearing key for a requested memory scope. */
@@ -48,9 +48,9 @@ export function deriveMemoryScope(
   scope: MemoryScope,
 ): ResolvedMemoryScope {
   if (scope === "personal") {
-    const scopeKey = requesterScopeKey(ctx);
+    const scopeKey = actorScopeKey(ctx);
     if (!scopeKey) {
-      throw new Error("Personal memory requires requester context.");
+      throw new Error("Personal memory requires actor context.");
     }
     return { scope, scopeKey };
   }
@@ -68,9 +68,9 @@ export function deriveMemorySubject(
   scope: ResolvedMemoryScope,
 ): ResolvedMemorySubject {
   if (scope.scope === "personal") {
-    const subjectKey = requesterScopeKey(ctx);
+    const subjectKey = actorScopeKey(ctx);
     if (!subjectKey) {
-      throw new Error("User-subject memory requires requester context.");
+      throw new Error("User-subject memory requires actor context.");
     }
     return { subjectType: "user", subjectKey };
   }
@@ -92,7 +92,7 @@ export function deriveVisibleMemoryScopes(
   try {
     scopes.push(deriveMemoryScope(ctx, "personal"));
   } catch {
-    // Personal memory is optional when a runtime surface has no requester.
+    // Personal memory is optional when a runtime surface has no actor.
   }
   try {
     scopes.push(deriveMemoryScope(ctx, "conversation"));

package/src/store.ts

@@ -290,7 +290,7 @@ export interface MemoryStore {
   ): Promise<ArchiveExpiredMemoriesResult>;
   /** Archive a visible memory in the current runtime context. */
   archiveMemory(input: ArchiveMemoryInput): Promise<MemoryRecord>;
-  /** Store a personal memory for the current requester. */
+  /** Store a personal memory for the current actor. */
   createMemory(input: CreateMemoryInput): Promise<CreateMemoryResult>;
   /** Store a conversation memory for the current source conversation. */
   createConversationMemory(

package/src/tools.ts

@@ -6,7 +6,7 @@ import {
   PluginToolInputError,
   type PluginToolResult,
   type Source,
-  type Requester,
+  type Actor,
   pluginToolResultSchema,
 } from "@sentry/junior-plugin-api";
 import { z } from "zod";
@@ -43,8 +43,8 @@ const KNOWN_TOOL_INPUT_ERROR_MESSAGES = new Set([
   "Memory id is required.",
   "Memory was not found in the current context.",
   "Memory id prefix is ambiguous.",
-  "Personal memory requires requester context.",
-  "User-subject memory requires requester context.",
+  "Personal memory requires actor context.",
+  "User-subject memory requires actor context.",
 ]);
 
 /** Runtime-owned context used to bind memory tools to visible scopes. */
@@ -53,7 +53,7 @@ export interface MemoryToolContext {
   conversationId?: string;
   db: MemoryDb;
   embedder?: MemoryEmbeddingProvider;
-  requester?: Requester;
+  actor?: Actor;
   source: Source;
   userText?: string;
 }
@@ -86,7 +86,7 @@ function memoryRuntimeContext(
     ...(context.conversationId
       ? { conversationId: context.conversationId }
       : {}),
-    ...(context.requester ? { requester: context.requester } : {}),
+    ...(context.actor ? { actor: context.actor } : {}),
     source: context.source,
   });
 }
@@ -384,9 +384,9 @@ function createInput(
   } satisfies CreateMemoryInput;
 }
 
-function targetForKind(kind: MemoryKind): "requester" | "conversation" {
+function targetForKind(kind: MemoryKind): "actor" | "conversation" {
   if (kind === "preference") {
-    return "requester";
+    return "actor";
   }
   return "conversation";
 }
@@ -554,7 +554,7 @@ export function createMemoryListTool(context: MemoryToolContext) {
 export function createMemorySearchTool(context: MemoryToolContext) {
   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 requester and active conversation scopes.",
+      "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 },
     inputSchema: searchMemoriesInputSchema,
     outputSchema: memoryManyOutputSchema,

package/src/types.ts

@@ -1,8 +1,8 @@
 import {
-  localRequesterSchema,
+  localActorSchema,
   localSourceSchema,
   platformSchema,
-  slackRequesterSchema,
+  slackActorSchema,
   slackSourceSchema,
 } from "@sentry/junior-plugin-api";
 import { z } from "zod";
@@ -34,7 +34,7 @@ const nonEmptyStringSchema = z.string().min(1);
 export const slackMemoryRuntimeContextSchema = z
   .object({
     conversationId: nonEmptyStringSchema.optional(),
-    requester: slackRequesterSchema.optional(),
+    actor: slackActorSchema.optional(),
     source: slackSourceSchema,
   })
   .strict();
@@ -43,7 +43,7 @@ export const slackMemoryRuntimeContextSchema = z
 export const localMemoryRuntimeContextSchema = z
   .object({
     conversationId: nonEmptyStringSchema.optional(),
-    requester: localRequesterSchema.optional(),
+    actor: localActorSchema.optional(),
     source: localSourceSchema,
   })
   .strict();