@naturali/sdk 0.212.3 → 0.212.4

package/dist/index.cjs

@@ -926,6 +926,9 @@ var Channels = class {
 	* 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
@@ -5693,7 +5696,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({
@@ -5731,7 +5734,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({

package/dist/index.d.cts

@@ -2717,7 +2717,8 @@ type ChannelCreate = {
    */
   pin?: string;
   /**
-   * Required for `embedded_signup`; optional for `byot`.
+   * Required for `embedded_signup`. Optional for `byot`, used only when Meta does not report the WABA that owns the number.
+   *
    */
   waba_id?: string;
   /**
@@ -32671,6 +32672,9 @@ export declare class Channels {
    * 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
@@ -35157,7 +35161,7 @@ export declare class Tools {
   /**
    * 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<ThrowOnError extends boolean = false>(options: Options<CreateToolData, ThrowOnError>): RequestResult<CreateToolResponses, CreateToolErrors, ThrowOnError>;
   /**
@@ -35176,7 +35180,7 @@ export declare class Tools {
   /**
    * 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<ThrowOnError extends boolean = false>(options: Options<UpdateToolData, ThrowOnError>): RequestResult<UpdateToolResponses, UpdateToolErrors, ThrowOnError>;
   /**

package/dist/index.d.mts

@@ -2717,7 +2717,8 @@ type ChannelCreate = {
    */
   pin?: string;
   /**
-   * Required for `embedded_signup`; optional for `byot`.
+   * Required for `embedded_signup`. Optional for `byot`, used only when Meta does not report the WABA that owns the number.
+   *
    */
   waba_id?: string;
   /**
@@ -32671,6 +32672,9 @@ export declare class Channels {
    * 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
@@ -35157,7 +35161,7 @@ export declare class Tools {
   /**
    * 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<ThrowOnError extends boolean = false>(options: Options<CreateToolData, ThrowOnError>): RequestResult<CreateToolResponses, CreateToolErrors, ThrowOnError>;
   /**
@@ -35176,7 +35180,7 @@ export declare class Tools {
   /**
    * 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<ThrowOnError extends boolean = false>(options: Options<UpdateToolData, ThrowOnError>): RequestResult<UpdateToolResponses, UpdateToolErrors, ThrowOnError>;
   /**

package/dist/index.mjs

@@ -925,6 +925,9 @@ var Channels = class {
 	* 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
@@ -5692,7 +5695,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({
@@ -5730,7 +5733,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({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.212.3",
+  "version": "0.212.4",
   "description": "TypeScript SDK for the naturali.ai API, generated from its OpenAPI specs",
   "keywords": [
     "naturali",
@@ -38,7 +38,7 @@
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "^0.99.0",
-    "@naturali/api": "0.212.3",
+    "@naturali/api": "0.212.4",
     "@ttoss/openapi-codegen": "^0.10.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",