@hexis-ai/engram-server 0.10.1 → 0.11.1

package/dist/adapters/memory.d.ts

@@ -29,7 +29,11 @@ export declare class InMemoryAdapter implements StorageAdapter {
     listSessions(opts: {
         limit: number;
         channel?: string;
+        channel_prefix?: string;
         status?: "active" | "idle" | "completed";
+        has_trigger?: boolean;
+        no_summary?: boolean;
+        updated_before?: string;
     }): Promise<Session[]>;
     sessionsForPerson(personId: string, opts: {
         limit: number;

package/dist/adapters/memory.js

@@ -147,8 +147,17 @@ export class InMemoryAdapter {
         for (const stored of this.sessions.values()) {
             if (opts.channel && stored.row.channel !== opts.channel)
                 continue;
+            if (opts.channel_prefix &&
+                !(stored.row.channel ?? "").startsWith(opts.channel_prefix))
+                continue;
             if (opts.status && stored.row.status !== opts.status)
                 continue;
+            if (opts.has_trigger && stored.row.trigger_conversation_id == null)
+                continue;
+            if (opts.no_summary && stored.row.summary != null)
+                continue;
+            if (opts.updated_before && stored.row.updatedAt >= opts.updated_before)
+                continue;
             all.push({
                 s: foldEvents(stored.row, [...stored.events.values()], now),
                 updatedAt: stored.row.updatedAt,

package/dist/adapters/postgres.d.ts

@@ -42,7 +42,11 @@ export declare class PostgresAdapter implements StorageAdapter {
     listSessions(opts: {
         limit: number;
         channel?: string;
+        channel_prefix?: string;
         status?: "active" | "idle" | "completed";
+        has_trigger?: boolean;
+        no_summary?: boolean;
+        updated_before?: string;
     }): Promise<Session[]>;
     sessionsForPerson(personId: string, opts: {
         limit: number;

package/dist/adapters/postgres.js

@@ -173,12 +173,20 @@ export class PostgresAdapter {
     }
     async listSessions(opts) {
         const channelFilter = opts.channel ?? null;
+        const channelPrefix = opts.channel_prefix ?? null;
         const statusFilter = opts.status ?? null;
+        const hasTrigger = opts.has_trigger === true;
+        const noSummary = opts.no_summary === true;
+        const updatedBefore = opts.updated_before ?? null;
         const rows = await this.sql `
       SELECT id FROM engram_sessions
       WHERE workspace_id = ${this.workspaceId}
         AND (${channelFilter}::text IS NULL OR channel = ${channelFilter}::text)
+        AND (${channelPrefix}::text IS NULL OR channel LIKE ${channelPrefix ? channelPrefix + "%" : null}::text)
         AND (${statusFilter}::text IS NULL OR status  = ${statusFilter}::text)
+        AND (${hasTrigger}::boolean = FALSE OR trigger_conversation_id IS NOT NULL)
+        AND (${noSummary}::boolean = FALSE OR summary IS NULL)
+        AND (${updatedBefore}::timestamptz IS NULL OR updated_at < ${updatedBefore}::timestamptz)
       ORDER BY updated_at DESC
       LIMIT ${opts.limit}
     `;

package/dist/routes/sessions.js

@@ -63,14 +63,22 @@ export function sessionsRoutes(cfg) {
     app.get("/sessions", async (c) => {
         const limit = clampLimit(c, cfg.defaultListLimit, cfg.maxListLimit);
         const channel = c.req.query("channel") || undefined;
+        const channel_prefix = c.req.query("channel_prefix") || undefined;
         const rawStatus = c.req.query("status");
         const status = rawStatus === "active" || rawStatus === "idle" || rawStatus === "completed"
             ? rawStatus
             : undefined;
+        const has_trigger = c.req.query("has_trigger") === "true" || undefined;
+        const no_summary = c.req.query("no_summary") === "true" || undefined;
+        const updated_before = c.req.query("updated_before") || undefined;
         const sessions = await c.var.ctx.storage.listSessions({
             limit,
             channel,
+            channel_prefix,
             status,
+            has_trigger,
+            no_summary,
+            updated_before,
         });
         const persons = await resolvePersonMap(c.var.ctx.storage, sessions);
         return c.json({ sessions, persons });

package/dist/schemas.d.ts

@@ -112,9 +112,15 @@ export declare const eventBatchSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const personCreateSchema: z.ZodObject<{
     display_name: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    team: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    source: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const personUpdateSchema: z.ZodObject<{
     display_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    team: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    source: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const aliasUpsertSchema: z.ZodObject<{
     caller: z.ZodString;

package/dist/schemas.js

@@ -90,9 +90,15 @@ export const eventBatchSchema = z.object({
 // --- Persons ---------------------------------------------------------
 export const personCreateSchema = z.object({
     display_name: z.string().optional(),
+    role: z.string().nullable().optional(),
+    team: z.string().nullable().optional(),
+    source: z.string().optional(),
 });
 export const personUpdateSchema = z.object({
     display_name: z.string().nullable().optional(),
+    role: z.string().nullable().optional(),
+    team: z.string().nullable().optional(),
+    source: z.string().optional(),
 });
 // --- Aliases ----------------------------------------------------------
 export const aliasUpsertSchema = z.object({

package/dist/storage.d.ts

@@ -33,11 +33,27 @@ export interface StorageAdapter {
      * events, which returns `[]`).
      */
     getSessionEvents(sessionId: string): Promise<SessionEvent[] | null>;
-    /** List recent sessions, ordered by `updated_at` desc. */
+    /**
+     * List recent sessions, ordered by `updated_at` desc.
+     *
+     * Filter combinations are AND'd. Pass `channel_prefix` instead of
+     * `channel` to match channels by prefix (e.g. `slack_dm:C123/`) —
+     * this is the only way to express "any thread under DM Cxxx".
+     * `has_trigger=true` restricts to sessions whose
+     * `trigger_conversation_id` is set; `no_summary=true` restricts to
+     * sessions whose `summary` is null. `updated_before` restricts to
+     * sessions whose `updated_at` is strictly less than the ISO timestamp
+     * — combine with `status='idle' + no_summary=true` to find idle,
+     * unsummarized conversations older than N minutes.
+     */
     listSessions(opts: {
         limit: number;
         channel?: string;
+        channel_prefix?: string;
         status?: "active" | "idle" | "completed";
+        has_trigger?: boolean;
+        no_summary?: boolean;
+        updated_before?: string;
     }): Promise<Session[]>;
     /**
      * Create a person with a freshly allocated id. The host (e.g. monet)

package/openapi.json

@@ -340,6 +340,29 @@
         "properties": {
           "display_name": {
             "type": "string"
+          },
+          "role": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "team": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "source": {
+            "type": "string"
           }
         },
         "additionalProperties": false
@@ -356,6 +379,29 @@
                 "type": "null"
               }
             ]
+          },
+          "role": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "team": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "source": {
+            "type": "string"
           }
         },
         "additionalProperties": false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hexis-ai/engram-server",
-  "version": "0.10.1",
+  "version": "0.11.1",
   "description": "Engram server: ingest agent session events, persist via a pluggable adapter, expose search.",
   "keywords": [
     "engram",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@hexis-ai/engram-core": "^0.2.0",
-    "@hexis-ai/engram-sdk": "^0.9.1",
+    "@hexis-ai/engram-sdk": "^0.10.0",
     "hono": "^4.6.0",
     "zod": "^4.0.0"
   },