@sentry/junior-memory 0.191.0 → 0.193.0

package/dist/store.d.ts

@@ -118,6 +118,14 @@ export declare const memorySupersessionInputSchema: z.ZodObject<{
             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>;

package/dist/types.d.ts

@@ -64,6 +64,14 @@ export declare const memoryRuntimeContextSchema: z.ZodObject<{
         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>;

package/dist/viewer.d.ts

@@ -82,4 +82,10 @@ export declare function getMemoryTimeline(db: MemoryDb, userId: string, days: nu
     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 {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/junior-memory",
-  "version": "0.191.0",
+  "version": "0.193.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -27,7 +27,7 @@
     "commander": "^14.0.3",
     "drizzle-orm": "^0.45.2",
     "zod": "^4.5.4",
-    "@sentry/junior-plugin-api": "0.191.0"
+    "@sentry/junior-plugin-api": "0.193.0"
   },
   "devDependencies": {
     "@oxlint/plugins": "1.79.0",

package/src/agent.ts

@@ -302,6 +302,11 @@ function sourceLabel(source: z.output<typeof sourceSchema>): string {
       return `${source.kind}:${source.conversationId}`;
     case "resource_event":
       return `resource-event:${source.namespace}:${source.eventKey}`;
+    case "scheduled_task":
+    case "event_task":
+    case "plugin_dispatch":
+    case "agent_invocation":
+      return source.kind;
   }
 }
 

package/src/api.ts

@@ -16,6 +16,7 @@ import {
   getMemory,
   getMemoryStats,
   getMemoryTimeline,
+  getMemoryTimelineHours,
   InvalidMemoryCursorError,
   listMemories,
   MemoryNotFoundError,
@@ -44,9 +45,11 @@ export const memoryListResponseSchema = z
   })
   .strict();
 
+const memoryBucketSchema = z.string().regex(/^\d{4}-\d{2}-\d{2}(T\d{2})?$/);
+
 const memoryDashboardDaySchema = z
   .object({
-    date: z.iso.date(),
+    date: memoryBucketSchema,
     personal: z.number().int().min(0),
     public: z.number().int().min(0),
   })
@@ -55,7 +58,7 @@ const memoryDashboardDaySchema = z
 const memoryCostDaySchema = z
   .object({
     costUsd: z.number().finite().nonnegative(),
-    date: z.iso.date(),
+    date: memoryBucketSchema,
     events: z.number().int().min(0),
   })
   .strict();
@@ -64,8 +67,11 @@ export const memoryDashboardResponseSchema = z
   .object({
     days: z.array(memoryDashboardDaySchema).length(90),
     extractionDays: z.array(memoryCostDaySchema).length(90),
+    extractionHours: z.array(memoryCostDaySchema).length(24).optional(),
     generatedAt: z.iso.datetime(),
+    hours: z.array(memoryDashboardDaySchema).length(24).optional(),
     recallDays: z.array(memoryCostDaySchema).length(90),
+    recallHours: z.array(memoryCostDaySchema).length(24).optional(),
     stats: z
       .object({
         active: z.number().int().min(0),
@@ -163,17 +169,32 @@ export function createMemoryApi(options: MemoryApiOptions): PluginRouteApp {
 
       try {
         if (isDashboard && isRead) {
-          const [stats, days, extractionDays, recallDays] = await Promise.all([
+          const [
+            stats,
+            days,
+            hours,
+            extractionDays,
+            extractionHours,
+            recallDays,
+            recallHours,
+          ] = await Promise.all([
             getMemoryStats(options.db, userId),
             getMemoryTimeline(options.db, userId, 90),
+            getMemoryTimelineHours(options.db, userId, 24),
             options.eventStats.costsByDay({
               days: 90,
               eventName: "memories_captured",
             }),
+            options.eventStats.costsByHour({
+              eventName: "memories_captured",
+            }),
             options.eventStats.costsByDay({
               days: 90,
               eventName: "memories_recalled",
             }),
+            options.eventStats.costsByHour({
+              eventName: "memories_recalled",
+            }),
           ]);
           const { private: personal, ...dashboardStats } = stats;
           const body = memoryDashboardResponseSchema.parse({
@@ -182,8 +203,14 @@ export function createMemoryApi(options: MemoryApiOptions): PluginRouteApp {
               personal,
             })),
             extractionDays,
+            extractionHours,
             generatedAt: new Date().toISOString(),
+            hours: hours.map(({ private: personal, ...day }) => ({
+              ...day,
+              personal,
+            })),
             recallDays,
+            recallHours,
             stats: { ...dashboardStats, personal },
           });
           return request.method === "HEAD"

package/src/operational-report.ts

@@ -8,6 +8,7 @@ import { juniorMemoryEmbeddings, juniorMemoryMemories } from "./db/schema";
 import type { MemoryDb } from "./store";
 
 const DAY_MS = 24 * 60 * 60 * 1_000;
+// TODO: add hour categories + `1` when these system widgets can plot 24h hourly.
 const WINDOWS = [7, 30, 90] as const;
 
 const memoryDaySchema = z
@@ -212,7 +213,7 @@ export async function buildMemoryOperationalReport(args: {
             public: day.public,
           },
         })),
-        description: "Memories stored per day by scope",
+        description: "Memories stored by scope",
         id: "memories-created",
         series: [
           { key: "private", label: "Private" },

package/src/process-session.ts

@@ -223,7 +223,9 @@ export async function processMemorySession(
   context: PluginTaskContext,
 ): Promise<void> {
   const run = await context.run.load();
-  if (run.source.kind === "local" || run.source.kind === "resource_event") {
+  // TODO(dcramer): Replace this hardcoded Source check when a plugin Run can
+  // state whether passive memory extraction should run.
+  if (run.source.kind !== "slack" && run.source.kind !== "web") {
     return;
   }
   // Memory tool turns already own memory management or recall; do not reinterpret

package/src/store.ts

@@ -187,10 +187,18 @@ const memoryRowSchema = z
 function storedMemorySource(
   source: MemoryRuntimeContext["source"],
 ): MemorySourcePlatform {
-  if (source.kind === "resource_event") {
-    throw new Error("Resource event Source cannot own a Memory.");
+  switch (source.kind) {
+    case "slack":
+    case "local":
+    case "web":
+      return source.kind;
+    case "resource_event":
+    case "scheduled_task":
+    case "event_task":
+    case "plugin_dispatch":
+    case "agent_invocation":
+      throw new Error(`${source.kind} Source cannot own a Memory.`);
   }
-  return source.kind;
 }
 
 const memoryRecordSchema = z

package/src/viewer.ts

@@ -391,3 +391,51 @@ export async function getMemoryTimeline(
     };
   });
 }
+
+/** Read hourly memory creation totals visible to the authenticated User in UTC. */
+export async function getMemoryTimelineHours(
+  db: MemoryDb,
+  userId: string,
+  hours = 24,
+) {
+  const end = new Date();
+  end.setUTCMinutes(0, 0, 0);
+  const startMs = end.getTime() - (hours - 1) * 60 * 60 * 1_000;
+  const rows = await db
+    .select({
+      date: sql<string>`to_char(to_timestamp(${juniorMemoryMemories.createdAtMs} / 1000.0) AT TIME ZONE 'UTC', 'YYYY-MM-DD"T"HH24')`.as(
+        "date",
+      ),
+      private:
+        sql<number>`count(*) filter (where ${juniorMemoryMemories.scope} = 'private')`.mapWith(
+          Number,
+        ),
+      public:
+        sql<number>`count(*) filter (where ${juniorMemoryMemories.scope} = 'public')`.mapWith(
+          Number,
+        ),
+    })
+    .from(juniorMemoryMemories)
+    .where(
+      and(
+        visibleScopePredicate(userId),
+        gt(juniorMemoryMemories.createdAtMs, startMs - 1),
+      ),
+    )
+    .groupBy(
+      sql`to_char(to_timestamp(${juniorMemoryMemories.createdAtMs} / 1000.0) AT TIME ZONE 'UTC', 'YYYY-MM-DD"T"HH24')`,
+    );
+  const byHour = new Map(rows.map((row) => [row.date, row]));
+  return Array.from({ length: hours }, (_, index) => {
+    const date = new Date(startMs + index * 60 * 60 * 1_000)
+      .toISOString()
+      .slice(0, 13);
+    const row = byHour.get(date);
+    return {
+      date,
+      private: row?.private ?? 0,
+      public: row?.public ?? 0,
+    };
+  });
+}
+