@sentry/junior-memory 0.118.0 → 0.120.0

package/README.md

@@ -13,13 +13,22 @@ exported types, tools, and tests are authoritative.
   learning.
 - The `memory` CLI namespace provides explicit administrative search and
   inspection.
-- The dashboard exposes a read-only **Memories** user page for personal
-  memories owned by actors linked to the signed-in user.
+- The dashboard exposes a searchable, paginated **Memories** user page for
+  personal memories owned by actors linked to the signed-in viewer. Its
+  **Forget** action archives the selected memory.
+- Authenticated REST clients can list and search personal memories through
+  `GET /api/plugins/memory/memories`, read one through
+  `GET /api/plugins/memory/memories/:id`, and archive one through
+  `DELETE /api/plugins/memory/memories/:id`. Personal bearer tokens remain
+  read-only, so mutations require a dashboard browser session.
 
 ## Scope And Visibility
 
 - Memory scope is derived from the active actor and source, never from
   model-supplied ownership fields.
+- Dashboard and REST requests authorize one verified viewer, then resolve every
+  linked platform actor internally so one arbitrary actor is never treated as
+  the viewer's canonical identity.
 - Private conversations and local sources remain private by default.
 - Recall filters candidates by actor, source, visibility, status, and relevance
   before content reaches the model.
@@ -34,6 +43,8 @@ exported types, tools, and tests are authoritative.
 - Records retain provenance, lifecycle status, supersession relationships, and
   timestamps needed for review and deletion.
 - Embeddings are derived indexes, not independent memory authority.
+- Embedding distance never decides that two memories are duplicates. Exact
+  content and preference review own duplicate and supersession decisions.
 - Writes are idempotent where a completed session or tool retry can repeat.
 - Removal and supersession preserve enough lifecycle information to prevent
   deleted facts from being recalled or silently recreated.
@@ -45,14 +56,19 @@ exported types, tools, and tests are authoritative.
 - Passive extraction creates only durable, reusable facts—not transient tasks,
   conversation summaries, secrets, or speculative interpretation.
 - Candidate review resolves duplicates and supersession before activation.
-- Recall is bounded and relevance-ranked; an empty result contributes no filler
-  prompt text.
-- Model or embedding failures fail the owning hook/task without corrupting
-  existing memory state.
+- Search combines independently ranked vector and PostgreSQL full-text matches
+  with reciprocal rank fusion; provider-specific raw scores are never added
+  together.
+- Automatic recall retrieves a broad candidate window, then uses the
+  memory-owned relevance model to admit at most five directly useful memories.
+  An empty result contributes no filler prompt text.
+- Automatic recall degrades to no prompt contribution when relevance selection
+  fails. Review, extraction, and write failures still fail their owning
+  hook/task without corrupting existing memory state.
 
 ## Configuration
 
-- `AI_MEMORY_MODEL` or `createMemoryPlugin({ modelId })` selects the structured
+- `AI_MEMORY_MODEL` or `memoryPlugin({ modelId })` selects the structured
   review model.
 - `MEMORY_RECALL_MAX_VECTOR_DISTANCE` or
   `recallMaxVectorDistance` configures the vector candidate threshold.

package/dist/agent.d.ts

@@ -1,6 +1,13 @@
 import { type PluginModel } from "@sentry/junior-plugin-api";
 import { z } from "zod";
 import { type MemorySupersessionDecision, type MemorySupersessionInput } from "./store";
+declare const memoryRecallInputSchema: z.ZodObject<{
+    candidates: z.ZodArray<z.ZodObject<{
+        content: z.ZodString;
+        id: z.ZodString;
+    }, z.core.$strict>>;
+    userRequest: z.ZodString;
+}, z.core.$strict>;
 declare const createMemoryRequestSchema: z.ZodObject<{
     content: z.ZodString;
     expiresAtMs: z.ZodOptional<z.ZodNumber>;
@@ -172,16 +179,19 @@ declare const extractedMemoryResultSchema: z.ZodObject<{
     evidenceMessageIndices: z.ZodArray<z.ZodNumber>;
 }, z.core.$strict>;
 export type MemoryReview = z.output<typeof memoryReviewDecisionSchema>;
+export type MemoryRecallInput = z.output<typeof memoryRecallInputSchema>;
 export type CreateMemoryRequest = z.output<typeof createMemoryRequestSchema>;
 export type ExtractSessionRequest = z.output<typeof extractSessionRequestSchema>;
 export type ExtractedMemory = z.output<typeof extractedMemoryResultSchema>;
 export interface MemoryAgent {
+    /** Select candidate memories that directly help with the current request. */
+    selectRelevantMemories(request: MemoryRecallInput): Promise<string[]> | string[];
     /** Classify a new preference against related active preferences. */
     adjudicateSupersession(request: MemorySupersessionInput): Promise<MemorySupersessionDecision> | MemorySupersessionDecision;
     extractSessionMemories(request: ExtractSessionRequest): Promise<ExtractedMemory[]> | ExtractedMemory[];
     reviewCreateRequest(request: CreateMemoryRequest): Promise<MemoryReview> | MemoryReview;
 }
-/** Create the memory-owned agent that reviews and extracts memory candidates. */
+/** Create the memory-owned agent that reviews, extracts, and recalls memories. */
 export declare function createMemoryAgent(model: PluginModel): MemoryAgent;
 /** Parse the canonical extracted-memory shape stored across task retries. */
 export declare function parseExtractedMemory(memory: unknown): ExtractedMemory;

package/dist/api.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Authenticated REST resources for personal memories.
+ *
+ * HTTP identity is one verified viewer. Linked platform actors are resolved
+ * behind the route boundary and used only to authorize personal scopes.
+ */
+import { z } from "zod";
+import { type PluginRouteApp, type PluginUserPageActor } from "@sentry/junior-plugin-api";
+import type { MemoryDb } from "./store";
+export declare const memoryApiSchema: z.ZodObject<{
+    content: z.ZodString;
+    createdAt: z.ZodISODateTime;
+    expiresAt: z.ZodOptional<z.ZodISODateTime>;
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        preference: "preference";
+        procedure: "procedure";
+        knowledge: "knowledge";
+    }>;
+    observedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const memoryListResponseSchema: z.ZodObject<{
+    memories: z.ZodArray<z.ZodObject<{
+        content: z.ZodString;
+        createdAt: z.ZodISODateTime;
+        expiresAt: z.ZodOptional<z.ZodISODateTime>;
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            preference: "preference";
+            procedure: "procedure";
+            knowledge: "knowledge";
+        }>;
+        observedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    nextCursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type MemoryApi = z.output<typeof memoryApiSchema>;
+export type MemoryListResponse = z.output<typeof memoryListResponseSchema>;
+interface MemoryApiOptions {
+    actors(email: string): Promise<PluginUserPageActor[]>;
+    db: MemoryDb;
+}
+/** Create the authenticated personal-memory REST app. */
+export declare function createMemoryApi(options: MemoryApiOptions): PluginRouteApp;
+export {};

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-export { createMemoryPlugin, memoryPlugin } from "./plugin";
+export { memoryPlugin } from "./plugin";
+export { memoryApiSchema, memoryListResponseSchema, type MemoryApi, type MemoryListResponse, } from "./api";
 export type { MemoryPluginOptions } from "./plugin";
 export { createMemoryStore } from "./store";
 export type { ArchiveMemoryInput, CreateMemoryInput, CreateMemoryResult, ListMemoriesInput, MemoryDb, MemoryEmbeddingProvider, MemoryRecord, MemoryStore, MemoryStoreOptions, SearchMemoriesInput, } from "./store";