@sentry/junior-memory 0.198.0 → 0.199.0

package/dist/store.d.ts

@@ -1,229 +0,0 @@
-import { type SQL } from "drizzle-orm";
-import type { PgDatabase } from "drizzle-orm/pg-core";
-import type { PgQueryResultHKT } from "drizzle-orm/pg-core/session";
-import { z } from "zod";
-import * as memorySqlSchema from "./db/schema";
-import { type MemoryRuntimeContext } from "./types";
-import { type ResolvedMemoryScope } from "./scope";
-export type MemoryDb = PgDatabase<PgQueryResultHKT, typeof memorySqlSchema>;
-declare const createMemoryInputSchema: z.ZodObject<{
-    content: z.ZodString;
-    expiresAtMs: z.ZodOptional<z.ZodNumber>;
-    idempotencyKey: z.ZodString;
-    kind: z.ZodEnum<{
-        preference: "preference";
-        procedure: "procedure";
-        knowledge: "knowledge";
-    }>;
-}, z.core.$strict>;
-declare const listMemoriesInputSchema: z.ZodObject<{
-    limit: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strict>;
-declare const searchMemoriesInputSchema: z.ZodObject<{
-    limit: z.ZodOptional<z.ZodNumber>;
-    query: z.ZodString;
-}, z.core.$strict>;
-declare const archiveMemoryInputSchema: z.ZodObject<{
-    id: z.ZodString;
-    reason: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-declare const archiveExpiredMemoriesInputSchema: z.ZodObject<{
-    limit: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strict>;
-declare const memoryRecordSchema: z.ZodObject<{
-    archivedAtMs: z.ZodOptional<z.ZodNumber>;
-    archiveReason: z.ZodOptional<z.ZodString>;
-    content: z.ZodString;
-    createdAtMs: z.ZodNumber;
-    expiresAtMs: z.ZodOptional<z.ZodNumber>;
-    id: z.ZodString;
-    observedAtMs: z.ZodNumber;
-    scope: z.ZodEnum<{
-        public: "public";
-        private: "private";
-    }>;
-    subjectType: z.ZodEnum<{
-        user: "user";
-        conversation: "conversation";
-        general: "general";
-    }>;
-    supersededAtMs: z.ZodOptional<z.ZodNumber>;
-    supersededById: z.ZodOptional<z.ZodString>;
-    kind: z.ZodEnum<{
-        preference: "preference";
-        procedure: "procedure";
-        knowledge: "knowledge";
-    }>;
-}, z.core.$strict>;
-/** Validated preference comparison input supplied to a supersession decider. */
-export declare const memorySupersessionInputSchema: z.ZodObject<{
-    candidate: z.ZodObject<{
-        content: z.ZodString;
-        kind: z.ZodLiteral<"preference">;
-    }, z.core.$strict>;
-    existingMemories: z.ZodArray<z.ZodObject<{
-        content: z.ZodString;
-        id: z.ZodString;
-    }, z.core.$strict>>;
-    runtimeContext: z.ZodObject<{
-        conversationId: z.ZodOptional<z.ZodString>;
-        locationId: z.ZodOptional<z.ZodString>;
-        actor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
-            platform: z.ZodLiteral<"slack">;
-            teamId: z.ZodString;
-            email: z.ZodOptional<z.ZodString>;
-            fullName: z.ZodOptional<z.ZodString>;
-            userId: z.ZodString;
-            userName: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>, z.ZodObject<{
-            platform: z.ZodLiteral<"local">;
-            email: z.ZodOptional<z.ZodString>;
-            fullName: z.ZodOptional<z.ZodString>;
-            userId: z.ZodString;
-            userName: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>, z.ZodObject<{
-            platform: z.ZodLiteral<"web">;
-            email: z.ZodOptional<z.ZodString>;
-            fullName: z.ZodOptional<z.ZodString>;
-            userId: z.ZodString;
-            userName: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>, z.ZodObject<{
-            platform: z.ZodLiteral<"system">;
-            name: z.ZodString;
-        }, z.core.$strict>], "platform">>;
-        source: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
-            kind: z.ZodLiteral<"slack">;
-            teamId: z.ZodString;
-            channelId: z.ZodString;
-            visibility: z.ZodEnum<{
-                public: "public";
-                private: "private";
-            }>;
-            messageTs: z.ZodOptional<z.ZodString>;
-            threadTs: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>, z.ZodObject<{
-            kind: z.ZodLiteral<"local">;
-            visibility: z.ZodLiteral<"private">;
-            conversationId: z.ZodString;
-        }, z.core.$strict>, z.ZodObject<{
-            kind: z.ZodLiteral<"web">;
-            visibility: z.ZodEnum<{
-                public: "public";
-                private: "private";
-            }>;
-            conversationId: z.ZodString;
-        }, z.core.$strict>, z.ZodObject<{
-            kind: z.ZodLiteral<"resource_event">;
-            eventKey: z.ZodString;
-            eventType: z.ZodString;
-            identifier: z.ZodString;
-            namespace: z.ZodString;
-        }, z.core.$strict>, z.ZodObject<{
-            kind: z.ZodLiteral<"scheduled_task">;
-        }, z.core.$strict>, z.ZodObject<{
-            kind: z.ZodLiteral<"event_task">;
-        }, z.core.$strict>, z.ZodObject<{
-            kind: z.ZodLiteral<"plugin_dispatch">;
-        }, z.core.$strict>, z.ZodObject<{
-            kind: z.ZodLiteral<"agent_invocation">;
-        }, z.core.$strict>], "kind">, unknown>;
-        userId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>;
-}, z.core.$strict>;
-/**
- * Validated preference decision whose referenced ids must come from the
- * supplied existing memories.
- */
-export declare const memorySupersessionDecisionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    decision: z.ZodLiteral<"duplicate">;
-    duplicateId: z.ZodString;
-}, z.core.$strict>, z.ZodObject<{
-    decision: z.ZodLiteral<"supersedes_old">;
-    supersededIds: z.ZodArray<z.ZodString>;
-}, z.core.$strict>, z.ZodObject<{
-    decision: z.ZodEnum<{
-        distinct: "distinct";
-        uncertain: "uncertain";
-    }>;
-}, z.core.$strict>], "decision">;
-export type MemoryRecord = z.output<typeof memoryRecordSchema>;
-export type CreateMemoryInput = z.output<typeof createMemoryInputSchema>;
-/** Result of a memory write after idempotency checks. */
-export interface CreateMemoryResult {
-    created: boolean;
-    /** True when this call found the memory previously written for the same input identity. */
-    idempotent?: true;
-    memory: MemoryRecord;
-    /** Memory ids made inactive by this write. */
-    supersededIds?: string[];
-}
-export type ListMemoriesInput = z.output<typeof listMemoriesInputSchema>;
-export type SearchMemoriesInput = z.output<typeof searchMemoriesInputSchema>;
-export type ArchiveMemoryInput = z.output<typeof archiveMemoryInputSchema>;
-export type ArchiveExpiredMemoriesInput = z.output<typeof archiveExpiredMemoriesInputSchema>;
-export interface ArchiveExpiredMemoriesResult {
-    archivedCount: number;
-}
-export interface MemoryEmbeddingProvider {
-    /** Embed normalized memory text for derived vector retrieval. */
-    embedTexts(input: {
-        texts: string[];
-    }): Promise<{
-        costUsd?: number;
-        dimensions: number;
-        model: string;
-        provider: string;
-        vectors: number[][];
-    }>;
-}
-export type MemorySupersessionInput = z.output<typeof memorySupersessionInputSchema>;
-export type MemorySupersessionDecision = z.output<typeof memorySupersessionDecisionSchema>;
-export interface MemorySupersessionDecider {
-    /** Classify a new preference against related active preferences. */
-    adjudicateSupersession(input: MemorySupersessionInput): Promise<MemorySupersessionDecision> | MemorySupersessionDecision;
-}
-export interface MemoryStoreOptions {
-    embedder?: MemoryEmbeddingProvider;
-    now?: () => number;
-    supersessionDecider?: MemorySupersessionDecider;
-}
-/** Context-bound storage operations for visible long-term memories. */
-export interface MemoryStore {
-    /** Archive expired memories visible in the current runtime context. */
-    archiveExpiredMemories(input?: ArchiveExpiredMemoriesInput): Promise<ArchiveExpiredMemoriesResult>;
-    /** Archive a visible memory in the current runtime context. */
-    archiveMemory(input: ArchiveMemoryInput): Promise<MemoryRecord>;
-    /** Store a memory about the current User. The Source sets access. */
-    createMemory(input: CreateMemoryInput): Promise<CreateMemoryResult>;
-    /** Store a memory about the current Conversation. The Source sets access. */
-    createConversationMemory(input: CreateMemoryInput): Promise<CreateMemoryResult>;
-    /** List active memories visible in the current runtime context. */
-    listMemories(input: ListMemoriesInput): Promise<MemoryRecord[]>;
-    /**
-     * Retrieve a broad relevance-ranked candidate window for automatic recall.
-     * Prompt admission remains owned by the recall boundary.
-     */
-    recallMemories(input: SearchMemoriesInput): Promise<MemoryRecord[]>;
-    /** Search active memories visible in the current runtime context. */
-    searchMemories(input: SearchMemoriesInput): Promise<MemoryRecord[]>;
-}
-/** Parse one SQL row into the public memory projection. */
-export declare function parseMemoryRow(row: unknown): MemoryRecord;
-/** Build the active-row predicate for already-authorized memory scopes. */
-export declare function activeVisiblePredicate(args: {
-    nowMs: number;
-    scopes: ResolvedMemoryScope[];
-}): SQL | undefined;
-/**
- * Archive a bounded batch of expired active rows and remove their derived vectors.
- */
-export declare function archiveExpiredMemoryBatch(args: {
-    db: MemoryDb;
-    idempotencyKey?: string;
-    limit?: number;
-    nowMs: number;
-    scopes: ResolvedMemoryScope[];
-}): Promise<ArchiveExpiredMemoriesResult>;
-/** Create a context-bound SQL-backed store for explicit memory operations. */
-export declare function createMemoryStore(db: MemoryDb, context: MemoryRuntimeContext, options?: MemoryStoreOptions): MemoryStore;
-export {};

package/dist/tools.d.ts

@@ -1,164 +0,0 @@
-import { type Source, type Actor, type Identity, type User } from "@sentry/junior-plugin-api";
-import { type MemoryEmbeddingProvider, type MemoryDb, type MemorySupersessionDecider } from "./store";
-import { type MemoryAgent } from "./agent";
-export type MemoryReviewer = Pick<MemoryAgent, "reviewCreateRequest">;
-/** Runtime-owned context used to bind memory tools to visible scopes. */
-export interface MemoryToolContext {
-    agent: MemoryReviewer;
-    conversationId?: string;
-    db: MemoryDb;
-    embedder?: MemoryEmbeddingProvider;
-    locationId?: string;
-    actor?: Actor;
-    source: Source;
-    users: {
-        resolveActor(): Promise<{
-            identity: Identity;
-            user?: User;
-        } | undefined>;
-    };
-    userText?: string;
-}
-export interface MemoryCreateToolContext extends MemoryToolContext {
-    supersessionDecider?: MemorySupersessionDecider;
-}
-/** Create a tool that submits an explicit memory candidate for storage. */
-export declare function createMemoryCreateTool(context: MemoryCreateToolContext): import("@sentry/junior-plugin-api").PluginToolDefinition<{
-    content: string;
-    expires_at?: string | undefined;
-}, {
-    [x: string]: unknown;
-    target: string;
-    created: boolean;
-    memory: {
-        id: string;
-        content: string;
-        createdAtMs: number;
-        observedAtMs: number;
-        expiresAtMs?: number | undefined;
-    };
-    truncated?: boolean | undefined;
-    continuation?: {
-        arguments: Record<string, unknown>;
-        reason?: string | undefined;
-    } | undefined;
-}, {
-    [x: string]: unknown;
-    target: string;
-    created: boolean;
-    memory: {
-        id: string;
-        content: string;
-        createdAtMs: number;
-        observedAtMs: number;
-        expiresAtMs?: number | undefined;
-    };
-    truncated?: boolean | undefined;
-    continuation?: {
-        arguments: Record<string, unknown>;
-        reason?: string | undefined;
-    } | undefined;
-}>;
-/** Create a tool that archives a visible memory in the active context. */
-export declare function createMemoryRemoveTool(context: MemoryToolContext): import("@sentry/junior-plugin-api").PluginToolDefinition<{
-    id: string;
-}, {
-    [x: string]: unknown;
-    target: string;
-    memory: {
-        id: string;
-        content: string;
-        createdAtMs: number;
-        observedAtMs: number;
-        expiresAtMs?: number | undefined;
-    };
-    truncated?: boolean | undefined;
-    continuation?: {
-        arguments: Record<string, unknown>;
-        reason?: string | undefined;
-    } | undefined;
-}, {
-    [x: string]: unknown;
-    target: string;
-    memory: {
-        id: string;
-        content: string;
-        createdAtMs: number;
-        observedAtMs: number;
-        expiresAtMs?: number | undefined;
-    };
-    truncated?: boolean | undefined;
-    continuation?: {
-        arguments: Record<string, unknown>;
-        reason?: string | undefined;
-    } | undefined;
-}>;
-/** Create a tool that lists visible active memories in the active context. */
-export declare function createMemoryListTool(context: MemoryToolContext): import("@sentry/junior-plugin-api").PluginToolDefinition<{
-    limit?: number | undefined;
-}, {
-    [x: string]: unknown;
-    target: string;
-    memories: {
-        id: string;
-        content: string;
-        createdAtMs: number;
-        observedAtMs: number;
-        expiresAtMs?: number | undefined;
-    }[];
-    truncated?: boolean | undefined;
-    continuation?: {
-        arguments: Record<string, unknown>;
-        reason?: string | undefined;
-    } | undefined;
-}, {
-    [x: string]: unknown;
-    target: string;
-    memories: {
-        id: string;
-        content: string;
-        createdAtMs: number;
-        observedAtMs: number;
-        expiresAtMs?: number | undefined;
-    }[];
-    truncated?: boolean | undefined;
-    continuation?: {
-        arguments: Record<string, unknown>;
-        reason?: string | undefined;
-    } | undefined;
-}>;
-/** Create a tool that searches visible active memories in the active context. */
-export declare function createMemorySearchTool(context: MemoryToolContext): import("@sentry/junior-plugin-api").PluginToolDefinition<{
-    query: string;
-    limit?: number | undefined;
-}, {
-    [x: string]: unknown;
-    target: string;
-    memories: {
-        id: string;
-        content: string;
-        createdAtMs: number;
-        observedAtMs: number;
-        expiresAtMs?: number | undefined;
-    }[];
-    truncated?: boolean | undefined;
-    continuation?: {
-        arguments: Record<string, unknown>;
-        reason?: string | undefined;
-    } | undefined;
-}, {
-    [x: string]: unknown;
-    target: string;
-    memories: {
-        id: string;
-        content: string;
-        createdAtMs: number;
-        observedAtMs: number;
-        expiresAtMs?: number | undefined;
-    }[];
-    truncated?: boolean | undefined;
-    continuation?: {
-        arguments: Record<string, unknown>;
-        reason?: string | undefined;
-    } | undefined;
-}>;

package/dist/types.d.ts

@@ -1,78 +0,0 @@
-import { z } from "zod";
-export declare const MEMORY_KINDS: readonly ["preference", "procedure", "knowledge"];
-export declare const MEMORY_SCOPES: readonly ["private", "public"];
-export declare const MEMORY_SUBJECT_TYPES: readonly ["user", "conversation", "general"];
-export declare const MEMORY_SOURCE_PLATFORMS: readonly ["slack", "local", "web"];
-export declare const MEMORY_EMBEDDING_METRICS: readonly ["cosine"];
-export declare const MEMORY_EMBEDDING_DIMENSIONS = 1536;
-export type MemoryKind = (typeof MEMORY_KINDS)[number];
-export type MemoryScope = (typeof MEMORY_SCOPES)[number];
-export type MemorySubjectType = (typeof MEMORY_SUBJECT_TYPES)[number];
-export type MemorySourcePlatform = (typeof MEMORY_SOURCE_PLATFORMS)[number];
-export type MemoryEmbeddingMetric = (typeof MEMORY_EMBEDDING_METRICS)[number];
-/** Host data used to set memory access, subject, and source. */
-export declare const memoryRuntimeContextSchema: z.ZodObject<{
-    conversationId: z.ZodOptional<z.ZodString>;
-    locationId: z.ZodOptional<z.ZodString>;
-    actor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        platform: z.ZodLiteral<"slack">;
-        teamId: z.ZodString;
-        email: z.ZodOptional<z.ZodString>;
-        fullName: z.ZodOptional<z.ZodString>;
-        userId: z.ZodString;
-        userName: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        platform: z.ZodLiteral<"local">;
-        email: z.ZodOptional<z.ZodString>;
-        fullName: z.ZodOptional<z.ZodString>;
-        userId: z.ZodString;
-        userName: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        platform: z.ZodLiteral<"web">;
-        email: z.ZodOptional<z.ZodString>;
-        fullName: z.ZodOptional<z.ZodString>;
-        userId: z.ZodString;
-        userName: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        platform: z.ZodLiteral<"system">;
-        name: z.ZodString;
-    }, z.core.$strict>], "platform">>;
-    source: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        kind: z.ZodLiteral<"slack">;
-        teamId: z.ZodString;
-        channelId: z.ZodString;
-        visibility: z.ZodEnum<{
-            public: "public";
-            private: "private";
-        }>;
-        messageTs: z.ZodOptional<z.ZodString>;
-        threadTs: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"local">;
-        visibility: z.ZodLiteral<"private">;
-        conversationId: z.ZodString;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"web">;
-        visibility: z.ZodEnum<{
-            public: "public";
-            private: "private";
-        }>;
-        conversationId: z.ZodString;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"resource_event">;
-        eventKey: z.ZodString;
-        eventType: z.ZodString;
-        identifier: z.ZodString;
-        namespace: z.ZodString;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"scheduled_task">;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"event_task">;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"plugin_dispatch">;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"agent_invocation">;
-    }, z.core.$strict>], "kind">, unknown>;
-    userId: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-export type MemoryRuntimeContext = z.output<typeof memoryRuntimeContextSchema>;

package/dist/user-pages.d.ts

@@ -1,4 +0,0 @@
-/** Render memory in Junior's User page format. */
-import type { PluginUserPageDefinition } from "@sentry/junior-plugin-api";
-/** Create the interactive Memories dashboard page. */
-export declare function createMemoryUserPage(): PluginUserPageDefinition;

package/dist/viewer.d.ts

@@ -1,91 +0,0 @@
-import { z } from "zod";
-import { type MemoryDb, type MemoryRecord } from "./store";
-import { type MemorySourcePlatform } from "./types";
-declare const memoryVisibilitySchema: z.ZodEnum<{
-    public: "public";
-    private: "private";
-}>;
-declare const pageInputSchema: z.ZodObject<{
-    cursor: z.ZodOptional<z.ZodString>;
-    kind: z.ZodOptional<z.ZodEnum<{
-        preference: "preference";
-        procedure: "procedure";
-        knowledge: "knowledge";
-    }>>;
-    limit: z.ZodNumber;
-    origin: z.ZodOptional<z.ZodEnum<{
-        automatic: "automatic";
-        explicit: "explicit";
-    }>>;
-    query: z.ZodOptional<z.ZodString>;
-    visibility: z.ZodOptional<z.ZodEnum<{
-        public: "public";
-        private: "private";
-    }>>;
-}, z.core.$strict>;
-/** Access label returned by dashboard and REST memory views. */
-export type MemoryVisibility = z.output<typeof memoryVisibilitySchema>;
-/** Memory fields returned to an authenticated User. */
-export type MemoryView = MemoryRecord & {
-    origin: "automatic" | "explicit" | "other";
-    sourcePlatform: MemorySourcePlatform;
-    visibility: MemoryVisibility;
-};
-interface MemoryPage {
-    memories: MemoryView[];
-    nextCursor?: string;
-}
-type MemoryPageInput = z.output<typeof pageInputSchema>;
-/** Expected error for a malformed or mismatched page cursor. */
-export declare class InvalidMemoryCursorError extends Error {
-    constructor();
-}
-/** Expected error when the current User cannot access a memory. */
-export declare class MemoryNotFoundError extends Error {
-    constructor();
-}
-/** Archive one active private memory owned by the authenticated User. */
-export declare function archiveMemory(db: MemoryDb, userId: string, id: string): Promise<{
-    content: string;
-    createdAtMs: number;
-    id: string;
-    observedAtMs: number;
-    scope: "public" | "private";
-    subjectType: "user" | "conversation" | "general";
-    kind: "preference" | "procedure" | "knowledge";
-    archivedAtMs?: number | undefined;
-    archiveReason?: string | undefined;
-    expiresAtMs?: number | undefined;
-    supersededAtMs?: number | undefined;
-    supersededById?: string | undefined;
-}>;
-/** Read one active memory visible to the authenticated User. */
-export declare function getMemory(db: MemoryDb, userId: string, id: string): Promise<MemoryView>;
-/** List one stable page of active memory visible to the authenticated User. */
-export declare function listMemories(db: MemoryDb, userId: string, input: MemoryPageInput): Promise<MemoryPage>;
-/** Summarize active memory visible to the authenticated User. */
-export declare function getMemoryStats(db: MemoryDb, userId: string): Promise<{
-    active: number;
-    automatic: number;
-    createdThirtyDays: number;
-    embedded: number;
-    explicit: number;
-    knowledge: number;
-    private: number;
-    preference: number;
-    procedure: number;
-    public: number;
-}>;
-/** Read daily memory creation totals visible to the authenticated User in UTC. */
-export declare function getMemoryTimeline(db: MemoryDb, userId: string, days: number): Promise<{
-    date: string;
-    private: number;
-    public: number;
-}[]>;
-/** Read hourly memory creation totals visible to the authenticated User in UTC. */
-export declare function getMemoryTimelineHours(db: MemoryDb, userId: string, hours?: number): Promise<{
-    date: string;
-    private: number;
-    public: number;
-}[]>;
-export {};