@z3rno/sdk 0.8.1 → 0.9.0

package/dist/index.d.cts

@@ -1772,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.
@@ -1786,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.
@@ -2089,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

@@ -1772,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.
@@ -1786,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.
@@ -2089,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

@@ -974,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.
@@ -1117,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 {
@@ -1267,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