@hexis-ai/engram-sdk 0.7.0 → 0.9.0

package/dist/client.d.ts

@@ -117,10 +117,15 @@ export declare class Engram {
      * `null` clears. Returns the materialized session post-update.
      */
     updateSession(id: string, patch: SessionUpdate): Promise<SessionEnvelope>;
-    /** List recent sessions plus the deduped persons map across them. */
+    /**
+     * List recent sessions plus the deduped persons map across them.
+     * Sorted by `updated_at` desc (most recent activity first); pass
+     * `status` to filter by lifecycle state.
+     */
     listSessions(opts?: {
         limit?: number;
         channel?: string;
+        status?: "active" | "idle" | "completed";
     }): Promise<SessionListEnvelope>;
     /** Run a search. */
     search(req: SearchRequest): Promise<SearchEnvelope>;
@@ -172,6 +177,21 @@ export declare class Engram {
         /** Look up by ref. Returns 404 if the ref is unknown. */
         get: (ref: string) => Promise<IdentityInfo>;
     };
+    /**
+     * Workspace-wide alias lookup. `persons.aliases(id)` answers "what
+     * does this person go by"; this answers the inverse — "which
+     * person(s) does this name resolve to?" — without pre-knowing the
+     * owner. Match is case-insensitive; multiple persons can share an
+     * alias, so the response is an array ordered by `last_used` desc.
+     * Inlined `persons` map saves a round-trip for the typical
+     * candidate-picker UI.
+     */
+    readonly aliases: {
+        findByName: (name: string) => Promise<{
+            aliases: AliasInfo[];
+            persons: PersonMap;
+        }>;
+    };
     /** Internal: ship an event batch to the server. */
     sendBatch(sessionId: string, batch: EventBatch): Promise<void>;
     /** Internal accessor used by EngramSession to honor SDK config. */

package/dist/client.js

@@ -57,13 +57,19 @@ export class Engram {
     async updateSession(id, patch) {
         return this.request("PATCH", `/v1/sessions/${encodeURIComponent(id)}`, patch);
     }
-    /** List recent sessions plus the deduped persons map across them. */
+    /**
+     * List recent sessions plus the deduped persons map across them.
+     * Sorted by `updated_at` desc (most recent activity first); pass
+     * `status` to filter by lifecycle state.
+     */
     async listSessions(opts = {}) {
         const qs = new URLSearchParams();
         if (opts.limit !== undefined)
             qs.set("limit", String(opts.limit));
         if (opts.channel)
             qs.set("channel", opts.channel);
+        if (opts.status)
+            qs.set("status", opts.status);
         const tail = qs.toString();
         return this.request("GET", `/v1/sessions${tail ? `?${tail}` : ""}`);
     }
@@ -125,6 +131,18 @@ export class Engram {
         /** Look up by ref. Returns 404 if the ref is unknown. */
         get: (ref) => this.request("GET", `/v1/identities/${encodeURIComponent(ref)}`),
     };
+    /**
+     * Workspace-wide alias lookup. `persons.aliases(id)` answers "what
+     * does this person go by"; this answers the inverse — "which
+     * person(s) does this name resolve to?" — without pre-knowing the
+     * owner. Match is case-insensitive; multiple persons can share an
+     * alias, so the response is an array ordered by `last_used` desc.
+     * Inlined `persons` map saves a round-trip for the typical
+     * candidate-picker UI.
+     */
+    aliases = {
+        findByName: (name) => this.request("GET", `/v1/aliases?name=${encodeURIComponent(name)}`),
+    };
     /** Internal: ship an event batch to the server. */
     async sendBatch(sessionId, batch) {
         if (batch.events.length === 0)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hexis-ai/engram-sdk",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Host SDK for engram. Records agent session steps and ships them to an engram server.",
   "keywords": [
     "engram",