@naturali/cli 0.212.2 → 0.212.4

package/dist/index.mjs

@@ -17,7 +17,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.212.2";
+var version = "0.212.4";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -939,13 +939,16 @@ var Channels = class {
 	* Connect a channel
 	*
 	* Connect a channel. The required fields depend on `channel`; no credential is ever returned.
-	* **Discord** (`channel: discord`) — supply `application_id` and `bot_token`, plus the `modes` selecting which Gateway flows to serve (direct messages, and/or @mention-opens-a-thread). The token is checked with Discord first: `400 invalid_bot_token` when Discord rejects it, `400 application_mismatch` when it belongs to another application. Returns `501` when this deployment does not enable Discord channels.
+	* **Discord** (`channel: discord`) — supply `application_id` and `bot_token`, plus the `modes` selecting which Gateway flows to serve (direct messages, and/or @mention-opens-a-thread). The token is checked with Discord first: `400 invalid_bot_token` when Discord rejects it, `400 application_mismatch` when it belongs to another application, `502 discord_unavailable` when Discord cannot be read. Returns `501` when this deployment does not enable Discord channels.
 	* **WhatsApp** (default) — one of two credential paths, both filling the same write-only secret:
 	* * **BYOT** (`credential_source: byot`, default) — supply
 	* `phone_number_id` and `access_token` from your own Meta app. The
 	* number is read with the token first: `400 invalid_access_token` when
 	* Meta rejects the token, `400 phone_number_not_accessible` when it
 	* cannot reach that number, `502 meta_unavailable` when Meta fails.
+	* The token's app is then subscribed to the WABA Meta reports as the
+	* number's owner, which is the `waba_id` stored:
+	* `400 waba_not_manageable` when the token cannot subscribe to it.
 	*
 	* * **Embedded signup** (`credential_source: embedded_signup`) — supply
 	* `code` and `waba_id` from the Meta popup; naturali exchanges the
@@ -5713,7 +5716,7 @@ var Tools = class {
 	/**
 	* Create a tool
 	*
-	* Creates a new tool in the project.
+	* Creates a new tool in the project. A `{{secret:...}}` reference in `execute`, `mcp` or a pipeline step also needs `secrets:UseSecret` on that secret, else `403`.
 	*/
 	static createTool(options) {
 		return (options.client ?? client).post({
@@ -5751,7 +5754,7 @@ var Tools = class {
 	/**
 	* Update a tool
 	*
-	* Updates an existing tool.
+	* Updates an existing tool. A `{{secret:...}}` reference in `execute`, `mcp` or a pipeline step also needs `secrets:UseSecret` on that secret, else `403`.
 	*/
 	static updateTool(options) {
 		return (options.client ?? client).patch({
@@ -11153,7 +11156,7 @@ const routes = {
 	"create-channel": {
 		serviceClass: "Channels",
 		operationId: "createChannel",
-		description: "Connect a channel. The required fields depend on `channel`; no credential is ever returned. **Discord** (`channel: discord`) — supply `application_id` and `bot_token`, plus the `modes` selecting which Gateway flows to serve (direct messages, and/or @mention-opens-a-thread). The token is checked with Discord first: `400 invalid_bot_token` when Discord rejects it, `400 application_mismatch` when it belongs to another application. Returns `501` when this deployment does not enable Discord channels. **WhatsApp** (default) — one of two credential paths, both filling the same write-only secret: * **BYOT** (`credential_source: byot`, default) — supply `phone_number_id` and `access_token` from your own Meta app. The number is read with the token first: `400 invalid_access_token` when Meta rejects the token, `400 phone_number_not_accessible` when it cannot reach that number, `502 meta_unavailable` when Meta fails. * **Embedded signup** (`credential_source: embedded_signup`) — supply `code` and `waba_id` from the Meta popup; naturali exchanges the `code` for the token, subscribes its app to the WABA and registers the number for sending when it is not yet, so the customer never hands over a token. Returns `501` on deployments where Meta App credentials are not configured. The project's plan limits how many channels it may hold. At the limit this responds `403` with `plan_limit_reached`, whose `details` carry the `plan` and the `limit`, before any credential is acquired. Only `active` channels count, so disabling one frees allowance without deleting it.",
+		description: "Connect a channel. The required fields depend on `channel`; no credential is ever returned. **Discord** (`channel: discord`) — supply `application_id` and `bot_token`, plus the `modes` selecting which Gateway flows to serve (direct messages, and/or @mention-opens-a-thread). The token is checked with Discord first: `400 invalid_bot_token` when Discord rejects it, `400 application_mismatch` when it belongs to another application, `502 discord_unavailable` when Discord cannot be read. Returns `501` when this deployment does not enable Discord channels. **WhatsApp** (default) — one of two credential paths, both filling the same write-only secret: * **BYOT** (`credential_source: byot`, default) — supply `phone_number_id` and `access_token` from your own Meta app. The number is read with the token first: `400 invalid_access_token` when Meta rejects the token, `400 phone_number_not_accessible` when it cannot reach that number, `502 meta_unavailable` when Meta fails. The token's app is then subscribed to the WABA Meta reports as the number's owner, which is the `waba_id` stored: `400 waba_not_manageable` when the token cannot subscribe to it. * **Embedded signup** (`credential_source: embedded_signup`) — supply `code` and `waba_id` from the Meta popup; naturali exchanges the `code` for the token, subscribes its app to the WABA and registers the number for sending when it is not yet, so the customer never hands over a token. Returns `501` on deployments where Meta App credentials are not configured. The project's plan limits how many channels it may hold. At the limit this responds `403` with `plan_limit_reached`, whose `details` carry the `plan` and the `limit`, before any credential is acquired. Only `active` channels count, so disabling one frees allowance without deleting it.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/channels",
 		httpMethod: "post",
 		pathParams: ["project_id"],
@@ -11233,7 +11236,7 @@ const routes = {
 			},
 			{
 				"name": "waba_id",
-				"description": "Required for `embedded_signup`; optional for `byot`.",
+				"description": "Required for `embedded_signup`. Optional for `byot`, used only when Meta does not report the WABA that owns the number.\n",
 				"required": false,
 				"type": "string",
 				"in": "body"
@@ -22877,7 +22880,7 @@ const routes = {
 	"create-tool": {
 		serviceClass: "Tools",
 		operationId: "createTool",
-		description: "Creates a new tool in the project.",
+		description: "Creates a new tool in the project. A `{{secret:...}}` reference in `execute`, `mcp` or a pipeline step also needs `secrets:UseSecret` on that secret, else `403`.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/tools",
 		httpMethod: "post",
 		pathParams: ["project_id"],
@@ -23012,7 +23015,7 @@ const routes = {
 	"update-tool": {
 		serviceClass: "Tools",
 		operationId: "updateTool",
-		description: "Updates an existing tool.",
+		description: "Updates an existing tool. A `{{secret:...}}` reference in `execute`, `mcp` or a pipeline step also needs `secrets:UseSecret` on that secret, else `403`.",
 		moduleDocsUrl: "https://naturali.ai/docs/modules/tools",
 		httpMethod: "patch",
 		pathParams: ["project_id", "tool_id"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.212.2",
+  "version": "0.212.4",
   "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.212.2",
+    "@naturali/sdk": "0.212.4",
     "@ttoss/openapi-codegen": "^0.10.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",