@naturali/sdk 0.125.0 → 0.127.0

package/dist/index.cjs

@@ -1121,6 +1121,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 {
 	/**
@@ -3648,6 +3662,75 @@ var Projects = class {
 			...options
 		});
 	}
+	/**
+	* List project usage events
+	*
+	* The rows a rollup summed — one per metered occurrence, most recent first. Takes the same narrowings [the meter](/docs/api/projects/get-project-usage) does, so a query that produced a bucket answers here unchanged and reads back what went into it. This is the audit and reconciliation view: what was measured, when, against which agent, session, actor and provider, and what each component was priced at.
+	*
+	* An id naming nothing in this project yields an empty page rather than dropping the filter, so a mistyped narrowing can never widen the list past what was asked for.
+	*
+	*/
+	static listProjectUsageEvents(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/usage/events",
+			...options
+		});
+	}
+	/**
+	* Get a generation or orchestration-run billing receipt
+	*
+	* What one occurrence was billed, line by line: per-event line items with their measured components and unit prices, a per-meter-type split, and the totals. Pass generation_id for one generation, or orchestration_run_id for a receipt summed across every event the run metered. Exactly one of the two is required.
+	*
+	* This is the itemisation behind a single number — where [the meter](/docs/api/projects/get-project-usage) says a window cost $12.40, a receipt says which components of which call made up one occurrence of it. On an orchestration-run receipt every line carries node_id, so grouping by it gives the per-node cost the total hides; a retried node contributes one line per attempt, which is the intended reading for spend.
+	*
+	*/
+	static getProjectUsageReceipt(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/usage/receipt",
+			...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 {
 	/**