@naturali/cli 0.126.0 → 0.127.0

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.126.0";
+var version = "0.127.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -1138,6 +1138,20 @@ var Admin = class {
 			}
 		});
 	}
+	/**
+	* Read the global price book
+	*
+	* The upstream runtime's global default prices — the rows carrying neither a provider nor a project, which is all the upstream listing returns, so no tenant's own rates appear here.
+	*
+	* These are a cost basis, not a tariff: what a customer pays is the plan they bought plus the multiplier in PRICING.md section 3, applied when spend is reconciled. This is the read behind the storage-rate assertion at boot and the pinned embedding rate.
+	*
+	*/
+	static getAdminPriceBook(options) {
+		return (options?.client ?? client).get({
+			url: "/v1/admin/usage/prices",
+			...options
+		});
+	}
 };
 var Agents = class {
 	/**
@@ -3693,6 +3707,47 @@ var Projects = class {
 			...options
 		});
 	}
+	/**
+	* List usage thresholds
+	*
+	* The spend alerts this project has set. A threshold fires the usage.threshold_crossed event when the project's windowed usage crosses it, so one is only useful alongside a webhook subscribed to that event.
+	*
+	*/
+	static listProjectUsageThresholds(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/usage/thresholds",
+			...options
+		});
+	}
+	/**
+	* Set a usage threshold
+	*
+	* Creates an alert on this project's windowed usage. Crossing it fires usage.threshold_crossed once per window — a calendar_month threshold fires at most once in a month, and a rolling_24h one re-arms when the windowed total falls back below 90% of the threshold, so a total hovering at the line does not alert repeatedly.
+	*
+	* Requires the admin role: an alerting rule belongs to the account that pays, not to one member.
+	*
+	*/
+	static createProjectUsageThreshold(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/usage/thresholds",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a usage threshold
+	*
+	* Stops the alert. Requires the admin role.
+	*/
+	static deleteProjectUsageThreshold(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/usage/thresholds/{threshold_id}",
+			...options
+		});
+	}
 };
 var Quotas = class {
 	/**
@@ -6031,6 +6086,16 @@ const routes = {
 			}
 		]
 	},
+	"get-admin-price-book": {
+		serviceClass: "Admin",
+		operationId: "getAdminPriceBook",
+		description: "The upstream runtime's global default prices — the rows carrying neither a provider nor a project, which is all the upstream listing returns, so no tenant's own rates appear here. These are a cost basis, not a tariff: what a customer pays is the plan they bought plus the multiplier in PRICING.md section 3, applied when spend is reconciled. This is the read behind the storage-rate assertion at boot and the pinned embedding rate.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/admin",
+		httpMethod: "get",
+		pathParams: [],
+		queryParams: [],
+		flags: []
+	},
 	"list-agents": {
 		serviceClass: "Agents",
 		operationId: "listAgents",
@@ -13962,6 +14027,99 @@ const routes = {
 			}
 		]
 	},
+	"list-project-usage-thresholds": {
+		serviceClass: "Projects",
+		operationId: "listProjectUsageThresholds",
+		description: "The spend alerts this project has set. A threshold fires the usage.threshold_crossed event when the project's windowed usage crosses it, so one is only useful alongside a webhook subscribed to that event.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/projects",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: ["limit", "offset"],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"create-project-usage-threshold": {
+		serviceClass: "Projects",
+		operationId: "createProjectUsageThreshold",
+		description: "Creates an alert on this project's windowed usage. Crossing it fires usage.threshold_crossed once per window — a calendar_month threshold fires at most once in a month, and a rolling_24h one re-arms when the windowed total falls back below 90% of the threshold, so a total hovering at the line does not alert repeatedly. Requires the admin role: an alerting rule belongs to the account that pays, not to one member.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/projects",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "metric",
+				"description": "",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "window",
+				"description": "",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "threshold",
+				"description": "Must be greater than zero.",
+				"required": true,
+				"type": "number",
+				"in": "body"
+			}
+		]
+	},
+	"delete-project-usage-threshold": {
+		serviceClass: "Projects",
+		operationId: "deleteProjectUsageThreshold",
+		description: "Stops the alert. Requires the admin role.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/projects",
+		httpMethod: "delete",
+		pathParams: ["project_id", "threshold_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "threshold_id",
+			"description": "",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
 	"list-quotas": {
 		serviceClass: "Quotas",
 		operationId: "listQuotas",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.126.0",
+  "version": "0.127.0",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "bin": {
@@ -30,7 +30,7 @@
     "tsx": "^4.23.1",
     "typescript": "~6.0.3",
     "vitest": "^4.1.10",
-    "@naturali/sdk": "0.126.0"
+    "@naturali/sdk": "0.127.0"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",