@z3rno/sdk 0.8.0 → 0.9.0

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;
@@ -1690,6 +1772,16 @@ declare class Z3rnoClient {
         afterTurn?: number;
         limit?: number;
     }): Promise<TurnListResponse>;
+    /**
+     * Cross-tenant admin sub-namespace (v0.22.1, slice 21.3).
+     *
+     * Pairs with z3rno-server v0.22.1's `/v1/tenants/{orgId}/budgets`
+     * surface. Requires `SUPERADMIN_ENABLED=true` on the server and
+     * the client to be configured with the matching superadmin API
+     * key. Methods raise `AuthenticationError` (401) or a generic
+     * `Z3rnoError` (403) otherwise.
+     */
+    get admin(): AdminAPI;
     /**
      * Read this org's stored budget overrides + resolved effective caps.
      * Auth: any admin/write/read member of the calling org.
@@ -1704,6 +1796,31 @@ declare class Z3rnoClient {
     private sleep;
     private handleResponse;
 }
+/**
+ * Cross-tenant admin sub-namespace exposed via `client.admin`.
+ *
+ * Construction captures the parent client's `request` method as a
+ * bound closure — no privileged access to the class internals, just
+ * a function reference. That's deliberate: the namespace is
+ * dependency-injected the same way a stub would be, so test doubles
+ * can swap it out without touching the parent client.
+ */
+declare class AdminAPI {
+    private readonly request;
+    constructor(request: (method: string, path: string, body?: unknown) => Promise<unknown>);
+    /**
+     * Read another tenant's budget overrides + effective caps.
+     *
+     * Requires `SUPERADMIN_ENABLED=true` server-side and the client to
+     * be configured with the superadmin API key.
+     */
+    getBudgets(orgId: string): Promise<TenantBudgetsView>;
+    /**
+     * Replace another tenant's budget overrides. Zero / missing fields
+     * inherit the server default.
+     */
+    setBudgets(orgId: string, budgets: Partial<TenantBudgets>): Promise<TenantBudgetsView>;
+}
 
 /**
  * Z3rno SDK error hierarchy.
@@ -2007,4 +2124,4 @@ declare class Z3rnoMastraMemory {
     private normaliseRole;
 }
 
-export { AuditEntry, AuditPageResponse, AuthenticationError, BatchStoreResponse, ConversationResponse, type CoreMessage, DistillJobResponse, DistillJobStatusResponse, EndSessionResponse, ForgetResponse, IngestJobResponse, IngestJobStatusResponse, type MastraMessage, type MastraRole, MemoryHistoryResponse, MemoryResponse, MemoryType, MemoryVersion, NotFoundError, RateLimitError, RecallResponse, RecallResultItem, RefineJobResponse, RefineJobStatusResponse, RelationshipType, RetrievalStrategy, ServerError, SessionResponse, StoreMemoryRequest, TenantBudgets, TenantBudgetsView, TurnAddResponse, TurnListResponse, TurnResponse, ValidationError, Z3rnoClient, type Z3rnoClientConfig, Z3rnoConnectionError, Z3rnoError, Z3rnoMastraMemory, type Z3rnoMastraMemoryOptions, type Z3rnoMessageRole, Z3rnoTimeoutError, Z3rnoVercelMemory, type Z3rnoVercelMemoryOptions };
+export { AdminAPI, AuditEntry, AuditPageResponse, AuthenticationError, BatchStoreResponse, ConversationResponse, type CoreMessage, DistillJobResponse, DistillJobStatusResponse, EndSessionResponse, ForgetResponse, IngestJobResponse, IngestJobStatusResponse, type MastraMessage, type MastraRole, MemoryHistoryResponse, MemoryResponse, MemoryType, MemoryVersion, NotFoundError, RateLimitError, RecallResponse, RecallResultItem, RefineJobResponse, RefineJobStatusResponse, RelationshipType, RetrievalStrategy, ServerError, SessionResponse, StoreMemoryRequest, TenantBudgets, TenantBudgetsView, TurnAddResponse, TurnListResponse, TurnResponse, ValidationError, Z3rnoClient, type Z3rnoClientConfig, Z3rnoConnectionError, Z3rnoError, Z3rnoMastraMemory, type Z3rnoMastraMemoryOptions, type Z3rnoMessageRole, Z3rnoTimeoutError, Z3rnoVercelMemory, type Z3rnoVercelMemoryOptions };

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;
@@ -1690,6 +1772,16 @@ declare class Z3rnoClient {
         afterTurn?: number;
         limit?: number;
     }): Promise<TurnListResponse>;
+    /**
+     * Cross-tenant admin sub-namespace (v0.22.1, slice 21.3).
+     *
+     * Pairs with z3rno-server v0.22.1's `/v1/tenants/{orgId}/budgets`
+     * surface. Requires `SUPERADMIN_ENABLED=true` on the server and
+     * the client to be configured with the matching superadmin API
+     * key. Methods raise `AuthenticationError` (401) or a generic
+     * `Z3rnoError` (403) otherwise.
+     */
+    get admin(): AdminAPI;
     /**
      * Read this org's stored budget overrides + resolved effective caps.
      * Auth: any admin/write/read member of the calling org.
@@ -1704,6 +1796,31 @@ declare class Z3rnoClient {
     private sleep;
     private handleResponse;
 }
+/**
+ * Cross-tenant admin sub-namespace exposed via `client.admin`.
+ *
+ * Construction captures the parent client's `request` method as a
+ * bound closure — no privileged access to the class internals, just
+ * a function reference. That's deliberate: the namespace is
+ * dependency-injected the same way a stub would be, so test doubles
+ * can swap it out without touching the parent client.
+ */
+declare class AdminAPI {
+    private readonly request;
+    constructor(request: (method: string, path: string, body?: unknown) => Promise<unknown>);
+    /**
+     * Read another tenant's budget overrides + effective caps.
+     *
+     * Requires `SUPERADMIN_ENABLED=true` server-side and the client to
+     * be configured with the superadmin API key.
+     */
+    getBudgets(orgId: string): Promise<TenantBudgetsView>;
+    /**
+     * Replace another tenant's budget overrides. Zero / missing fields
+     * inherit the server default.
+     */
+    setBudgets(orgId: string, budgets: Partial<TenantBudgets>): Promise<TenantBudgetsView>;
+}
 
 /**
  * Z3rno SDK error hierarchy.
@@ -2007,4 +2124,4 @@ declare class Z3rnoMastraMemory {
     private normaliseRole;
 }
 
-export { AuditEntry, AuditPageResponse, AuthenticationError, BatchStoreResponse, ConversationResponse, type CoreMessage, DistillJobResponse, DistillJobStatusResponse, EndSessionResponse, ForgetResponse, IngestJobResponse, IngestJobStatusResponse, type MastraMessage, type MastraRole, MemoryHistoryResponse, MemoryResponse, MemoryType, MemoryVersion, NotFoundError, RateLimitError, RecallResponse, RecallResultItem, RefineJobResponse, RefineJobStatusResponse, RelationshipType, RetrievalStrategy, ServerError, SessionResponse, StoreMemoryRequest, TenantBudgets, TenantBudgetsView, TurnAddResponse, TurnListResponse, TurnResponse, ValidationError, Z3rnoClient, type Z3rnoClientConfig, Z3rnoConnectionError, Z3rnoError, Z3rnoMastraMemory, type Z3rnoMastraMemoryOptions, type Z3rnoMessageRole, Z3rnoTimeoutError, Z3rnoVercelMemory, type Z3rnoVercelMemoryOptions };
+export { AdminAPI, AuditEntry, AuditPageResponse, AuthenticationError, BatchStoreResponse, ConversationResponse, type CoreMessage, DistillJobResponse, DistillJobStatusResponse, EndSessionResponse, ForgetResponse, IngestJobResponse, IngestJobStatusResponse, type MastraMessage, type MastraRole, MemoryHistoryResponse, MemoryResponse, MemoryType, MemoryVersion, NotFoundError, RateLimitError, RecallResponse, RecallResultItem, RefineJobResponse, RefineJobStatusResponse, RelationshipType, RetrievalStrategy, ServerError, SessionResponse, StoreMemoryRequest, TenantBudgets, TenantBudgetsView, TurnAddResponse, TurnListResponse, TurnResponse, ValidationError, Z3rnoClient, type Z3rnoClientConfig, Z3rnoConnectionError, Z3rnoError, Z3rnoMastraMemory, type Z3rnoMastraMemoryOptions, type Z3rnoMessageRole, Z3rnoTimeoutError, Z3rnoVercelMemory, type Z3rnoVercelMemoryOptions };

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),
@@ -966,6 +974,18 @@ var Z3rnoClient = class {
     return TurnListResponse.parse(resp);
   }
   // --- Tenant budgets (v0.20.3) ---
+  /**
+   * Cross-tenant admin sub-namespace (v0.22.1, slice 21.3).
+   *
+   * Pairs with z3rno-server v0.22.1's `/v1/tenants/{orgId}/budgets`
+   * surface. Requires `SUPERADMIN_ENABLED=true` on the server and
+   * the client to be configured with the matching superadmin API
+   * key. Methods raise `AuthenticationError` (401) or a generic
+   * `Z3rnoError` (403) otherwise.
+   */
+  get admin() {
+    return new AdminAPI(this.request.bind(this));
+  }
   /**
    * Read this org's stored budget overrides + resolved effective caps.
    * Auth: any admin/write/read member of the calling org.
@@ -1109,6 +1129,38 @@ var Z3rnoClient = class {
     }
   }
 };
+var AdminAPI = class {
+  constructor(request) {
+    this.request = request;
+  }
+  request;
+  /**
+   * Read another tenant's budget overrides + effective caps.
+   *
+   * Requires `SUPERADMIN_ENABLED=true` server-side and the client to
+   * be configured with the superadmin API key.
+   */
+  async getBudgets(orgId) {
+    const resp = await this.request("GET", `/v1/tenants/${orgId}/budgets`);
+    return TenantBudgetsView.parse(resp);
+  }
+  /**
+   * Replace another tenant's budget overrides. Zero / missing fields
+   * inherit the server default.
+   */
+  async setBudgets(orgId, budgets) {
+    const body = {
+      daily_tokens: budgets.daily_tokens ?? 0,
+      daily_llm_calls: budgets.daily_llm_calls ?? 0,
+      daily_embeddings: budgets.daily_embeddings ?? 0,
+      monthly_tokens: budgets.monthly_tokens ?? 0,
+      monthly_llm_calls: budgets.monthly_llm_calls ?? 0,
+      monthly_embeddings: budgets.monthly_embeddings ?? 0
+    };
+    const resp = await this.request("PUT", `/v1/tenants/${orgId}/budgets`, body);
+    return TenantBudgetsView.parse(resp);
+  }
+};
 
 // src/integrations/vercel-ai.ts
 var Z3rnoVercelMemory = class {
@@ -1259,6 +1311,6 @@ var Z3rnoMastraMemory = class {
   }
 };
 
-export { AuditEntry, AuditPageResponse, AuthenticationError, BatchStoreResponse, ConversationResponse, DistillJobResponse, DistillJobStatusResponse, EndSessionResponse, ForgetResponse, IngestJobResponse, IngestJobStatusResponse, MemoryHistoryResponse, MemoryResponse, MemoryType, MemoryVersion, NotFoundError, RateLimitError, RecallResponse, RecallResultItem, RefineJobResponse, RefineJobStatusResponse, RelationshipType, RetrievalStrategy, ServerError, SessionResponse, TenantBudgets, TenantBudgetsView, TurnAddResponse, TurnListResponse, TurnResponse, ValidationError, Z3rnoClient, Z3rnoConnectionError, Z3rnoError, Z3rnoMastraMemory, Z3rnoTimeoutError, Z3rnoVercelMemory };
+export { AdminAPI, AuditEntry, AuditPageResponse, AuthenticationError, BatchStoreResponse, ConversationResponse, DistillJobResponse, DistillJobStatusResponse, EndSessionResponse, ForgetResponse, IngestJobResponse, IngestJobStatusResponse, MemoryHistoryResponse, MemoryResponse, MemoryType, MemoryVersion, NotFoundError, RateLimitError, RecallResponse, RecallResultItem, RefineJobResponse, RefineJobStatusResponse, RelationshipType, RetrievalStrategy, ServerError, SessionResponse, TenantBudgets, TenantBudgetsView, TurnAddResponse, TurnListResponse, TurnResponse, ValidationError, Z3rnoClient, Z3rnoConnectionError, Z3rnoError, Z3rnoMastraMemory, Z3rnoTimeoutError, Z3rnoVercelMemory };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map