@naturali/cli 0.203.0 → 0.204.0

package/dist/index.mjs

@@ -17,7 +17,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.203.0";
+var version = "0.204.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -1857,7 +1857,7 @@ var Assistant = class {
 	/**
 	* Read a conversation
 	*
-	* The newest 100 messages of one conversation, oldest first.
+	* A page of one conversation, oldest first. `offset` and `total` count every stored message, tool-only turns included, which this list leaves out — so a page can hold fewer than `limit`, and the list ends when `offset + limit` reaches `total`. The newest page is at `offset = total - limit`.
 	*
 	*/
 	static listAssistantSessionMessages(options) {
@@ -5958,7 +5958,7 @@ var Users = class {
 	*
 	* The plan the account is on, how long its projects may keep content, how much indexed storage it is holding, and the credit it has left — the figures the platform already enforces against, readable by the account they are enforced against.
 	*
-	* A managed-model generation is refused with `402 insufficient_credit` while `credit_balance_usd` is negative, and a feature or a resource count outside the plan is refused with `403`, as is a retention window wider than `retention_days` or an ingest past `storage_limit_gb`. Every refusal names what is missing; this is where the numbers behind them are read.
+	* A managed-model generation is refused with `402 insufficient_credit` while `credit_balance_usd` is negative, and a feature or a resource count outside the plan is refused with `403`, as is a retention window wider than `retention_days` or an ingest past `storage.limit`. Every refusal names what is missing; this is where the numbers behind them are read.
 	*
 	* Every figure here is a local read, which is what keeps this route cheap enough to poll — unlike `GET /v1/users/me/usage`, which asks the meter once per project.
 	*
@@ -7192,6 +7192,15 @@ const buildCallOptions = (args) => {
 * renamed operation fails a test instead of silently disarming this.
 */
 const OUTCOME_IN_BODY = /* @__PURE__ */ new Set(["createFormation", "updateFormation"]);
+/** `CODE: message` from a formation's `StoredError`, when it carries either. */
+const storedErrorReason = (error) => {
+	if (typeof error !== "object" || error === null) return void 0;
+	const { code, message } = error;
+	const parts = [code, message].filter((part) => {
+		return typeof part === "string" && part.length > 0;
+	});
+	return parts.length > 0 ? parts.join(": ") : void 0;
+};
 /**
 * The stderr line for a `2xx` body that reports its own failure, or `undefined`
 * when there is nothing to report.
@@ -7202,7 +7211,7 @@ const bodyReportedFailure = (args) => {
 	if (typeof data !== "object" || data === null) return void 0;
 	const body = data;
 	if (body["status"] !== "failed") return void 0;
-	return `Deploy failed: ${typeof body["error"] === "string" && body["error"].length > 0 ? body["error"] : "no reason given"}`;
+	return `Deploy failed: ${storedErrorReason(body["error"]) ?? "no reason given"}`;
 };
 /**
 * Runs one generated command: parses its flags, resolves credentials, calls the
@@ -10180,7 +10189,7 @@ const routes = {
 		moduleDocsUrl: "https://naturali.ai/docs/modules/assistant",
 		httpMethod: "get",
 		pathParams: [],
-		queryParams: ["limit", "cursor"],
+		queryParams: ["limit", "offset"],
 		headerParams: [],
 		cookieParams: [],
 		flags: [{
@@ -10190,10 +10199,10 @@ const routes = {
 			"type": "integer",
 			"in": "query"
 		}, {
-			"name": "cursor",
-			"description": "Opaque pagination cursor from a previous response's next_cursor.",
+			"name": "offset",
+			"description": "Results to skip. Negative or not an integer it is `400`.",
 			"required": false,
-			"type": "string",
+			"type": "integer",
 			"in": "query"
 		}]
 	},
@@ -10254,20 +10263,36 @@ const routes = {
 	"list-assistant-session-messages": {
 		serviceClass: "Assistant",
 		operationId: "listAssistantSessionMessages",
-		description: "The newest 100 messages of one conversation, oldest first.",
+		description: "A page of one conversation, oldest first. `offset` and `total` count every stored message, tool-only turns included, which this list leaves out — so a page can hold fewer than `limit`, and the list ends when `offset + limit` reaches `total`. The newest page is at `offset = total - limit`.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/assistant",
 		httpMethod: "get",
 		pathParams: ["session_id"],
-		queryParams: [],
+		queryParams: ["limit", "offset"],
 		headerParams: [],
 		cookieParams: [],
-		flags: [{
-			"name": "session_id",
-			"description": "Assistant session ID, as listed.",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}]
+		flags: [
+			{
+				"name": "session_id",
+				"description": "Assistant session ID, as listed.",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is `400`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Results to skip. Negative or not an integer it is `400`.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
 	},
 	"send-assistant-session-message": {
 		serviceClass: "Assistant",
@@ -10286,7 +10311,7 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"name": "text",
+			"name": "content",
 			"description": "",
 			"required": true,
 			"type": "string",
@@ -11063,7 +11088,7 @@ const routes = {
 			},
 			{
 				"name": "default",
-				"description": "`action` is required; `agent_id` is required when it is `agent`, `text` when it is `message`. `repeat` is only valid alongside `action: message`.\n",
+				"description": "",
 				"required": true,
 				"type": "object",
 				"in": "body"
@@ -11240,7 +11265,7 @@ const routes = {
 			},
 			{
 				"name": "default",
-				"description": "`action` is required; `agent_id` is required when it is `agent`, `text` when it is `message`. `repeat` is only valid alongside `action: message`.\n",
+				"description": "",
 				"required": false,
 				"type": "object",
 				"in": "body"
@@ -11365,7 +11390,7 @@ const routes = {
 			},
 			{
 				"name": "identifier",
-				"description": "Filter to one address by its bare, channel-native identifier (a phone number on WhatsApp; a Discord user id, or `thread:<id>` for a guild thread) — the same value the channel itself reports, not the prefixed form the `identifier` field above returns. At most one row matches.\n",
+				"description": "Filter to one address by the identifier conversations carry (`discord:dm:<user_id>`, `discord:thread:<guild_id>:<channel_id>`, `whatsapp:dm:<phone>`), in this channel's kind; any other form is `400`. At most one row matches.\n",
 				"required": false,
 				"type": "string",
 				"in": "query"
@@ -11399,7 +11424,7 @@ const routes = {
 			},
 			{
 				"name": "identifier",
-				"description": "The bare, channel-native identifier (a phone number, a Discord user id).",
+				"description": "The address identifier, in this channel's kind (`whatsapp:dm:<phone>`, `discord:dm:<user_id>`); any other form is `400`.",
 				"required": true,
 				"type": "string",
 				"in": "body"
@@ -23376,7 +23401,7 @@ const routes = {
 	"get-current-user-billing": {
 		serviceClass: "Users",
 		operationId: "getCurrentUserBilling",
-		description: "The plan the account is on, how long its projects may keep content, how much indexed storage it is holding, and the credit it has left — the figures the platform already enforces against, readable by the account they are enforced against. A managed-model generation is refused with `402 insufficient_credit` while `credit_balance_usd` is negative, and a feature or a resource count outside the plan is refused with `403`, as is a retention window wider than `retention_days` or an ingest past `storage_limit_gb`. Every refusal names what is missing; this is where the numbers behind them are read. Every figure here is a local read, which is what keeps this route cheap enough to poll — unlike `GET /v1/users/me/usage`, which asks the meter once per project. Answers for the caller's own account only, and always the account the credential resolves to — an API key answers for the user that minted it. The plan gating a *project* is that project's billing owner's, so a member of someone else's project reads their own rung here, not that project's.",
+		description: "The plan the account is on, how long its projects may keep content, how much indexed storage it is holding, and the credit it has left — the figures the platform already enforces against, readable by the account they are enforced against. A managed-model generation is refused with `402 insufficient_credit` while `credit_balance_usd` is negative, and a feature or a resource count outside the plan is refused with `403`, as is a retention window wider than `retention_days` or an ingest past `storage.limit`. Every refusal names what is missing; this is where the numbers behind them are read. Every figure here is a local read, which is what keeps this route cheap enough to poll — unlike `GET /v1/users/me/usage`, which asks the meter once per project. Answers for the caller's own account only, and always the account the credential resolves to — an API key answers for the user that minted it. The plan gating a *project* is that project's billing owner's, so a member of someone else's project reads their own rung here, not that project's.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/users",
 		httpMethod: "get",
 		pathParams: [],
@@ -23902,7 +23927,7 @@ const routes = {
 			"cursor",
 			"webhook_id",
 			"status",
-			"event_type"
+			"type"
 		],
 		headerParams: [],
 		cookieParams: [],
@@ -23943,7 +23968,7 @@ const routes = {
 				"in": "query"
 			},
 			{
-				"name": "event_type",
+				"name": "type",
 				"description": "Only deliveries of this event type.",
 				"required": false,
 				"type": "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.203.0",
+  "version": "0.204.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.203.0",
+    "@naturali/sdk": "0.204.0",
     "@ttoss/openapi-codegen": "^0.5.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",