@naturali/cli 0.56.4 → 0.57.0

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.56.4";
+var version = "0.57.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const jsonBodySerializer = { bodySerializer: (body) => JSON.stringify(body, (_key, value) => typeof value === "bigint" ? value.toString() : value) };
@@ -1608,7 +1608,7 @@ var Models = class {
 	/**
 	* List models
 	*
-	* Lists catalog models, newest sources merged and sorted by id. Filter by vendor, provider, output/input modality or status.
+	* Lists catalog models, newest sources merged and sorted by id. Filter by vendor, provider, output/input modality, status, or `managed` — the last being the axis that decides whether a model is usable without BYOK credentials, so `?managed=true&status=available` is the set an agent can run on today.
 	*
 	*/
 	static listModels(options) {
@@ -1825,6 +1825,10 @@ var Projects = class {
 	}
 	/**
 	* Get a project
+	*
+	* Returns one project. An id you do not own — including one that does not exist — responds `404`, not `403`: the API never confirms that an id exists elsewhere.
+	* `403` is reserved for the one case where there is nothing to hide: a project you *do* own, addressed with a credential scoped to a different one. There the wrong-credential message is what makes the failure fixable.
+	*
 	*/
 	static getProject(options) {
 		return (options.client ?? client).get({
@@ -1854,6 +1858,8 @@ var Projects = class {
 	*
 	* The per-project meter — the re-billing view (A11/C12/P3). Aggregates the project's usage over an optional [from, to] window, bucketed by a single dimension. Costs are the billing-grade cost_usd the runtime freezes at write time; null means nothing in the bucket was priced (never that it was free). Only managed providers are priced (on the runtime), so cost reflects managed usage; BYOK usage carries no LLM cost.
 	*
+	* Every bucket also carries components — the amounts actually measured. The token counts describe LLM usage alone, so that is where a storage, api_request or compute_execution bucket reports its real quantity instead of zeroed token fields.
+	*
 	*/
 	static getProjectUsage(options) {
 		return (options.client ?? client).get({
@@ -3144,7 +3150,7 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum items per page.",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -3301,7 +3307,7 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum items per page.",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -3333,7 +3339,7 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum items per page.",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -3629,7 +3635,7 @@ const routes = {
 		queryParams: ["limit", "cursor"],
 		flags: [{
 			"name": "limit",
-			"description": "Maximum items per page.",
+			"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 			"required": false,
 			"type": "integer",
 			"in": "query"
@@ -3763,7 +3769,7 @@ const routes = {
 		queryParams: ["limit", "cursor"],
 		flags: [{
 			"name": "limit",
-			"description": "Maximum items per page.",
+			"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 			"required": false,
 			"type": "integer",
 			"in": "query"
@@ -3927,7 +3933,7 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum items per page.",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -4133,7 +4139,7 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum items per page.",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -4486,7 +4492,7 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum items per page.",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -4742,7 +4748,7 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum items per page.",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -5043,7 +5049,7 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum items per page.",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -5243,7 +5249,7 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum items per page.",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -5464,7 +5470,7 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum items per page.",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -5680,7 +5686,7 @@ const routes = {
 	"list-models": {
 		serviceClass: "Models",
 		operationId: "listModels",
-		description: "Lists catalog models, newest sources merged and sorted by id. Filter by vendor, provider, output/input modality or status.",
+		description: "Lists catalog models, newest sources merged and sorted by id. Filter by vendor, provider, output/input modality, status, or `managed` — the last being the axis that decides whether a model is usable without BYOK credentials, so `?managed=true&status=available` is the set an agent can run on today.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/models",
 		httpMethod: "get",
 		pathParams: [],
@@ -5696,7 +5702,7 @@ const routes = {
 		flags: [
 			{
 				"name": "limit",
-				"description": "Maximum items per page.",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -6200,7 +6206,7 @@ const routes = {
 		queryParams: ["limit", "cursor"],
 		flags: [{
 			"name": "limit",
-			"description": "Maximum items per page.",
+			"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 			"required": false,
 			"type": "integer",
 			"in": "query"
@@ -6231,7 +6237,7 @@ const routes = {
 	"get-project": {
 		serviceClass: "Projects",
 		operationId: "getProject",
-		description: "Get a project",
+		description: "Returns one project. An id you do not own — including one that does not exist — responds `404`, not `403`: the API never confirms that an id exists elsewhere. `403` is reserved for the one case where there is nothing to hide: a project you *do* own, addressed with a credential scoped to a different one. There the wrong-credential message is what makes the failure fixable.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/projects",
 		httpMethod: "get",
 		pathParams: ["project_id"],
@@ -6315,12 +6321,13 @@ const routes = {
 	"get-project-usage": {
 		serviceClass: "Projects",
 		operationId: "getProjectUsage",
-		description: "The per-project meter — the re-billing view (A11/C12/P3). Aggregates the project's usage over an optional [from, to] window, bucketed by a single dimension. Costs are the billing-grade cost_usd the runtime freezes at write time; null means nothing in the bucket was priced (never that it was free). Only managed providers are priced (on the runtime), so cost reflects managed usage; BYOK usage carries no LLM cost.",
+		description: "The per-project meter — the re-billing view (A11/C12/P3). Aggregates the project's usage over an optional [from, to] window, bucketed by a single dimension. Costs are the billing-grade cost_usd the runtime freezes at write time; null means nothing in the bucket was priced (never that it was free). Only managed providers are priced (on the runtime), so cost reflects managed usage; BYOK usage carries no LLM cost. Every bucket also carries components — the amounts actually measured. The token counts describe LLM usage alone, so that is where a storage, api_request or compute_execution bucket reports its real quantity instead of zeroed token fields.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/projects",
 		httpMethod: "get",
 		pathParams: ["project_id"],
 		queryParams: [
 			"group_by",
+			"meter_type",
 			"from",
 			"to"
 		],
@@ -6339,6 +6346,13 @@ const routes = {
 				"type": "string",
 				"in": "query"
 			},
+			{
+				"name": "meter_type",
+				"description": "Narrow the rollup to one meter type (llm_tokens, compute_execution, api_request, storage). Omit to include every meter. Useful with group_by=model, whose dimension otherwise mixes model ids with platform SKUs. An unrecognized value yields an empty rollup, not an error.\n",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
 			{
 				"name": "from",
 				"description": "Inclusive lower bound (ISO-8601) on event time. Omit for no lower bound.",
@@ -6373,7 +6387,7 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum items per page.",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -6888,7 +6902,7 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum items per page.",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -7117,7 +7131,7 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum items per page.",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -7891,7 +7905,7 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum items per page.",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 				"required": false,
 				"type": "integer",
 				"in": "query"
@@ -8094,7 +8108,7 @@ const routes = {
 			},
 			{
 				"name": "limit",
-				"description": "Maximum items per page.",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 				"required": false,
 				"type": "integer",
 				"in": "query"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.56.4",
+  "version": "0.57.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.56.4"
+    "@naturali/sdk": "0.57.0"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",