@sentry/junior-memory 0.198.0 → 0.200.0

package/dist/db/schema.d.ts

@@ -1,479 +0,0 @@
-export declare const juniorMemoryMemories: import("drizzle-orm/pg-core").PgTableWithColumns<{
-    name: "junior_memory_memories";
-    schema: undefined;
-    columns: {
-        id: import("drizzle-orm/pg-core").PgColumn<{
-            name: "id";
-            tableName: "junior_memory_memories";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: true;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        scope: import("drizzle-orm/pg-core").PgColumn<{
-            name: "scope";
-            tableName: "junior_memory_memories";
-            dataType: "string";
-            columnType: "PgText";
-            data: "public" | "private";
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: ["private", "public"];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        scopeKey: import("drizzle-orm/pg-core").PgColumn<{
-            name: "scope_key";
-            tableName: "junior_memory_memories";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        kind: import("drizzle-orm/pg-core").PgColumn<{
-            name: "type";
-            tableName: "junior_memory_memories";
-            dataType: "string";
-            columnType: "PgText";
-            data: "preference" | "procedure" | "knowledge";
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: ["preference", "procedure", "knowledge"];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        subjectType: import("drizzle-orm/pg-core").PgColumn<{
-            name: "subject_type";
-            tableName: "junior_memory_memories";
-            dataType: "string";
-            columnType: "PgText";
-            data: "user" | "conversation" | "general";
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: ["user", "conversation", "general"];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        subjectKey: import("drizzle-orm/pg-core").PgColumn<{
-            name: "subject_key";
-            tableName: "junior_memory_memories";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        content: import("drizzle-orm/pg-core").PgColumn<{
-            name: "content";
-            tableName: "junior_memory_memories";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        searchVector: import("drizzle-orm/pg-core").PgColumn<{
-            name: "search_vector";
-            tableName: "junior_memory_memories";
-            dataType: "custom";
-            columnType: "PgCustomColumn";
-            data: string;
-            driverParam: unknown;
-            notNull: false;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: {
-                type: "always";
-            };
-        }, {}, {
-            pgColumnBuilderBrand: "PgCustomColumnBuilderBrand";
-        }>;
-        sourcePlatform: import("drizzle-orm/pg-core").PgColumn<{
-            name: "source_platform";
-            tableName: "junior_memory_memories";
-            dataType: "string";
-            columnType: "PgText";
-            data: "slack" | "local" | "web";
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: ["slack", "local", "web"];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        sourceKey: import("drizzle-orm/pg-core").PgColumn<{
-            name: "source_key";
-            tableName: "junior_memory_memories";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        locationId: import("drizzle-orm/pg-core").PgColumn<{
-            name: "location_id";
-            tableName: "junior_memory_memories";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        idempotencyKey: import("drizzle-orm/pg-core").PgColumn<{
-            name: "idempotency_key";
-            tableName: "junior_memory_memories";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        observedAtMs: import("drizzle-orm/pg-core").PgColumn<{
-            name: "observed_at_ms";
-            tableName: "junior_memory_memories";
-            dataType: "number";
-            columnType: "PgBigInt53";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        createdAtMs: import("drizzle-orm/pg-core").PgColumn<{
-            name: "created_at_ms";
-            tableName: "junior_memory_memories";
-            dataType: "number";
-            columnType: "PgBigInt53";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        expiresAtMs: import("drizzle-orm/pg-core").PgColumn<{
-            name: "expires_at_ms";
-            tableName: "junior_memory_memories";
-            dataType: "number";
-            columnType: "PgBigInt53";
-            data: number;
-            driverParam: string | number;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        supersededAtMs: import("drizzle-orm/pg-core").PgColumn<{
-            name: "superseded_at_ms";
-            tableName: "junior_memory_memories";
-            dataType: "number";
-            columnType: "PgBigInt53";
-            data: number;
-            driverParam: string | number;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        supersededById: import("drizzle-orm/pg-core").PgColumn<{
-            name: "superseded_by_id";
-            tableName: "junior_memory_memories";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        archivedAtMs: import("drizzle-orm/pg-core").PgColumn<{
-            name: "archived_at_ms";
-            tableName: "junior_memory_memories";
-            dataType: "number";
-            columnType: "PgBigInt53";
-            data: number;
-            driverParam: string | number;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        archiveReason: import("drizzle-orm/pg-core").PgColumn<{
-            name: "archive_reason";
-            tableName: "junior_memory_memories";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
-export declare const juniorMemoryEmbeddings: import("drizzle-orm/pg-core").PgTableWithColumns<{
-    name: "junior_memory_embeddings";
-    schema: undefined;
-    columns: {
-        memoryId: import("drizzle-orm/pg-core").PgColumn<{
-            name: "memory_id";
-            tableName: "junior_memory_embeddings";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: true;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        provider: import("drizzle-orm/pg-core").PgColumn<{
-            name: "provider";
-            tableName: "junior_memory_embeddings";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        model: import("drizzle-orm/pg-core").PgColumn<{
-            name: "model";
-            tableName: "junior_memory_embeddings";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        dimensions: import("drizzle-orm/pg-core").PgColumn<{
-            name: "dimensions";
-            tableName: "junior_memory_embeddings";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        metric: import("drizzle-orm/pg-core").PgColumn<{
-            name: "metric";
-            tableName: "junior_memory_embeddings";
-            dataType: "string";
-            columnType: "PgText";
-            data: "cosine";
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: ["cosine"];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        contentHash: import("drizzle-orm/pg-core").PgColumn<{
-            name: "content_hash";
-            tableName: "junior_memory_embeddings";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        embedding: import("drizzle-orm/pg-core").PgColumn<{
-            name: "embedding";
-            tableName: "junior_memory_embeddings";
-            dataType: "array";
-            columnType: "PgVector";
-            data: number[];
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            dimensions: 1536;
-        }>;
-        createdAtMs: import("drizzle-orm/pg-core").PgColumn<{
-            name: "created_at_ms";
-            tableName: "junior_memory_embeddings";
-            dataType: "number";
-            columnType: "PgBigInt53";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-    };
-    dialect: "pg";
-}>;

package/dist/events.d.ts

@@ -1,35 +0,0 @@
-import type { MemoryRecord } from "./store";
-/** Previous stored memory-capture event shape retained for transcript rendering. */
-export declare const memoriesCapturedEventV1: import("@sentry/junior-plugin-api").DefinedConversationEvent<{
-    memories: {
-        scope: "conversation" | "personal";
-        content: string;
-        id: string;
-        kind: "preference" | "procedure" | "knowledge";
-        observedAtMs: number;
-    }[];
-}>;
-/** Durable outcome emitted after every completed passive memory extraction. */
-export declare const memoriesCapturedEvent: import("@sentry/junior-plugin-api").DefinedConversationEvent<{
-    memories: {
-        scope: "public" | "private";
-        content: string;
-        id: string;
-        kind: "preference" | "procedure" | "knowledge";
-        observedAtMs: number;
-    }[];
-    costUsd?: number | undefined;
-}>;
-/** Durable outcome emitted after one completed automatic recall attempt. */
-export declare const memoriesRecalledEvent: import("@sentry/junior-plugin-api").DefinedConversationEvent<{
-    memories: string[];
-    costUsd?: number | undefined;
-}>;
-/** 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: "public" | "private";
-};

package/dist/operational-report.d.ts

@@ -1,8 +0,0 @@
-import type { PluginConversationEventCostDay, PluginOperationalReportContent } from "@sentry/junior-plugin-api";
-import type { MemoryDb } from "./store";
-/** Build aggregate memory storage and indexing diagnostics for the System page. */
-export declare function buildMemoryOperationalReport(args: {
-    db: MemoryDb;
-    extractionDays: PluginConversationEventCostDay[];
-    nowMs: number;
-}): Promise<PluginOperationalReportContent>;

package/dist/plugin.d.ts

@@ -1,9 +0,0 @@
-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;
-}
-/** Register Junior's long-term memory plugin. */
-export declare function memoryPlugin(options?: MemoryPluginOptions): import("@sentry/junior-plugin-api").PluginRegistration;

package/dist/process-session.d.ts

@@ -1,9 +0,0 @@
-import { type PluginTaskContext } from "@sentry/junior-plugin-api";
-/**
- * Extract and store memories from a completed session plugin task.
- *
- * Memory owns learning after a run and reads only the plugin run data.
- * Explicit memory tools stay separate so retries do not reinterpret user
- * requests.
- */
-export declare function processMemorySession(context: PluginTaskContext): Promise<void>;

package/dist/ranking.d.ts

@@ -1,18 +0,0 @@
-import type { MemoryRecord } from "./store";
-export interface MemoryMatch {
-    lexical?: {
-        rank: number;
-    };
-    memory: MemoryRecord;
-    vector?: {
-        rank: number;
-    };
-}
-/** Fuse lexical and vector ranks without comparing provider raw scores. */
-export declare function rankMemoryMatches(matches: MemoryMatch[], options: {
-    /** 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

@@ -1,41 +0,0 @@
-import { type UserPromptContribution, type Actor, type Identity, type PluginConversationEvents, type PluginLogger, type Source, type User } from "@sentry/junior-plugin-api";
-import { z } from "zod";
-import type { MemoryAgent } from "./agent";
-import { type MemoryDb, type MemoryEmbeddingProvider } from "./store";
-export interface MemoryRecallContext {
-    agent: Pick<MemoryAgent, "selectRelevantMemories">;
-    conversationId?: string;
-    db: MemoryDb;
-    embedder?: MemoryEmbeddingProvider;
-    events?: PluginConversationEvents;
-    log: PluginLogger;
-    locationId?: string;
-    actor?: Actor;
-    source: Source;
-    text: string;
-    users: {
-        resolveActor(): Promise<{
-            identity: Identity;
-            user?: User;
-        } | undefined>;
-    };
-}
-/** Structured snapshot retained for one automatic memory recall. */
-export declare const memoryRecallContextSchema: z.ZodObject<{
-    memories: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        content: z.ZodString;
-        observedAtMs: z.ZodNumber;
-        scope: z.ZodEnum<{
-            conversation: "conversation";
-            personal: "personal";
-        }>;
-        kind: z.ZodEnum<{
-            preference: "preference";
-            procedure: "procedure";
-            knowledge: "knowledge";
-        }>;
-    }, z.core.$strict>>;
-}, z.core.$strict>;
-/** Build active memory recall contributions. */
-export declare function createMemoryPromptContributions(context: MemoryRecallContext): Promise<UserPromptContribution[] | undefined>;

package/dist/scope.d.ts

@@ -1,19 +0,0 @@
-import type { MemoryRuntimeContext, MemoryScope, MemorySubjectType } from "./types";
-/** Stored memory access rule. */
-export interface ResolvedMemoryScope {
-    scope: MemoryScope;
-    scopeKey: string;
-}
-/** What a stored memory is about. */
-export interface ResolvedMemorySubject {
-    subjectKey: string;
-    subjectType: Extract<MemorySubjectType, "user" | "conversation">;
-}
-/** Public memories are visible everywhere. */
-export declare const publicMemoryScope: ResolvedMemoryScope;
-/** Set memory access from the Source. */
-export declare function deriveMemoryScope(ctx: MemoryRuntimeContext): ResolvedMemoryScope;
-/** Set what a memory is about. Access is set separately. */
-export declare function deriveMemorySubject(ctx: MemoryRuntimeContext, subjectType: Extract<MemorySubjectType, "user" | "conversation">): ResolvedMemorySubject;
-/** Return the memory scopes that the current User can access. */
-export declare function deriveVisibleMemoryScopes(ctx: MemoryRuntimeContext): ResolvedMemoryScope[];