@soat/sdk 0.15.3 → 0.15.4

package/dist/index.mjs

@@ -2951,13 +2951,65 @@ var Usage = class {
 		});
 	}
 	/**
-	* Get a generation's billing receipt
+	* Get aggregated usage for a project
 	*
-	* Returns a billing receipt for a completed generation: per-model line items (tokens, the price-book version that priced them, and cost) plus totals.
+	* Returns a project's usage rolled up over an optional `[from, to]` time window, bucketed by a single dimension. Each group and the grand total carry summed token counts and `cost_usd` (null when no event in the bucket was priced). This is the per-project cost-by-range/by-category query — a monthly figure without scanning raw meter rows client-side.
 	*
 	*/
-	static getUsageReceipt(options) {
+	static getUsage(options) {
 		return (options.client ?? client).get({
+			url: "/api/v1/usage",
+			...options
+		});
+	}
+	/**
+	* List usage thresholds
+	*
+	* Lists the usage alert thresholds the caller can access, optionally filtered by project_id. Each threshold fires the `usage.threshold_crossed` webhook when a project's cost or token usage over a calendar-month or rolling-24h window crosses the configured value.
+	*
+	*/
+	static listUsageThresholds(options) {
+		return (options?.client ?? client).get({
+			url: "/api/v1/usage/thresholds",
+			...options
+		});
+	}
+	/**
+	* Create a usage threshold
+	*
+	* Creates a usage alert threshold on a project. Thresholds are immutable apart from deletion — to change one, delete and recreate it (which resets its fire state).
+	*
+	*/
+	static createUsageThreshold(options) {
+		return (options.client ?? client).post({
+			url: "/api/v1/usage/thresholds",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a usage threshold
+	*
+	* Deletes a usage threshold, resetting its fire state. Recreating a threshold starts its once-per-window / hysteresis state fresh.
+	*
+	*/
+	static deleteUsageThreshold(options) {
+		return (options.client ?? client).delete({
+			url: "/api/v1/usage/thresholds/{threshold_id}",
+			...options
+		});
+	}
+	/**
+	* Get a generation or run billing receipt
+	*
+	* Returns a billing receipt. Pass generation_id for a per-generation receipt, or run_id for a per-run receipt summed across the orchestration run's meters — both share the same shape (per-model line items with tokens, the price-book version that priced them, and cost, plus totals). Exactly one of generation_id or run_id must be supplied.
+	*
+	*/
+	static getUsageReceipt(options) {
+		return (options?.client ?? client).get({
 			url: "/api/v1/usage/receipt",
 			...options
 		});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/sdk",
-  "version": "0.15.3",
+  "version": "0.15.4",
   "description": "TypeScript SDK for the SOAT API",
   "type": "module",
   "main": "dist/index.mjs",