@z3rno/sdk 0.7.1 → 0.8.1

package/dist/index.d.cts

@@ -378,7 +378,7 @@ type ForgetResponse = z.infer<typeof ForgetResponse>;
  *
  * Audit entries record every operation performed on the agent's memories.
  */
-declare const AuditEntry: z.ZodObject<{
+declare const AuditEntry: z.ZodEffects<z.ZodObject<{
     /** Auto-incrementing audit entry ID. */
     id: z.ZodNumber;
     /** UUID of the agent, if applicable. */
@@ -417,6 +417,28 @@ declare const AuditEntry: z.ZodObject<{
     user_id?: string | null | undefined;
     details?: Record<string, unknown> | undefined;
     ip_address?: string | null | undefined;
+}>, {
+    /** Alias for `created_at`. Added in v0.8.1 for cross-SDK naming parity. */
+    timestamp: string;
+    id: number;
+    created_at: string;
+    operation: string;
+    details: Record<string, unknown>;
+    agent_id?: string | null | undefined;
+    memory_type?: string | null | undefined;
+    memory_id?: string | null | undefined;
+    user_id?: string | null | undefined;
+    ip_address?: string | null | undefined;
+}, {
+    id: number;
+    created_at: string;
+    operation: string;
+    agent_id?: string | null | undefined;
+    memory_type?: string | null | undefined;
+    memory_id?: string | null | undefined;
+    user_id?: string | null | undefined;
+    details?: Record<string, unknown> | undefined;
+    ip_address?: string | null | undefined;
 }>;
 /** Parsed type for an audit entry. */
 type AuditEntry = z.infer<typeof AuditEntry>;
@@ -425,9 +447,9 @@ type AuditEntry = z.infer<typeof AuditEntry>;
  *
  * Supports cursor-based pagination via `page` and `page_size`.
  */
-declare const AuditPageResponse: z.ZodObject<{
+declare const AuditPageResponse: z.ZodEffects<z.ZodObject<{
     /** Audit entries on this page. */
-    entries: z.ZodArray<z.ZodObject<{
+    entries: z.ZodArray<z.ZodEffects<z.ZodObject<{
         /** Auto-incrementing audit entry ID. */
         id: z.ZodNumber;
         /** UUID of the agent, if applicable. */
@@ -466,6 +488,28 @@ declare const AuditPageResponse: z.ZodObject<{
         user_id?: string | null | undefined;
         details?: Record<string, unknown> | undefined;
         ip_address?: string | null | undefined;
+    }>, {
+        /** Alias for `created_at`. Added in v0.8.1 for cross-SDK naming parity. */
+        timestamp: string;
+        id: number;
+        created_at: string;
+        operation: string;
+        details: Record<string, unknown>;
+        agent_id?: string | null | undefined;
+        memory_type?: string | null | undefined;
+        memory_id?: string | null | undefined;
+        user_id?: string | null | undefined;
+        ip_address?: string | null | undefined;
+    }, {
+        id: number;
+        created_at: string;
+        operation: string;
+        agent_id?: string | null | undefined;
+        memory_type?: string | null | undefined;
+        memory_id?: string | null | undefined;
+        user_id?: string | null | undefined;
+        details?: Record<string, unknown> | undefined;
+        ip_address?: string | null | undefined;
     }>, "many">;
     /** Total number of matching audit entries. */
     total: z.ZodNumber;
@@ -477,6 +521,44 @@ declare const AuditPageResponse: z.ZodObject<{
     has_next: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
     entries: {
+        /** Alias for `created_at`. Added in v0.8.1 for cross-SDK naming parity. */
+        timestamp: string;
+        id: number;
+        created_at: string;
+        operation: string;
+        details: Record<string, unknown>;
+        agent_id?: string | null | undefined;
+        memory_type?: string | null | undefined;
+        memory_id?: string | null | undefined;
+        user_id?: string | null | undefined;
+        ip_address?: string | null | undefined;
+    }[];
+    total: number;
+    page: number;
+    page_size: number;
+    has_next: boolean;
+}, {
+    entries: {
+        id: number;
+        created_at: string;
+        operation: string;
+        agent_id?: string | null | undefined;
+        memory_type?: string | null | undefined;
+        memory_id?: string | null | undefined;
+        user_id?: string | null | undefined;
+        details?: Record<string, unknown> | undefined;
+        ip_address?: string | null | undefined;
+    }[];
+    total: number;
+    page: number;
+    page_size: number;
+    has_next: boolean;
+}>, {
+    /** Alias for `total`. Added in v0.8.1 for cross-SDK naming parity. */
+    total_count: number;
+    entries: {
+        /** Alias for `created_at`. Added in v0.8.1 for cross-SDK naming parity. */
+        timestamp: string;
         id: number;
         created_at: string;
         operation: string;
@@ -1402,7 +1484,21 @@ declare class Z3rnoClient {
         agentId: string;
         query?: string;
         memoryType?: string;
+        /**
+         * v0.21.2 — JSONB metadata containment filter
+         * (`metadata @> :metadata_filter` server-side). Renamed from
+         * `filters`; the old name is still accepted via `filters` below
+         * but emits a deprecation warning.
+         */
+        metadataFilter?: Record<string, unknown>;
+        /** @deprecated Use `metadataFilter` instead. */
         filters?: Record<string, unknown>;
+        /**
+         * v0.21.1 — scope by end-user id (the `memories.user_id`
+         * column). Multi-user agents use this for per-user recall
+         * isolation. Real WHERE predicate, not just audit context.
+         */
+        userId?: string;
         topK?: number;
         similarityThreshold?: number;
         /**

package/dist/index.d.ts

@@ -378,7 +378,7 @@ type ForgetResponse = z.infer<typeof ForgetResponse>;
  *
  * Audit entries record every operation performed on the agent's memories.
  */
-declare const AuditEntry: z.ZodObject<{
+declare const AuditEntry: z.ZodEffects<z.ZodObject<{
     /** Auto-incrementing audit entry ID. */
     id: z.ZodNumber;
     /** UUID of the agent, if applicable. */
@@ -417,6 +417,28 @@ declare const AuditEntry: z.ZodObject<{
     user_id?: string | null | undefined;
     details?: Record<string, unknown> | undefined;
     ip_address?: string | null | undefined;
+}>, {
+    /** Alias for `created_at`. Added in v0.8.1 for cross-SDK naming parity. */
+    timestamp: string;
+    id: number;
+    created_at: string;
+    operation: string;
+    details: Record<string, unknown>;
+    agent_id?: string | null | undefined;
+    memory_type?: string | null | undefined;
+    memory_id?: string | null | undefined;
+    user_id?: string | null | undefined;
+    ip_address?: string | null | undefined;
+}, {
+    id: number;
+    created_at: string;
+    operation: string;
+    agent_id?: string | null | undefined;
+    memory_type?: string | null | undefined;
+    memory_id?: string | null | undefined;
+    user_id?: string | null | undefined;
+    details?: Record<string, unknown> | undefined;
+    ip_address?: string | null | undefined;
 }>;
 /** Parsed type for an audit entry. */
 type AuditEntry = z.infer<typeof AuditEntry>;
@@ -425,9 +447,9 @@ type AuditEntry = z.infer<typeof AuditEntry>;
  *
  * Supports cursor-based pagination via `page` and `page_size`.
  */
-declare const AuditPageResponse: z.ZodObject<{
+declare const AuditPageResponse: z.ZodEffects<z.ZodObject<{
     /** Audit entries on this page. */
-    entries: z.ZodArray<z.ZodObject<{
+    entries: z.ZodArray<z.ZodEffects<z.ZodObject<{
         /** Auto-incrementing audit entry ID. */
         id: z.ZodNumber;
         /** UUID of the agent, if applicable. */
@@ -466,6 +488,28 @@ declare const AuditPageResponse: z.ZodObject<{
         user_id?: string | null | undefined;
         details?: Record<string, unknown> | undefined;
         ip_address?: string | null | undefined;
+    }>, {
+        /** Alias for `created_at`. Added in v0.8.1 for cross-SDK naming parity. */
+        timestamp: string;
+        id: number;
+        created_at: string;
+        operation: string;
+        details: Record<string, unknown>;
+        agent_id?: string | null | undefined;
+        memory_type?: string | null | undefined;
+        memory_id?: string | null | undefined;
+        user_id?: string | null | undefined;
+        ip_address?: string | null | undefined;
+    }, {
+        id: number;
+        created_at: string;
+        operation: string;
+        agent_id?: string | null | undefined;
+        memory_type?: string | null | undefined;
+        memory_id?: string | null | undefined;
+        user_id?: string | null | undefined;
+        details?: Record<string, unknown> | undefined;
+        ip_address?: string | null | undefined;
     }>, "many">;
     /** Total number of matching audit entries. */
     total: z.ZodNumber;
@@ -477,6 +521,44 @@ declare const AuditPageResponse: z.ZodObject<{
     has_next: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
     entries: {
+        /** Alias for `created_at`. Added in v0.8.1 for cross-SDK naming parity. */
+        timestamp: string;
+        id: number;
+        created_at: string;
+        operation: string;
+        details: Record<string, unknown>;
+        agent_id?: string | null | undefined;
+        memory_type?: string | null | undefined;
+        memory_id?: string | null | undefined;
+        user_id?: string | null | undefined;
+        ip_address?: string | null | undefined;
+    }[];
+    total: number;
+    page: number;
+    page_size: number;
+    has_next: boolean;
+}, {
+    entries: {
+        id: number;
+        created_at: string;
+        operation: string;
+        agent_id?: string | null | undefined;
+        memory_type?: string | null | undefined;
+        memory_id?: string | null | undefined;
+        user_id?: string | null | undefined;
+        details?: Record<string, unknown> | undefined;
+        ip_address?: string | null | undefined;
+    }[];
+    total: number;
+    page: number;
+    page_size: number;
+    has_next: boolean;
+}>, {
+    /** Alias for `total`. Added in v0.8.1 for cross-SDK naming parity. */
+    total_count: number;
+    entries: {
+        /** Alias for `created_at`. Added in v0.8.1 for cross-SDK naming parity. */
+        timestamp: string;
         id: number;
         created_at: string;
         operation: string;
@@ -1402,7 +1484,21 @@ declare class Z3rnoClient {
         agentId: string;
         query?: string;
         memoryType?: string;
+        /**
+         * v0.21.2 — JSONB metadata containment filter
+         * (`metadata @> :metadata_filter` server-side). Renamed from
+         * `filters`; the old name is still accepted via `filters` below
+         * but emits a deprecation warning.
+         */
+        metadataFilter?: Record<string, unknown>;
+        /** @deprecated Use `metadataFilter` instead. */
         filters?: Record<string, unknown>;
+        /**
+         * v0.21.1 — scope by end-user id (the `memories.user_id`
+         * column). Multi-user agents use this for per-user recall
+         * isolation. Real WHERE predicate, not just audit context.
+         */
+        userId?: string;
         topK?: number;
         similarityThreshold?: number;
         /**

package/dist/index.js

@@ -276,7 +276,11 @@ var AuditEntry = z.object({
   ip_address: z.string().nullable().optional(),
   /** ISO 8601 timestamp of the operation. */
   created_at: z.string()
-});
+}).transform((data) => ({
+  ...data,
+  /** Alias for `created_at`. Added in v0.8.1 for cross-SDK naming parity. */
+  timestamp: data.created_at
+}));
 var AuditPageResponse = z.object({
   /** Audit entries on this page. */
   entries: z.array(AuditEntry),
@@ -288,7 +292,11 @@ var AuditPageResponse = z.object({
   page_size: z.number(),
   /** Whether more pages are available. */
   has_next: z.boolean()
-});
+}).transform((data) => ({
+  ...data,
+  /** Alias for `total`. Added in v0.8.1 for cross-SDK naming parity. */
+  total_count: data.total
+}));
 var BatchStoreResponse = z.object({
   /** Array of stored memory objects. */
   results: z.array(MemoryResponse),
@@ -583,11 +591,20 @@ var Z3rnoClient = class {
    * ```
    */
   async recall(params) {
+    let metadataFilter = params.metadataFilter;
+    if (params.filters !== void 0 && metadataFilter === void 0) {
+      if (typeof console !== "undefined" && console.warn) {
+        console.warn(
+          "Z3rnoClient.recall({filters}) is deprecated; use {metadataFilter} instead."
+        );
+      }
+      metadataFilter = params.filters;
+    }
     const body = {
       agent_id: params.agentId,
       query: params.query,
       memory_type: params.memoryType,
-      filters: params.filters,
+      metadata_filter: metadataFilter,
       top_k: params.topK ?? 10,
       similarity_threshold: params.similarityThreshold ?? 0,
       // Always send strategy + rerank. Older servers silently ignore
@@ -595,6 +612,9 @@ var Z3rnoClient = class {
       strategy: params.strategy ?? "AUTO",
       rerank: params.rerank ?? false
     };
+    if (params.userId) {
+      body.user_id = params.userId;
+    }
     if (params.conversationId) {
       body.conversation_id = params.conversationId;
     }