@hexis-ai/engram-server 0.3.0 → 0.5.0

package/dist/storage.d.ts

@@ -1,5 +1,5 @@
 import type { Session } from "@hexis-ai/engram-core";
-import type { PersonCreate, PersonInfo, PersonUpdate, SessionEvent, SessionInit } from "@hexis-ai/engram-sdk";
+import type { AliasInfo, AliasUpsert, PersonCreate, PersonInfo, PersonUpdate, SessionEvent, SessionInit } from "@hexis-ai/engram-sdk";
 /**
  * Storage adapter interface. Each implementation owns persistence for
  * a single workspace's sessions and persons. Multi-tenancy is the host's
@@ -18,6 +18,14 @@ export interface StorageAdapter {
     appendEvents(sessionId: string, events: SessionEvent[]): Promise<void>;
     /** Materialize a session (events folded into Session shape). */
     getSession(sessionId: string): Promise<Session | null>;
+    /**
+     * Raw event log for a session, ordered by `seq`. Unlike `getSession`,
+     * this does not fold events — callers get per-event timestamps and the
+     * participant / title / end events as recorded. Returns `null` when the
+     * session doesn't exist (distinct from an existing session with no
+     * events, which returns `[]`).
+     */
+    getSessionEvents(sessionId: string): Promise<SessionEvent[] | null>;
     /** List recent sessions. */
     listSessions(opts: {
         limit: number;
@@ -52,6 +60,23 @@ export interface StorageAdapter {
         channel?: string;
         scope?: "participant" | "viewable";
     }): Promise<Session[]>;
+    /**
+     * Upsert a name → person mapping. Names collapse case-insensitively
+     * (the row is keyed by `(person_id, lower(name))`).
+     *
+     * - `increment: true` (default): if the alias already exists, bump
+     *   `usage_count` by 1 and replace `caller` / `last_used` with the
+     *   input values.
+     * - `increment: false`: if the row already exists, do not touch it.
+     *
+     * Returns `null` if `personId` does not exist (engram_aliases FKs into
+     * engram_persons).
+     */
+    upsertAlias(personId: string, input: {
+        name: string;
+    } & AliasUpsert): Promise<AliasInfo | null>;
+    /** A person's aliases, ordered newest-used-first. */
+    listAliases(personId: string): Promise<AliasInfo[]>;
 }
 /**
  * Pure fold of an event log into the parts a Session needs. Used by adapters