@z3rno/sdk 0.5.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -1103,6 +1103,112 @@ declare const TurnListResponse: z.ZodObject<{
1103
1103
  conversation_id: string;
1104
1104
  }>;
1105
1105
  type TurnListResponse = z.infer<typeof TurnListResponse>;
1106
+ /** Per-tenant budget caps. Zero means inherit server default. */
1107
+ declare const TenantBudgets: z.ZodObject<{
1108
+ daily_tokens: z.ZodNumber;
1109
+ daily_llm_calls: z.ZodNumber;
1110
+ daily_embeddings: z.ZodNumber;
1111
+ monthly_tokens: z.ZodNumber;
1112
+ monthly_llm_calls: z.ZodNumber;
1113
+ monthly_embeddings: z.ZodNumber;
1114
+ }, "strip", z.ZodTypeAny, {
1115
+ daily_tokens: number;
1116
+ daily_llm_calls: number;
1117
+ daily_embeddings: number;
1118
+ monthly_tokens: number;
1119
+ monthly_llm_calls: number;
1120
+ monthly_embeddings: number;
1121
+ }, {
1122
+ daily_tokens: number;
1123
+ daily_llm_calls: number;
1124
+ daily_embeddings: number;
1125
+ monthly_tokens: number;
1126
+ monthly_llm_calls: number;
1127
+ monthly_embeddings: number;
1128
+ }>;
1129
+ type TenantBudgets = z.infer<typeof TenantBudgets>;
1130
+ /** Server response: stored overrides + resolved effective caps. */
1131
+ declare const TenantBudgetsView: z.ZodObject<{
1132
+ overrides: z.ZodObject<{
1133
+ daily_tokens: z.ZodNumber;
1134
+ daily_llm_calls: z.ZodNumber;
1135
+ daily_embeddings: z.ZodNumber;
1136
+ monthly_tokens: z.ZodNumber;
1137
+ monthly_llm_calls: z.ZodNumber;
1138
+ monthly_embeddings: z.ZodNumber;
1139
+ }, "strip", z.ZodTypeAny, {
1140
+ daily_tokens: number;
1141
+ daily_llm_calls: number;
1142
+ daily_embeddings: number;
1143
+ monthly_tokens: number;
1144
+ monthly_llm_calls: number;
1145
+ monthly_embeddings: number;
1146
+ }, {
1147
+ daily_tokens: number;
1148
+ daily_llm_calls: number;
1149
+ daily_embeddings: number;
1150
+ monthly_tokens: number;
1151
+ monthly_llm_calls: number;
1152
+ monthly_embeddings: number;
1153
+ }>;
1154
+ effective: z.ZodObject<{
1155
+ daily_tokens: z.ZodNumber;
1156
+ daily_llm_calls: z.ZodNumber;
1157
+ daily_embeddings: z.ZodNumber;
1158
+ monthly_tokens: z.ZodNumber;
1159
+ monthly_llm_calls: z.ZodNumber;
1160
+ monthly_embeddings: z.ZodNumber;
1161
+ }, "strip", z.ZodTypeAny, {
1162
+ daily_tokens: number;
1163
+ daily_llm_calls: number;
1164
+ daily_embeddings: number;
1165
+ monthly_tokens: number;
1166
+ monthly_llm_calls: number;
1167
+ monthly_embeddings: number;
1168
+ }, {
1169
+ daily_tokens: number;
1170
+ daily_llm_calls: number;
1171
+ daily_embeddings: number;
1172
+ monthly_tokens: number;
1173
+ monthly_llm_calls: number;
1174
+ monthly_embeddings: number;
1175
+ }>;
1176
+ }, "strip", z.ZodTypeAny, {
1177
+ overrides: {
1178
+ daily_tokens: number;
1179
+ daily_llm_calls: number;
1180
+ daily_embeddings: number;
1181
+ monthly_tokens: number;
1182
+ monthly_llm_calls: number;
1183
+ monthly_embeddings: number;
1184
+ };
1185
+ effective: {
1186
+ daily_tokens: number;
1187
+ daily_llm_calls: number;
1188
+ daily_embeddings: number;
1189
+ monthly_tokens: number;
1190
+ monthly_llm_calls: number;
1191
+ monthly_embeddings: number;
1192
+ };
1193
+ }, {
1194
+ overrides: {
1195
+ daily_tokens: number;
1196
+ daily_llm_calls: number;
1197
+ daily_embeddings: number;
1198
+ monthly_tokens: number;
1199
+ monthly_llm_calls: number;
1200
+ monthly_embeddings: number;
1201
+ };
1202
+ effective: {
1203
+ daily_tokens: number;
1204
+ daily_llm_calls: number;
1205
+ daily_embeddings: number;
1206
+ monthly_tokens: number;
1207
+ monthly_llm_calls: number;
1208
+ monthly_embeddings: number;
1209
+ };
1210
+ }>;
1211
+ type TenantBudgetsView = z.infer<typeof TenantBudgetsView>;
1106
1212
 
1107
1213
  /**
1108
1214
  * Z3rno TypeScript SDK client.
@@ -1560,10 +1666,26 @@ declare class Z3rnoClient {
1560
1666
  memoryId: string;
1561
1667
  turnRole: string;
1562
1668
  }): Promise<TurnAddResponse>;
1669
+ /**
1670
+ * v0.19.3 — soft-delete a conversation. Existing turn Memos stay
1671
+ * queryable through standard recall; the conversation itself stops
1672
+ * accepting turns and its endpoints 404. Idempotent.
1673
+ */
1674
+ deleteConversation(conversationId: string): Promise<void>;
1563
1675
  listTurns(conversationId: string, params?: {
1564
1676
  afterTurn?: number;
1565
1677
  limit?: number;
1566
1678
  }): Promise<TurnListResponse>;
1679
+ /**
1680
+ * Read this org's stored budget overrides + resolved effective caps.
1681
+ * Auth: any admin/write/read member of the calling org.
1682
+ */
1683
+ getMyBudgets(): Promise<TenantBudgetsView>;
1684
+ /**
1685
+ * Replace this org's budget overrides. Zero / missing fields
1686
+ * inherit the server default. Auth: admin/write only.
1687
+ */
1688
+ setMyBudgets(budgets: Partial<TenantBudgets>): Promise<TenantBudgetsView>;
1567
1689
  private request;
1568
1690
  private sleep;
1569
1691
  private handleResponse;
@@ -1871,4 +1993,4 @@ declare class Z3rnoMastraMemory {
1871
1993
  private normaliseRole;
1872
1994
  }
1873
1995
 
1874
- 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, TurnAddResponse, TurnListResponse, TurnResponse, ValidationError, Z3rnoClient, type Z3rnoClientConfig, Z3rnoConnectionError, Z3rnoError, Z3rnoMastraMemory, type Z3rnoMastraMemoryOptions, type Z3rnoMessageRole, Z3rnoTimeoutError, Z3rnoVercelMemory, type Z3rnoVercelMemoryOptions };
1996
+ 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 };
package/dist/index.d.ts CHANGED
@@ -1103,6 +1103,112 @@ declare const TurnListResponse: z.ZodObject<{
1103
1103
  conversation_id: string;
1104
1104
  }>;
1105
1105
  type TurnListResponse = z.infer<typeof TurnListResponse>;
1106
+ /** Per-tenant budget caps. Zero means inherit server default. */
1107
+ declare const TenantBudgets: z.ZodObject<{
1108
+ daily_tokens: z.ZodNumber;
1109
+ daily_llm_calls: z.ZodNumber;
1110
+ daily_embeddings: z.ZodNumber;
1111
+ monthly_tokens: z.ZodNumber;
1112
+ monthly_llm_calls: z.ZodNumber;
1113
+ monthly_embeddings: z.ZodNumber;
1114
+ }, "strip", z.ZodTypeAny, {
1115
+ daily_tokens: number;
1116
+ daily_llm_calls: number;
1117
+ daily_embeddings: number;
1118
+ monthly_tokens: number;
1119
+ monthly_llm_calls: number;
1120
+ monthly_embeddings: number;
1121
+ }, {
1122
+ daily_tokens: number;
1123
+ daily_llm_calls: number;
1124
+ daily_embeddings: number;
1125
+ monthly_tokens: number;
1126
+ monthly_llm_calls: number;
1127
+ monthly_embeddings: number;
1128
+ }>;
1129
+ type TenantBudgets = z.infer<typeof TenantBudgets>;
1130
+ /** Server response: stored overrides + resolved effective caps. */
1131
+ declare const TenantBudgetsView: z.ZodObject<{
1132
+ overrides: z.ZodObject<{
1133
+ daily_tokens: z.ZodNumber;
1134
+ daily_llm_calls: z.ZodNumber;
1135
+ daily_embeddings: z.ZodNumber;
1136
+ monthly_tokens: z.ZodNumber;
1137
+ monthly_llm_calls: z.ZodNumber;
1138
+ monthly_embeddings: z.ZodNumber;
1139
+ }, "strip", z.ZodTypeAny, {
1140
+ daily_tokens: number;
1141
+ daily_llm_calls: number;
1142
+ daily_embeddings: number;
1143
+ monthly_tokens: number;
1144
+ monthly_llm_calls: number;
1145
+ monthly_embeddings: number;
1146
+ }, {
1147
+ daily_tokens: number;
1148
+ daily_llm_calls: number;
1149
+ daily_embeddings: number;
1150
+ monthly_tokens: number;
1151
+ monthly_llm_calls: number;
1152
+ monthly_embeddings: number;
1153
+ }>;
1154
+ effective: z.ZodObject<{
1155
+ daily_tokens: z.ZodNumber;
1156
+ daily_llm_calls: z.ZodNumber;
1157
+ daily_embeddings: z.ZodNumber;
1158
+ monthly_tokens: z.ZodNumber;
1159
+ monthly_llm_calls: z.ZodNumber;
1160
+ monthly_embeddings: z.ZodNumber;
1161
+ }, "strip", z.ZodTypeAny, {
1162
+ daily_tokens: number;
1163
+ daily_llm_calls: number;
1164
+ daily_embeddings: number;
1165
+ monthly_tokens: number;
1166
+ monthly_llm_calls: number;
1167
+ monthly_embeddings: number;
1168
+ }, {
1169
+ daily_tokens: number;
1170
+ daily_llm_calls: number;
1171
+ daily_embeddings: number;
1172
+ monthly_tokens: number;
1173
+ monthly_llm_calls: number;
1174
+ monthly_embeddings: number;
1175
+ }>;
1176
+ }, "strip", z.ZodTypeAny, {
1177
+ overrides: {
1178
+ daily_tokens: number;
1179
+ daily_llm_calls: number;
1180
+ daily_embeddings: number;
1181
+ monthly_tokens: number;
1182
+ monthly_llm_calls: number;
1183
+ monthly_embeddings: number;
1184
+ };
1185
+ effective: {
1186
+ daily_tokens: number;
1187
+ daily_llm_calls: number;
1188
+ daily_embeddings: number;
1189
+ monthly_tokens: number;
1190
+ monthly_llm_calls: number;
1191
+ monthly_embeddings: number;
1192
+ };
1193
+ }, {
1194
+ overrides: {
1195
+ daily_tokens: number;
1196
+ daily_llm_calls: number;
1197
+ daily_embeddings: number;
1198
+ monthly_tokens: number;
1199
+ monthly_llm_calls: number;
1200
+ monthly_embeddings: number;
1201
+ };
1202
+ effective: {
1203
+ daily_tokens: number;
1204
+ daily_llm_calls: number;
1205
+ daily_embeddings: number;
1206
+ monthly_tokens: number;
1207
+ monthly_llm_calls: number;
1208
+ monthly_embeddings: number;
1209
+ };
1210
+ }>;
1211
+ type TenantBudgetsView = z.infer<typeof TenantBudgetsView>;
1106
1212
 
1107
1213
  /**
1108
1214
  * Z3rno TypeScript SDK client.
@@ -1560,10 +1666,26 @@ declare class Z3rnoClient {
1560
1666
  memoryId: string;
1561
1667
  turnRole: string;
1562
1668
  }): Promise<TurnAddResponse>;
1669
+ /**
1670
+ * v0.19.3 — soft-delete a conversation. Existing turn Memos stay
1671
+ * queryable through standard recall; the conversation itself stops
1672
+ * accepting turns and its endpoints 404. Idempotent.
1673
+ */
1674
+ deleteConversation(conversationId: string): Promise<void>;
1563
1675
  listTurns(conversationId: string, params?: {
1564
1676
  afterTurn?: number;
1565
1677
  limit?: number;
1566
1678
  }): Promise<TurnListResponse>;
1679
+ /**
1680
+ * Read this org's stored budget overrides + resolved effective caps.
1681
+ * Auth: any admin/write/read member of the calling org.
1682
+ */
1683
+ getMyBudgets(): Promise<TenantBudgetsView>;
1684
+ /**
1685
+ * Replace this org's budget overrides. Zero / missing fields
1686
+ * inherit the server default. Auth: admin/write only.
1687
+ */
1688
+ setMyBudgets(budgets: Partial<TenantBudgets>): Promise<TenantBudgetsView>;
1567
1689
  private request;
1568
1690
  private sleep;
1569
1691
  private handleResponse;
@@ -1871,4 +1993,4 @@ declare class Z3rnoMastraMemory {
1871
1993
  private normaliseRole;
1872
1994
  }
1873
1995
 
1874
- 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, TurnAddResponse, TurnListResponse, TurnResponse, ValidationError, Z3rnoClient, type Z3rnoClientConfig, Z3rnoConnectionError, Z3rnoError, Z3rnoMastraMemory, type Z3rnoMastraMemoryOptions, type Z3rnoMessageRole, Z3rnoTimeoutError, Z3rnoVercelMemory, type Z3rnoVercelMemoryOptions };
1996
+ 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 };
package/dist/index.js CHANGED
@@ -447,6 +447,18 @@ var TurnListResponse = z.object({
447
447
  total: z.number(),
448
448
  conversation_id: z.string()
449
449
  });
450
+ var TenantBudgets = z.object({
451
+ daily_tokens: z.number(),
452
+ daily_llm_calls: z.number(),
453
+ daily_embeddings: z.number(),
454
+ monthly_tokens: z.number(),
455
+ monthly_llm_calls: z.number(),
456
+ monthly_embeddings: z.number()
457
+ });
458
+ var TenantBudgetsView = z.object({
459
+ overrides: TenantBudgets,
460
+ effective: TenantBudgets
461
+ });
450
462
 
451
463
  // src/client.ts
452
464
  var Z3rnoClient = class {
@@ -924,6 +936,14 @@ var Z3rnoClient = class {
924
936
  );
925
937
  return TurnAddResponse.parse(resp);
926
938
  }
939
+ /**
940
+ * v0.19.3 — soft-delete a conversation. Existing turn Memos stay
941
+ * queryable through standard recall; the conversation itself stops
942
+ * accepting turns and its endpoints 404. Idempotent.
943
+ */
944
+ async deleteConversation(conversationId) {
945
+ await this.request("DELETE", `/v1/conversations/${conversationId}`);
946
+ }
927
947
  async listTurns(conversationId, params) {
928
948
  const query = new URLSearchParams();
929
949
  if (params?.afterTurn !== void 0)
@@ -933,6 +953,31 @@ var Z3rnoClient = class {
933
953
  const resp = await this.request("GET", path);
934
954
  return TurnListResponse.parse(resp);
935
955
  }
956
+ // --- Tenant budgets (v0.20.3) ---
957
+ /**
958
+ * Read this org's stored budget overrides + resolved effective caps.
959
+ * Auth: any admin/write/read member of the calling org.
960
+ */
961
+ async getMyBudgets() {
962
+ const resp = await this.request("GET", "/v1/tenants/me/budgets");
963
+ return TenantBudgetsView.parse(resp);
964
+ }
965
+ /**
966
+ * Replace this org's budget overrides. Zero / missing fields
967
+ * inherit the server default. Auth: admin/write only.
968
+ */
969
+ async setMyBudgets(budgets) {
970
+ const body = {
971
+ daily_tokens: budgets.daily_tokens ?? 0,
972
+ daily_llm_calls: budgets.daily_llm_calls ?? 0,
973
+ daily_embeddings: budgets.daily_embeddings ?? 0,
974
+ monthly_tokens: budgets.monthly_tokens ?? 0,
975
+ monthly_llm_calls: budgets.monthly_llm_calls ?? 0,
976
+ monthly_embeddings: budgets.monthly_embeddings ?? 0
977
+ };
978
+ const resp = await this.request("PUT", "/v1/tenants/me/budgets", body);
979
+ return TenantBudgetsView.parse(resp);
980
+ }
936
981
  // --- HTTP layer ---
937
982
  async request(method, path, body) {
938
983
  let lastError;
@@ -1199,6 +1244,6 @@ var Z3rnoMastraMemory = class {
1199
1244
  }
1200
1245
  };
1201
1246
 
1202
- 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, TurnAddResponse, TurnListResponse, TurnResponse, ValidationError, Z3rnoClient, Z3rnoConnectionError, Z3rnoError, Z3rnoMastraMemory, Z3rnoTimeoutError, Z3rnoVercelMemory };
1247
+ 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 };
1203
1248
  //# sourceMappingURL=index.js.map
1204
1249
  //# sourceMappingURL=index.js.map