@hostwebhook/node-types 1.86.0 → 1.87.0

package/dist/registry.js

@@ -412,6 +412,11 @@ exports.NODE_REGISTRY = {
         allStateKey: "allMongoActions",
         color: "#34d399",
         testable: true,
+        /* Modo AI toolkit (2026-09-24): con `aiEnabled` el nodo sólo lo llama un
+           AI Node —como el resto de toolkits—, y una arista del lienzo no le
+           llevaría nada. Hasta que la api y el dashboard le den `aiEnabled`, el
+           campo no existe y esto devuelve `false`: no cambia nada. */
+        isToolOnly: (e) => e.aiEnabled === true,
     },
     postgresAction: {
         type: "postgresAction",
@@ -424,6 +429,11 @@ exports.NODE_REGISTRY = {
         allStateKey: "allPostgresActions",
         color: "#336791",
         testable: true,
+        /* Modo AI toolkit (2026-09-24): con `aiEnabled` el nodo sólo lo llama un
+           AI Node —como el resto de toolkits—, y una arista del lienzo no le
+           llevaría nada. Hasta que la api y el dashboard le den `aiEnabled`, el
+           campo no existe y esto devuelve `false`: no cambia nada. */
+        isToolOnly: (e) => e.aiEnabled === true,
     },
     notificationAction: {
         type: "notificationAction",

package/dist/sheets-toolkit.d.ts

@@ -34,7 +34,8 @@ export interface SheetsToolkitSpec {
     toolName: string;
     description: string;
     parameters: SheetsToolkitParameter[];
-    /** Escribe en la hoja del usuario. Lo usa la confirmación previa del AI Node. */
+    /** Pisa o borra. Lo pone `marcarDestructivas` leyendo el verbo del
+     *  nombre (ver `clase-de-herramienta.ts`), no se escribe a mano. */
     destructive?: boolean;
 }
 export declare const SHEETS_TOOLKIT_SPECS: SheetsToolkitSpec[];

package/dist/sheets-toolkit.js

@@ -22,6 +22,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SHEETS_TOOLKIT_DEFAULTABLE = exports.SHEETS_TOOLKIT_BY_TOOL_NAME = exports.SHEETS_TOOLKIT_SPECS = void 0;
+const clase_de_herramienta_js_1 = require("./clase-de-herramienta.js");
 const p = (name, description, required = true, type = 'string') => ({ name, type, description, required });
 /*
  * La hoja y la pestaña del nodo van como **defecto**, y el modelo puede
@@ -44,14 +45,13 @@ const p = (name, description, required = true, type = 'string') => ({ name, type
 const hoja = () => p('spreadsheetId', "Id of the Google Sheets document — the long chunk of its URL, between /d/ and /edit.");
 const pestana = () => p('sheetName', 'Name of the tab inside the document, exactly as it reads on its tab strip.');
 const fila = (que) => p('row', `JSON object holding ${que}. Keys are the sheet's **header names**, spelled exactly as they appear in its title row: {"Name": "Ariel", "Email": "a@b.c"}. A key that is not a header makes the call fail, so when you do not know the headers, call get_rows first.`);
-exports.SHEETS_TOOLKIT_SPECS = [
+exports.SHEETS_TOOLKIT_SPECS = (0, clase_de_herramienta_js_1.marcarDestructivas)([
     {
         operation: 'appendRow',
         label: 'Append row',
         toolName: 'append_row',
         description: 'Add a new row at the bottom of the tab. It does not check whether the row already exists — when it might, use append_or_update_row instead so you do not duplicate it.',
         parameters: [fila('the values of the new row'), hoja(), pestana()],
-        destructive: true,
     },
     {
         operation: 'updateRow',
@@ -65,7 +65,6 @@ exports.SHEETS_TOOLKIT_SPECS = [
             hoja(),
             pestana(),
         ],
-        destructive: true,
     },
     {
         operation: 'appendOrUpdateRow',
@@ -79,7 +78,6 @@ exports.SHEETS_TOOLKIT_SPECS = [
             hoja(),
             pestana(),
         ],
-        destructive: true,
     },
     {
         operation: 'readRange',
@@ -116,9 +114,8 @@ exports.SHEETS_TOOLKIT_SPECS = [
          * en el nodo, y la api la aplica.
          */
         parameters: [p('title', 'Name of the new document.')],
-        destructive: true,
     },
-];
+]);
 /** Las herramientas por nombre, para despachar una llamada del modelo. */
 exports.SHEETS_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(exports.SHEETS_TOOLKIT_SPECS.map((s) => [s.toolName, s]));
 /**

package/dist/slack-toolkit.d.ts

@@ -38,9 +38,8 @@ export interface SlackToolkitSpec {
     /** Descripción (más reglas de uso) que ve el LLM. */
     description: string;
     parameters: SlackToolkitParameter[];
-    /** Operaciones irreversibles o que cambian privilegios. La capa MCP las
-     *  bloquea cuando el nodo de IA lleva `requireConfirmationForDestructive`,
-     *  salvo que la llamada traiga confirmación explícita. */
+    /** Pisa o borra. Lo pone `marcarDestructivas` leyendo el verbo del
+     *  nombre (ver `clase-de-herramienta.ts`), no se escribe a mano. */
     destructive?: boolean;
 }
 export declare const SLACK_TOOLKIT_SPECS: SlackToolkitSpec[];

package/dist/slack-toolkit.js

@@ -27,8 +27,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SLACK_TOOLKIT_BY_TOOL_NAME = exports.SLACK_TOOLKIT_SPECS = void 0;
 exports.herramientasDeSlackPara = herramientasDeSlackPara;
 const slack_operations_js_1 = require("./slack-operations.js");
+const clase_de_herramienta_js_1 = require("./clase-de-herramienta.js");
 const p = (name, description, required = true, type = 'string') => ({ name, type, description, required });
-exports.SLACK_TOOLKIT_SPECS = [
+exports.SLACK_TOOLKIT_SPECS = (0, clase_de_herramienta_js_1.marcarDestructivas)([
     // ── Messages ─────────────────────────────────────────────────────
     {
         operation: 'sendMessage',
@@ -67,7 +68,6 @@ exports.SLACK_TOOLKIT_SPECS = [
             p('channel', 'Channel where the message lives.'),
             p('ts', 'Timestamp of the message to delete.'),
         ],
-        destructive: true,
     },
     {
         operation: 'sendEphemeral',
@@ -146,7 +146,6 @@ exports.SLACK_TOOLKIT_SPECS = [
             p('name', 'Channel name — lowercase, no spaces, max 80 chars.'),
             p('isPrivate', 'Create a private channel instead of public. Default false.', false, 'boolean'),
         ],
-        destructive: true,
     },
     {
         operation: 'inviteToChannel',
@@ -216,7 +215,7 @@ exports.SLACK_TOOLKIT_SPECS = [
             p('threadTs', 'Thread to attach the file to.', false),
         ],
     },
-];
+]);
 exports.SLACK_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(exports.SLACK_TOOLKIT_SPECS.map((s) => [s.toolName, s]));
 /**
  * Las herramientas que ofrecerle al modelo con ESTA credencial.

package/dist/telegram-toolkit.d.ts

@@ -39,6 +39,9 @@ export interface TelegramToolkitSpec {
     /** Descripción (más reglas de uso) que ve el LLM. */
     description: string;
     parameters: TelegramToolkitParameter[];
+    /** Pisa o borra. Lo pone `marcarDestructivas` leyendo el verbo del
+     *  nombre (ver `clase-de-herramienta.ts`), no se escribe a mano. */
+    destructive?: boolean;
     /**
      * Encabezado de grupo para la lista de la página de detalle. Las filas
      * consecutivas que comparten grupo se pintan bajo un único título, así que el

package/dist/telegram-toolkit.js

@@ -22,6 +22,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TELEGRAM_TOOLKIT_BY_TOOL_NAME = exports.TELEGRAM_TOOLKIT_SPECS = void 0;
+const clase_de_herramienta_js_1 = require("./clase-de-herramienta.js");
 const p = (name, description, required = true, type = 'string') => ({ name, type, description, required });
 /*
  * `sendAndWaitForResponse` NO está aquí, y es una decisión, no un olvido: la op
@@ -36,7 +37,7 @@ const p = (name, description, required = true, type = 'string') => ({ name, type
  * campo en ninguna de las dos capas, y añadirlo cambiaría cuándo el AI Node pide
  * confirmación. Eso es otra decisión, no parte de mudar el esquema de sitio.
  */
-exports.TELEGRAM_TOOLKIT_SPECS = [
+exports.TELEGRAM_TOOLKIT_SPECS = (0, clase_de_herramienta_js_1.marcarDestructivas)([
     {
         operation: 'sendMessage',
         label: 'Send message',
@@ -181,6 +182,6 @@ exports.TELEGRAM_TOOLKIT_SPECS = [
             p('showAlert', 'Optional. true = modal alert; false (default) = toast notification.', false, 'boolean'),
         ],
     },
-];
+]);
 /** Las herramientas por nombre, para despachar una llamada del modelo. */
 exports.TELEGRAM_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(exports.TELEGRAM_TOOLKIT_SPECS.map((s) => [s.toolName, s]));

package/dist/toolkits.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Los toolkits por tipo de nodo: qué herramientas expone cada nodo en modo
+ * AI toolkit, en un solo sitio.
+ *
+ * ## Para qué (2026-09-24)
+ *
+ * Para que el gate «Block destructive tool calls» del AI Node pueda preguntar
+ * por la OPERACIÓN y no sólo por el nombre. Hasta hoy sólo miraba el nombre
+ * contra unos patrones (`delete_*`, `drop_*`…), así que `update_row` de Sheets
+ * —que pisa una fila— pasaba con el gate encendido. Con esto, la herramienta
+ * que el AI Node guardó al conectar (`nodeRefType` + `operationOverride`) se
+ * resuelve aquí a su operación, y su `destructive` —que sale del verbo, ver
+ * `clase-de-herramienta.ts`— decide.
+ *
+ * ## Lo que falta aquí, a propósito
+ *
+ * WhatsApp y Contacts siguen con sus specs escritos a mano en la api y en el
+ * dashboard, no en este paquete. Hasta que se muden, quien consulte este
+ * registro tiene que componerlos por su lado — {@link esOperacionDestructiva}
+ * devuelve `null` para ellos, que significa «no lo sé», no «no es
+ * destructiva».
+ */
+/** Lo mínimo de una herramienta de toolkit que hace falta para decidir. */
+export interface OperacionDeToolkit {
+    operation: string;
+    toolName: string;
+    label: string;
+    destructive?: boolean;
+}
+export declare const TOOLKITS_POR_TIPO: Readonly<Record<string, readonly OperacionDeToolkit[]>>;
+/**
+ * La operación de un toolkit, buscada por su nombre interno (`updateRow`) O
+ * por el nombre de su herramienta (`update_row`).
+ *
+ * Las dos formas porque las dos llegan: el AI Node guarda `operationOverride`
+ * con el nombre interno, y el servidor MCP recibe el nombre de la herramienta.
+ */
+export declare function operacionDeToolkit(nodeType: string | undefined | null, operacionONombre: string | undefined | null): OperacionDeToolkit | null;
+/**
+ * ¿Es destructiva esta operación de toolkit?
+ *
+ * `null` cuando no se sabe —el tipo no es un toolkit de este paquete, o la
+ * operación no existe en él—. Quien llama decide qué hace con el «no sé»; el
+ * gate del AI Node lo combina con los patrones de nombre, que siguen ahí para
+ * las herramientas que no son de toolkit (MCP, HTTP…).
+ */
+export declare function esOperacionDestructiva(nodeType: string | undefined | null, operacionONombre: string | undefined | null): boolean | null;

package/dist/toolkits.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Los toolkits por tipo de nodo: qué herramientas expone cada nodo en modo
+ * AI toolkit, en un solo sitio.
+ *
+ * ## Para qué (2026-09-24)
+ *
+ * Para que el gate «Block destructive tool calls» del AI Node pueda preguntar
+ * por la OPERACIÓN y no sólo por el nombre. Hasta hoy sólo miraba el nombre
+ * contra unos patrones (`delete_*`, `drop_*`…), así que `update_row` de Sheets
+ * —que pisa una fila— pasaba con el gate encendido. Con esto, la herramienta
+ * que el AI Node guardó al conectar (`nodeRefType` + `operationOverride`) se
+ * resuelve aquí a su operación, y su `destructive` —que sale del verbo, ver
+ * `clase-de-herramienta.ts`— decide.
+ *
+ * ## Lo que falta aquí, a propósito
+ *
+ * WhatsApp y Contacts siguen con sus specs escritos a mano en la api y en el
+ * dashboard, no en este paquete. Hasta que se muden, quien consulte este
+ * registro tiene que componerlos por su lado — {@link esOperacionDestructiva}
+ * devuelve `null` para ellos, que significa «no lo sé», no «no es
+ * destructiva».
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOLKITS_POR_TIPO = void 0;
+exports.operacionDeToolkit = operacionDeToolkit;
+exports.esOperacionDestructiva = esOperacionDestructiva;
+const gmail_operations_js_1 = require("./gmail-operations.js");
+const calendar_toolkit_js_1 = require("./calendar-toolkit.js");
+const drive_toolkit_js_1 = require("./drive-toolkit.js");
+const telegram_toolkit_js_1 = require("./telegram-toolkit.js");
+const discord_toolkit_js_1 = require("./discord-toolkit.js");
+const slack_toolkit_js_1 = require("./slack-toolkit.js");
+const sheets_toolkit_js_1 = require("./sheets-toolkit.js");
+const docs_toolkit_js_1 = require("./docs-toolkit.js");
+const mongo_toolkit_js_1 = require("./mongo-toolkit.js");
+const postgres_toolkit_js_1 = require("./postgres-toolkit.js");
+exports.TOOLKITS_POR_TIPO = Object.freeze({
+    gmailAction: gmail_operations_js_1.GMAIL_ALL_TOOLKIT_SPECS,
+    emailAction: gmail_operations_js_1.NATIVE_EMAIL_TOOLKIT_SPECS,
+    calendarAction: calendar_toolkit_js_1.GOOGLE_CALENDAR_TOOLKIT_SPECS,
+    driveAction: drive_toolkit_js_1.DRIVE_TOOLKIT_SPECS,
+    telegramAction: telegram_toolkit_js_1.TELEGRAM_TOOLKIT_SPECS,
+    discordAction: discord_toolkit_js_1.DISCORD_TOOLKIT_SPECS,
+    slackAction: slack_toolkit_js_1.SLACK_TOOLKIT_SPECS,
+    sheetsAction: sheets_toolkit_js_1.SHEETS_TOOLKIT_SPECS,
+    docsAction: docs_toolkit_js_1.DOCS_TOOLKIT_SPECS,
+    mongoAction: mongo_toolkit_js_1.MONGO_TOOLKIT_SPECS,
+    postgresAction: postgres_toolkit_js_1.POSTGRES_TOOLKIT_SPECS,
+});
+/**
+ * La operación de un toolkit, buscada por su nombre interno (`updateRow`) O
+ * por el nombre de su herramienta (`update_row`).
+ *
+ * Las dos formas porque las dos llegan: el AI Node guarda `operationOverride`
+ * con el nombre interno, y el servidor MCP recibe el nombre de la herramienta.
+ */
+function operacionDeToolkit(nodeType, operacionONombre) {
+    if (!nodeType || !operacionONombre)
+        return null;
+    const toolkit = exports.TOOLKITS_POR_TIPO[nodeType];
+    if (!toolkit)
+        return null;
+    return (toolkit.find((s) => s.operation === operacionONombre) ??
+        toolkit.find((s) => s.toolName === operacionONombre) ??
+        null);
+}
+/**
+ * ¿Es destructiva esta operación de toolkit?
+ *
+ * `null` cuando no se sabe —el tipo no es un toolkit de este paquete, o la
+ * operación no existe en él—. Quien llama decide qué hace con el «no sé»; el
+ * gate del AI Node lo combina con los patrones de nombre, que siguen ahí para
+ * las herramientas que no son de toolkit (MCP, HTTP…).
+ */
+function esOperacionDestructiva(nodeType, operacionONombre) {
+    const op = operacionDeToolkit(nodeType, operacionONombre);
+    return op ? op.destructive === true : null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hostwebhook/node-types",
-  "version": "1.86.0",
+  "version": "1.87.0",
   "description": "Shared node type definitions, connection rules, and dispatch config for HostWebhook",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",