@naturali/cli 0.179.0 → 0.181.0

package/dist/index.mjs

@@ -17,7 +17,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.179.0";
+var version = "0.181.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -1162,6 +1162,18 @@ var Admin = class {
 		});
 	}
 	/**
+	* Read a user's usage this billing cycle
+	*
+	* The same answer `GET /v1/users/me/usage` gives the account itself: runs, indexed storage and the plan-capped counts, per project and against the rung. Needs the `admin` role.
+	*
+	*/
+	static getUserUsage(options) {
+		return (options.client ?? client).get({
+			url: "/v1/admin/users/{user_id}/usage",
+			...options
+		});
+	}
+	/**
 	* 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.
@@ -1779,6 +1791,34 @@ var Assistant = class {
 		});
 	}
 	/**
+	* Delete a conversation
+	*
+	* Deletes one of your conversations and its messages. What its turns cost stays on your usage.
+	*
+	*/
+	static deleteAssistantSession(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/assistant/sessions/{session_id}",
+			...options
+		});
+	}
+	/**
+	* Rename a conversation
+	*
+	* Sets the name the conversation is listed by. A name given before the first message is kept.
+	*
+	*/
+	static renameAssistantSession(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/assistant/sessions/{session_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
 	* Read a conversation
 	*
 	* The newest 100 messages of one conversation, oldest first.
@@ -5417,7 +5457,9 @@ var Users = class {
 		});
 	}
 	/**
-	* Get the current account's runs this billing cycle
+	* Get the current account's usage this billing cycle
+	*
+	* What the account uses this billing cycle, per project and against its plan: runs, indexed storage, and the counts the plan caps — projects, active channels and triggers.
 	*
 	* How many runs the account has made this billing cycle, and how many its plan includes. A **run is one agent generation or one tool call** — the unit every rung is priced in. Every tool call counts, including those an agent makes inside a generation; a `client` tool counts nothing.
 	*
@@ -5429,7 +5471,7 @@ var Users = class {
 	*
 	* **This route counts live; the refusal reads a figure counted every few minutes.** So the two can differ by a burst: this is the more current number, and a refusal quotes the one it actually enforced.
 	*
-	* It is also more expensive than the balance read: it asks the meter once per project. Poll it on the order of minutes, not seconds.
+	* It is also more expensive than the balance read: it reads the runtime several times per project. Poll it on the order of minutes, not seconds. A figure that could not be read is `null` rather than failing the request.
 	*
 	*/
 	static getCurrentUserUsage(options) {
@@ -5439,6 +5481,22 @@ var Users = class {
 		});
 	}
 	/**
+	* List the current account's credit ledger
+	*
+	* A cursor page of the account's model-credit ledger, newest first, with the balance the whole ledger sums to. The ledger is append-only: a correction is a new line, never an edit.
+	*
+	* A `usage` line is managed model spend, written as the meter is reconciled every 15 minutes per project, so the ledger grows by a line per project per window that spent anything. Filter with `kind`.
+	*
+	* The other side of a marketplace line is another account's project, so a `fee` or `earned` line names the cycle it settles, not that project.
+	*
+	*/
+	static listCurrentUserCredits(options) {
+		return (options?.client ?? client).get({
+			url: "/v1/users/me/credits",
+			...options
+		});
+	}
+	/**
 	* List what a billing ceiling stopped
 	*
 	* Schedule triggers, eval runs, orchestration runs and workflow tasks the platform stopped on this account's projects because the credit balance went below zero or a Free plan's runs ran out, and that have not been restored or dismissed yet. Newest first.
@@ -7511,7 +7569,11 @@ const routes = {
 		moduleDocsUrl: "https://naturali.ai/docs/modules/admin",
 		httpMethod: "get",
 		pathParams: ["user_id"],
-		queryParams: ["limit", "cursor"],
+		queryParams: [
+			"kind",
+			"limit",
+			"cursor"
+		],
 		headerParams: [],
 		cookieParams: [],
 		flags: [
@@ -7522,6 +7584,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "kind",
+				"description": "Only lines of this kind.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "limit",
 				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
@@ -7579,6 +7648,24 @@ const routes = {
 			}
 		]
 	},
+	"get-user-usage": {
+		serviceClass: "Admin",
+		operationId: "getUserUsage",
+		description: "The same answer `GET /v1/users/me/usage` gives the account itself: runs, indexed storage and the plan-capped counts, per project and against the rung. Needs the `admin` role.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/admin",
+		httpMethod: "get",
+		pathParams: ["user_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "user_id",
+			"description": "",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
 	"get-admin-price-book": {
 		serviceClass: "Admin",
 		operationId: "getAdminPriceBook",
@@ -9511,6 +9598,48 @@ const routes = {
 		cookieParams: [],
 		flags: []
 	},
+	"rename-assistant-session": {
+		serviceClass: "Assistant",
+		operationId: "renameAssistantSession",
+		description: "Sets the name the conversation is listed by. A name given before the first message is kept.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/assistant",
+		httpMethod: "patch",
+		pathParams: ["session_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "session_id",
+			"description": "Assistant session ID, as listed.",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "name",
+			"description": "Trimmed before it is stored.",
+			"required": true,
+			"type": "string",
+			"in": "body"
+		}]
+	},
+	"delete-assistant-session": {
+		serviceClass: "Assistant",
+		operationId: "deleteAssistantSession",
+		description: "Deletes one of your conversations and its messages. What its turns cost stays on your usage.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/assistant",
+		httpMethod: "delete",
+		pathParams: ["session_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "session_id",
+			"description": "Assistant session ID, as listed.",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
 	"list-assistant-session-messages": {
 		serviceClass: "Assistant",
 		operationId: "listAssistantSessionMessages",
@@ -21206,7 +21335,7 @@ const routes = {
 	"get-current-user-usage": {
 		serviceClass: "Users",
 		operationId: "getCurrentUserUsage",
-		description: "How many runs the account has made this billing cycle, and how many its plan includes. A **run is one agent generation or one tool call** — the unit every rung is priced in. Every tool call counts, including those an agent makes inside a generation; a `client` tool counts nothing. Counted across the projects this account is the billing owner of, over the current UTC calendar month, from the meter itself. Archived projects are included: the runs they already made were made. **On the `free` plan the allowance is enforced.** An account that has used it is refused `403 plan_limit_reached` with `resource: \"runs\"` on everything that starts a generation and on a direct tool call — on its own provider credential as much as on a managed model, because a run is a run — until the billing month turns or it upgrades. On `pro` and `business` nothing is refused: runs past the allowance are billed at the overage rate those plans are sold with. A contract plan is not counted. The other thing that stops a managed-model generation is a negative credit balance, which is `GET /v1/users/me/billing`, and it never applies to your own credential. **This route counts live; the refusal reads a figure counted every few minutes.** So the two can differ by a burst: this is the more current number, and a refusal quotes the one it actually enforced. It is also more expensive than the balance read: it asks the meter once per project. Poll it on the order of minutes, not seconds.",
+		description: "What the account uses this billing cycle, per project and against its plan: runs, indexed storage, and the counts the plan caps — projects, active channels and triggers. How many runs the account has made this billing cycle, and how many its plan includes. A **run is one agent generation or one tool call** — the unit every rung is priced in. Every tool call counts, including those an agent makes inside a generation; a `client` tool counts nothing. Counted across the projects this account is the billing owner of, over the current UTC calendar month, from the meter itself. Archived projects are included: the runs they already made were made. **On the `free` plan the allowance is enforced.** An account that has used it is refused `403 plan_limit_reached` with `resource: \"runs\"` on everything that starts a generation and on a direct tool call — on its own provider credential as much as on a managed model, because a run is a run — until the billing month turns or it upgrades. On `pro` and `business` nothing is refused: runs past the allowance are billed at the overage rate those plans are sold with. A contract plan is not counted. The other thing that stops a managed-model generation is a negative credit balance, which is `GET /v1/users/me/billing`, and it never applies to your own credential. **This route counts live; the refusal reads a figure counted every few minutes.** So the two can differ by a burst: this is the more current number, and a refusal quotes the one it actually enforced. It is also more expensive than the balance read: it reads the runtime several times per project. Poll it on the order of minutes, not seconds. A figure that could not be read is `null` rather than failing the request.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/users",
 		httpMethod: "get",
 		pathParams: [],
@@ -21215,6 +21344,44 @@ const routes = {
 		cookieParams: [],
 		flags: []
 	},
+	"list-current-user-credits": {
+		serviceClass: "Users",
+		operationId: "listCurrentUserCredits",
+		description: "A cursor page of the account's model-credit ledger, newest first, with the balance the whole ledger sums to. The ledger is append-only: a correction is a new line, never an edit. A `usage` line is managed model spend, written as the meter is reconciled every 15 minutes per project, so the ledger grows by a line per project per window that spent anything. Filter with `kind`. The other side of a marketplace line is another account's project, so a `fee` or `earned` line names the cycle it settles, not that project.",
+		moduleDocsUrl: "https://naturali.ai/docs/modules/users",
+		httpMethod: "get",
+		pathParams: [],
+		queryParams: [
+			"kind",
+			"limit",
+			"cursor"
+		],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "kind",
+				"description": "Only lines of this kind.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "cursor",
+				"description": "The `next_cursor` of the previous page.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			}
+		]
+	},
 	"list-current-user-stops": {
 		serviceClass: "Users",
 		operationId: "listCurrentUserStops",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.179.0",
+  "version": "0.181.0",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "keywords": [
     "naturali",
@@ -31,7 +31,7 @@
     "yaml": "^2.9.1"
   },
   "devDependencies": {
-    "@naturali/sdk": "0.179.0",
+    "@naturali/sdk": "0.181.0",
     "@ttoss/openapi-codegen": "^0.5.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",