@hostwebhook/node-types 1.87.0 → 1.88.0

package/dist/esm/google-contacts-toolkit.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Google Contacts AI Toolkit — las herramientas que un googleContactsAction
+ * expone cuando `aiEnabled` está encendido.
+ *
+ * **Se escribe una sola vez** (2026-09-24). Vivía dos veces: en
+ * `api/src/mcp-servers/toolkit-specs.ts` y en
+ * `dashboard/components/google-contacts-actions/google-contacts-operations-schemas.ts`,
+ * las dos a mano. Al mudarlas coincidían exactamente —las 15 operaciones, sus
+ * nombres, textos y parámetros—; el `group` del dashboard ya lo lleva el spec
+ * de formulario (`GOOGLE_CONTACTS_OPERATION_SPECS[op].group`).
+ *
+ * Se llama `GOOGLE_CONTACTS_TOOLKIT_SPECS` y no `…_OPERATION_SPECS` porque ese
+ * nombre ya es el del FORMULARIO del nodo en este paquete — la misma pareja que
+ * Discord y Slack.
+ *
+ * ⚠️ El `destructive` ya no se escribe a mano: lo pone `marcarDestructivas` por
+ * el verbo. Cuatro que la copia vieja marcaba dejan de serlo —crear o añadir no
+ * pisa nada—: `create_contact`, `add_contact_to_group`,
+ * `batch_create_contacts` y `create_contact_group`. El gate del AI Node ya las
+ * leía así (por el verbo del nombre); lo que cambia es la etiqueta del panel.
+ *
+ * Los textos van en inglés porque los lee el modelo.
+ */
+import type { GoogleContactsOperation } from './google-contacts-operations.js';
+export interface GoogleContactsToolkitParameter {
+    name: string;
+    type: 'string' | 'number' | 'boolean';
+    description: string;
+    required: boolean;
+}
+export interface GoogleContactsToolkitSpec {
+    operation: GoogleContactsOperation;
+    /** Etiqueta corta de la fila en la lista de herramientas. */
+    label: string;
+    /** Nombre con el que el LLM llama a la herramienta. */
+    toolName: string;
+    /** Descripción (más reglas de uso) que ve el LLM. */
+    description: string;
+    parameters: GoogleContactsToolkitParameter[];
+    /** 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 GOOGLE_CONTACTS_TOOLKIT_SPECS: GoogleContactsToolkitSpec[];
+/** Las herramientas por nombre, para despachar una llamada del modelo. */
+export declare const GOOGLE_CONTACTS_TOOLKIT_BY_TOOL_NAME: Record<string, GoogleContactsToolkitSpec>;

package/dist/esm/google-contacts-toolkit.js

@@ -0,0 +1,180 @@
+/**
+ * Google Contacts AI Toolkit — las herramientas que un googleContactsAction
+ * expone cuando `aiEnabled` está encendido.
+ *
+ * **Se escribe una sola vez** (2026-09-24). Vivía dos veces: en
+ * `api/src/mcp-servers/toolkit-specs.ts` y en
+ * `dashboard/components/google-contacts-actions/google-contacts-operations-schemas.ts`,
+ * las dos a mano. Al mudarlas coincidían exactamente —las 15 operaciones, sus
+ * nombres, textos y parámetros—; el `group` del dashboard ya lo lleva el spec
+ * de formulario (`GOOGLE_CONTACTS_OPERATION_SPECS[op].group`).
+ *
+ * Se llama `GOOGLE_CONTACTS_TOOLKIT_SPECS` y no `…_OPERATION_SPECS` porque ese
+ * nombre ya es el del FORMULARIO del nodo en este paquete — la misma pareja que
+ * Discord y Slack.
+ *
+ * ⚠️ El `destructive` ya no se escribe a mano: lo pone `marcarDestructivas` por
+ * el verbo. Cuatro que la copia vieja marcaba dejan de serlo —crear o añadir no
+ * pisa nada—: `create_contact`, `add_contact_to_group`,
+ * `batch_create_contacts` y `create_contact_group`. El gate del AI Node ya las
+ * leía así (por el verbo del nombre); lo que cambia es la etiqueta del panel.
+ *
+ * Los textos van en inglés porque los lee el modelo.
+ */
+import { marcarDestructivas } from './clase-de-herramienta.js';
+const p = (name, description, required = true, type = 'string') => ({ name, type, description, required });
+export const GOOGLE_CONTACTS_TOOLKIT_SPECS = marcarDestructivas([
+    // ── Read ─────────────────────────────────────────────────────────
+    {
+        operation: 'searchContacts',
+        label: 'Search contacts',
+        toolName: 'search_contacts',
+        description: "Free-text search across the user's contacts. Matches names, emails, phones, and organization. Use this BEFORE updateContact / deleteContact / addContactToGroup when the user references a contact by name or email — never invent a resourceName.",
+        parameters: [
+            p('query', 'Free-text query (name fragment, email, phone, organization).'),
+            p('pageSize', 'Max results (default 30, hard cap 30).', false, 'number'),
+        ],
+    },
+    {
+        operation: 'listContacts',
+        label: 'List contacts',
+        toolName: 'list_contacts',
+        description: 'Paginated list of every contact. Prefer searchContacts for name/email lookup — listContacts returns hundreds of rows even when the user named one.',
+        parameters: [
+            p('pageSize', 'Page size (default 100, max 1000).', false, 'number'),
+            p('pageToken', 'Token returned by previous listContacts. Empty for first page.', false),
+        ],
+    },
+    {
+        operation: 'getContact',
+        label: 'Get contact',
+        toolName: 'get_contact',
+        description: 'Fetch a single contact by resourceName. Use AFTER searchContacts to read the full record before updating.',
+        parameters: [
+            p('resourceName', 'People API id, e.g. "people/c12345". Get from searchContacts results.'),
+        ],
+    },
+    // ── Write ────────────────────────────────────────────────────────
+    {
+        operation: 'createContact',
+        label: 'Create contact',
+        toolName: 'create_contact',
+        description: "Add a new contact to the user's address book. NEVER call this without confirming with the user first — duplicate contacts are messy to clean up. Pass `fullName` and the helper auto-splits given/family. Pass `emailAddresses` and `phoneNumbers` as arrays of strings.",
+        parameters: [
+            p('fullName', 'Full name (e.g. "Ariel Pérez"). Auto-splits to given + family.', false),
+            p('givenName', 'First name. Overrides the fullName split.', false),
+            p('familyName', 'Last name. Overrides the fullName split.', false),
+            p('emailAddresses', 'Array of email addresses. JSON-encode if your tool layer expects a string.', false),
+            p('phoneNumbers', 'Array of phone numbers.', false),
+            p('notes', 'Free-form note attached to the contact.', false),
+        ],
+    },
+    {
+        operation: 'updateContact',
+        label: 'Update contact',
+        toolName: 'update_contact',
+        description: "Change fields on an existing contact. Get the resourceName from searchContacts first. Update mask is auto-derived from the fields you pass — only include fields you want changed (passing `notes` won't blank out the email).",
+        parameters: [
+            p('resourceName', 'People API id, e.g. "people/c12345".'),
+            p('fullName', 'New full name (auto-splits).', false),
+            p('emailAddresses', 'Replace email list. Pass [] to clear.', false),
+            p('phoneNumbers', 'Replace phone list.', false),
+            p('notes', "Replace the contact's note.", false),
+        ],
+    },
+    {
+        operation: 'deleteContact',
+        label: 'Delete contact',
+        toolName: 'delete_contact',
+        description: 'Permanently remove a contact. Irreversible. ALWAYS confirm with the user before calling. Use searchContacts first to verify you have the right resourceName.',
+        parameters: [p('resourceName', 'People API id of the contact to delete.')],
+    },
+    // ── Groups ───────────────────────────────────────────────────────
+    {
+        operation: 'listContactGroups',
+        label: 'List groups',
+        toolName: 'list_contact_groups',
+        description: "List the user's contact groups (labels). Call this BEFORE addContactToGroup / removeContactFromGroup so you have the right groupResourceName.",
+        parameters: [
+            p('pageSize', 'Page size (default 200, max 1000).', false, 'number'),
+        ],
+    },
+    {
+        operation: 'addContactToGroup',
+        label: 'Add to group',
+        toolName: 'add_contact_to_group',
+        description: 'Add a contact to a group (label). Idempotent — no error if the contact is already in the group. Get the groupResourceName from listContactGroups.',
+        parameters: [
+            p('resourceName', 'Contact id, e.g. "people/c12345". Or array of contact ids.'),
+            p('groupResourceName', 'Group id, e.g. "contactGroups/12345".'),
+        ],
+    },
+    {
+        operation: 'removeContactFromGroup',
+        label: 'Remove from group',
+        toolName: 'remove_contact_from_group',
+        description: 'Remove a contact from a group. Idempotent. Does NOT delete the contact, only its membership in that group.',
+        parameters: [
+            p('resourceName', 'Contact id, e.g. "people/c12345".'),
+            p('groupResourceName', 'Group id, e.g. "contactGroups/12345".'),
+        ],
+    },
+    // ── V2 — bulk + group management ─────────────────────────────────
+    {
+        operation: 'batchCreateContacts',
+        label: 'Batch create contacts',
+        toolName: 'batch_create_contacts',
+        description: 'Bulk-create up to 200 contacts in one call. Each contact in the array uses the same shape as createContact (fullName / emailAddresses / phoneNumbers / notes / etc.).',
+        parameters: [
+            p('contacts', 'Array of contact objects. Same shape as createContact.', true),
+        ],
+    },
+    {
+        operation: 'batchUpdateContacts',
+        label: 'Batch update contacts',
+        toolName: 'batch_update_contacts',
+        description: 'Bulk-update up to 200 existing contacts. Each entry must include `resourceName`. Pass `updateMask` (e.g. "names,emailAddresses") to control which fields the API replaces.',
+        parameters: [
+            p('contacts', 'Array of {resourceName, ...fields} objects.', true),
+            p('updateMask', 'Comma-separated People API field paths to replace.'),
+        ],
+    },
+    {
+        operation: 'batchDeleteContacts',
+        label: 'Batch delete contacts',
+        toolName: 'batch_delete_contacts',
+        description: 'Bulk-delete up to 500 contacts by resourceName. Irreversible.',
+        parameters: [
+            p('resourceNames', 'Array of People API ids, each like "people/c12345".'),
+        ],
+    },
+    {
+        operation: 'createContactGroup',
+        label: 'Create group',
+        toolName: 'create_contact_group',
+        description: 'Create a new contact group (label).',
+        parameters: [p('name', 'Group name as displayed in Contacts.')],
+    },
+    {
+        operation: 'updateContactGroup',
+        label: 'Rename group',
+        toolName: 'update_contact_group',
+        description: 'Rename an existing contact group.',
+        parameters: [
+            p('resourceName', 'Group id, e.g. "contactGroups/12345".'),
+            p('name', 'New name for the group.'),
+        ],
+    },
+    {
+        operation: 'deleteContactGroup',
+        label: 'Delete group',
+        toolName: 'delete_contact_group',
+        description: 'Delete a contact group. Pass `deleteContacts: true` to also delete the contacts in the group (otherwise contacts stay, just lose this membership). Irreversible — confirm with the user before calling.',
+        parameters: [
+            p('resourceName', 'Group id, e.g. "contactGroups/12345".'),
+            p('deleteContacts', 'When true, also delete contacts in the group. Default false.', false, 'boolean'),
+        ],
+    },
+]);
+/** Las herramientas por nombre, para despachar una llamada del modelo. */
+export const GOOGLE_CONTACTS_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(GOOGLE_CONTACTS_TOOLKIT_SPECS.map((s) => [s.toolName, s]));

package/dist/esm/index.d.ts

@@ -76,7 +76,9 @@ export { POSTGRES_TOOLKIT_SPECS, POSTGRES_TOOLKIT_BY_TOOL_NAME, } from './postgr
 export type { PostgresToolkitSpec, PostgresToolkitParameter, } from './postgres-toolkit.js';
 export { claseDeHerramienta, esHerramientaDestructiva, marcarDestructivas, } from './clase-de-herramienta.js';
 export type { ClaseDeHerramienta } from './clase-de-herramienta.js';
-export { TOOLKITS_POR_TIPO, operacionDeToolkit, esOperacionDestructiva, } from './toolkits.js';
+export { TOOLKITS_POR_TIPO, operacionDeToolkit, esOperacionDestructiva, TIPOS_CON_TOOLKIT, tieneModoToolkit, admiteBloqueo, nombresDeHerramientas, bloqueadasDe, herramientaBloqueadaEn, MENSAJE_SIN_HERRAMIENTA, mensajeDeHerramientaBloqueada, motivoParaNoCorrer, } from './toolkits.js';
+export { GOOGLE_CONTACTS_TOOLKIT_SPECS, GOOGLE_CONTACTS_TOOLKIT_BY_TOOL_NAME, } from './google-contacts-toolkit.js';
+export type { GoogleContactsToolkitSpec, GoogleContactsToolkitParameter, } from './google-contacts-toolkit.js';
 export type { OperacionDeToolkit } from './toolkits.js';
 export type { LlmProvider, LlmProviderOption, LlmModelOption, } from './llm-models.js';
 export { LLM_PROVIDERS, LLM_MODELS, MODEL_CONTEXT_WINDOWS, getModelsFor, getDefaultModel, getModelLabel, } from './llm-models.js';

package/dist/esm/index.js

@@ -57,7 +57,11 @@ export { DOCS_TOOLKIT_SPECS, DOCS_TOOLKIT_BY_TOOL_NAME, DOCS_TOOLKIT_DEFAULTABLE
 export { MONGO_TOOLKIT_SPECS, MONGO_TOOLKIT_BY_TOOL_NAME, } from './mongo-toolkit.js';
 export { POSTGRES_TOOLKIT_SPECS, POSTGRES_TOOLKIT_BY_TOOL_NAME, } from './postgres-toolkit.js';
 export { claseDeHerramienta, esHerramientaDestructiva, marcarDestructivas, } from './clase-de-herramienta.js';
-export { TOOLKITS_POR_TIPO, operacionDeToolkit, esOperacionDestructiva, } from './toolkits.js';
+export { TOOLKITS_POR_TIPO, operacionDeToolkit, esOperacionDestructiva, TIPOS_CON_TOOLKIT, tieneModoToolkit, admiteBloqueo, nombresDeHerramientas, bloqueadasDe, herramientaBloqueadaEn, MENSAJE_SIN_HERRAMIENTA, mensajeDeHerramientaBloqueada, motivoParaNoCorrer, } from './toolkits.js';
+/* Contacts se escribía a mano en la api y en el dashboard; ahora una vez. Se
+   llama `…_TOOLKIT_SPECS` porque `GOOGLE_CONTACTS_OPERATION_SPECS` ya es el
+   formulario del nodo — la misma pareja que Discord y Slack. */
+export { GOOGLE_CONTACTS_TOOLKIT_SPECS, GOOGLE_CONTACTS_TOOLKIT_BY_TOOL_NAME, } from './google-contacts-toolkit.js';
 export { LLM_PROVIDERS, LLM_MODELS, MODEL_CONTEXT_WINDOWS, getModelsFor, getDefaultModel, getModelLabel, } from './llm-models.js';
 export { URL_DE_MODELOS_DE_OPENROUTER, opcionesDeModelosDeOpenRouter, ventanaDeContextoDeOpenRouter, } from './openrouter.js';
 export { CREDENTIAL_TYPES, CREDENTIAL_TYPE_VALUES, credentialTypeValues, getCredentialType, isCredentialType, } from './credentials.js';

package/dist/esm/toolkits.d.ts

@@ -14,11 +14,30 @@
  *
  * ## 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».
+ * WhatsApp y Social siguen con sus specs fuera de este paquete (WhatsApp
+ * escrito a mano en la api y el dashboard; Social armado por entidad desde el
+ * registro de proveedores). 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». Contacts se mudó el
+ * 2026-09-24.
+ *
+ * ## El bloqueo por nodo y la puerta sin herramienta (2026-09-24)
+ *
+ * Abajo viven también las dos reglas que se aplican a TODA llamada a un nodo en
+ * modo toolkit, en un solo sitio para que la api, hw-nodes, node-sdk y el
+ * dashboard pregunten lo mismo:
+ *
+ *   - «Block these tool calls»: el dueño bloquea herramientas en el nodo
+ *     (`blockedTools`, por nombre). Vale para todo tipo de este registro
+ *     ({@link admiteBloqueo}).
+ *   - Sin herramienta no se corre: en modo toolkit un nodo sólo ejecuta la
+ *     herramienta que le nombran en `operation`. Un evento sin ella —una arista
+ *     vieja del lienzo— ya no corre la operación de «Single operation», que en
+ *     ese modo no se ve. Decisión de Ariel para los catorce toolkits
+ *     ({@link TIPOS_CON_TOOLKIT}), no sólo los de este registro.
+ *
+ * {@link motivoParaNoCorrer} junta las dos y la llama node-sdk al registrar
+ * cada handler, así que cubre todo camino que acabe en `handler.execute`.
  */
 /** Lo mínimo de una herramienta de toolkit que hace falta para decidir. */
 export interface OperacionDeToolkit {
@@ -45,3 +64,48 @@ export declare function operacionDeToolkit(nodeType: string | undefined | null,
  * las herramientas que no son de toolkit (MCP, HTTP…).
  */
 export declare function esOperacionDestructiva(nodeType: string | undefined | null, operacionONombre: string | undefined | null): boolean | null;
+/**
+ * Los tipos con modo AI toolkit de VARIAS herramientas: los de este registro
+ * más WhatsApp y Social, cuyas herramientas aún no viven aquí. Es la lista de
+ * quién se niega a correr sin herramienta pedida.
+ *
+ * RSS, Mailchimp o Shopify también tienen `aiEnabled`, pero exponen el nodo
+ * como UNA herramienta sin `operation`: no están aquí a propósito.
+ */
+export declare const TIPOS_CON_TOOLKIT: readonly string[];
+export declare function tieneModoToolkit(nodeType: string | undefined | null): boolean;
+/**
+ * ¿Admite «Block these tool calls»? Los de este registro: para bloquear hay
+ * que saber traducir la operación que guarda el AI Node al nombre de la
+ * herramienta que guarda el nodo, y eso sólo se sabe aquí.
+ */
+export declare function admiteBloqueo(nodeType: string | undefined | null): boolean;
+/** Los nombres de herramienta de un toolkit: lo único que `blockedTools` acepta. */
+export declare function nombresDeHerramientas(nodeType: string | undefined | null): string[];
+/** Los nombres bloqueados de un nodo, tolerando documentos sin el campo. */
+export declare function bloqueadasDe(entidad: unknown): string[];
+/**
+ * ¿Está bloqueada en este nodo? Acepta la operación (`deleteOne`, lo que guarda
+ * el AI Node en `operationOverride`) o el nombre (`delete_document`, lo que
+ * recibe el servidor MCP).
+ */
+export declare function herramientaBloqueadaEn(entidad: unknown, nodeType: string | undefined | null, operacionONombre: string | undefined | null): boolean;
+/** Lo que se contesta a una llamada sin herramienta. Lo lee una persona en el
+ *  historial —una arista vieja— o el modelo, así que dice qué hacer. */
+export declare const MENSAJE_SIN_HERRAMIENTA = "This node is an AI toolkit: it only runs the tool an AI Node or an MCP client names, and this call named none. If a connection in the flow leads here, remove it \u2014 in toolkit mode the node is not part of the pipeline.";
+export declare function mensajeDeHerramientaBloqueada(toolName: string): string;
+/**
+ * Por qué una llamada NO debe correr en este nodo, o `null` si puede.
+ *
+ * Sólo mira nodos en modo toolkit (`aiEnabled` y un tipo de
+ * {@link TIPOS_CON_TOOLKIT}); cualquier otro nodo corre como siempre. En modo
+ * toolkit:
+ *   - sin `operation` → {@link MENSAJE_SIN_HERRAMIENTA};
+ *   - con una herramienta bloqueada en el nodo → su mensaje.
+ *
+ * Una operación que el registro no conoce NO se rechaza aquí: cada servicio
+ * sabe qué operaciones acepta (Mongo y Postgres las validan con más detalle),
+ * y rechazar lo desconocido aquí rompería operaciones legítimas que no son
+ * herramientas.
+ */
+export declare function motivoParaNoCorrer(nodeType: string | undefined | null, entidad: unknown, payload: unknown): string | null;

package/dist/esm/toolkits.js

@@ -14,11 +14,30 @@
  *
  * ## 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».
+ * WhatsApp y Social siguen con sus specs fuera de este paquete (WhatsApp
+ * escrito a mano en la api y el dashboard; Social armado por entidad desde el
+ * registro de proveedores). 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». Contacts se mudó el
+ * 2026-09-24.
+ *
+ * ## El bloqueo por nodo y la puerta sin herramienta (2026-09-24)
+ *
+ * Abajo viven también las dos reglas que se aplican a TODA llamada a un nodo en
+ * modo toolkit, en un solo sitio para que la api, hw-nodes, node-sdk y el
+ * dashboard pregunten lo mismo:
+ *
+ *   - «Block these tool calls»: el dueño bloquea herramientas en el nodo
+ *     (`blockedTools`, por nombre). Vale para todo tipo de este registro
+ *     ({@link admiteBloqueo}).
+ *   - Sin herramienta no se corre: en modo toolkit un nodo sólo ejecuta la
+ *     herramienta que le nombran en `operation`. Un evento sin ella —una arista
+ *     vieja del lienzo— ya no corre la operación de «Single operation», que en
+ *     ese modo no se ve. Decisión de Ariel para los catorce toolkits
+ *     ({@link TIPOS_CON_TOOLKIT}), no sólo los de este registro.
+ *
+ * {@link motivoParaNoCorrer} junta las dos y la llama node-sdk al registrar
+ * cada handler, así que cubre todo camino que acabe en `handler.execute`.
  */
 import { GMAIL_ALL_TOOLKIT_SPECS, NATIVE_EMAIL_TOOLKIT_SPECS } from './gmail-operations.js';
 import { GOOGLE_CALENDAR_TOOLKIT_SPECS } from './calendar-toolkit.js';
@@ -30,6 +49,7 @@ import { SHEETS_TOOLKIT_SPECS } from './sheets-toolkit.js';
 import { DOCS_TOOLKIT_SPECS } from './docs-toolkit.js';
 import { MONGO_TOOLKIT_SPECS } from './mongo-toolkit.js';
 import { POSTGRES_TOOLKIT_SPECS } from './postgres-toolkit.js';
+import { GOOGLE_CONTACTS_TOOLKIT_SPECS } from './google-contacts-toolkit.js';
 export const TOOLKITS_POR_TIPO = Object.freeze({
     gmailAction: GMAIL_ALL_TOOLKIT_SPECS,
     emailAction: NATIVE_EMAIL_TOOLKIT_SPECS,
@@ -42,6 +62,7 @@ export const TOOLKITS_POR_TIPO = Object.freeze({
     docsAction: DOCS_TOOLKIT_SPECS,
     mongoAction: MONGO_TOOLKIT_SPECS,
     postgresAction: POSTGRES_TOOLKIT_SPECS,
+    googleContactsAction: GOOGLE_CONTACTS_TOOLKIT_SPECS,
 });
 /**
  * La operación de un toolkit, buscada por su nombre interno (`updateRow`) O
@@ -72,3 +93,86 @@ export function esOperacionDestructiva(nodeType, operacionONombre) {
     const op = operacionDeToolkit(nodeType, operacionONombre);
     return op ? op.destructive === true : null;
 }
+/* ── Quién tiene toolkit, el bloqueo por nodo y la puerta ───────────────── */
+/**
+ * Los tipos con modo AI toolkit de VARIAS herramientas: los de este registro
+ * más WhatsApp y Social, cuyas herramientas aún no viven aquí. Es la lista de
+ * quién se niega a correr sin herramienta pedida.
+ *
+ * RSS, Mailchimp o Shopify también tienen `aiEnabled`, pero exponen el nodo
+ * como UNA herramienta sin `operation`: no están aquí a propósito.
+ */
+export const TIPOS_CON_TOOLKIT = Object.freeze([
+    ...Object.keys(TOOLKITS_POR_TIPO),
+    'whatsappAction',
+    'socialMediaAction',
+]);
+export function tieneModoToolkit(nodeType) {
+    return !!nodeType && TIPOS_CON_TOOLKIT.includes(nodeType);
+}
+/**
+ * ¿Admite «Block these tool calls»? Los de este registro: para bloquear hay
+ * que saber traducir la operación que guarda el AI Node al nombre de la
+ * herramienta que guarda el nodo, y eso sólo se sabe aquí.
+ */
+export function admiteBloqueo(nodeType) {
+    return !!nodeType && Object.prototype.hasOwnProperty.call(TOOLKITS_POR_TIPO, nodeType);
+}
+/** Los nombres de herramienta de un toolkit: lo único que `blockedTools` acepta. */
+export function nombresDeHerramientas(nodeType) {
+    if (!admiteBloqueo(nodeType))
+        return [];
+    return TOOLKITS_POR_TIPO[nodeType].map((s) => s.toolName);
+}
+/** Los nombres bloqueados de un nodo, tolerando documentos sin el campo. */
+export function bloqueadasDe(entidad) {
+    const lista = entidad?.blockedTools;
+    return Array.isArray(lista) ? lista.filter((x) => typeof x === 'string') : [];
+}
+/**
+ * ¿Está bloqueada en este nodo? Acepta la operación (`deleteOne`, lo que guarda
+ * el AI Node en `operationOverride`) o el nombre (`delete_document`, lo que
+ * recibe el servidor MCP).
+ */
+export function herramientaBloqueadaEn(entidad, nodeType, operacionONombre) {
+    if (!operacionONombre)
+        return false;
+    const bloqueadas = bloqueadasDe(entidad);
+    if (bloqueadas.length === 0)
+        return false;
+    const op = operacionDeToolkit(nodeType, operacionONombre);
+    return bloqueadas.includes(op?.toolName ?? operacionONombre);
+}
+/** Lo que se contesta a una llamada sin herramienta. Lo lee una persona en el
+ *  historial —una arista vieja— o el modelo, así que dice qué hacer. */
+export const MENSAJE_SIN_HERRAMIENTA = 'This node is an AI toolkit: it only runs the tool an AI Node or an MCP client names, and this call named none. If a connection in the flow leads here, remove it — in toolkit mode the node is not part of the pipeline.';
+export function mensajeDeHerramientaBloqueada(toolName) {
+    return `The tool "${toolName}" is blocked on this node by its owner. Do not retry it; tell the user it is not allowed here.`;
+}
+/**
+ * Por qué una llamada NO debe correr en este nodo, o `null` si puede.
+ *
+ * Sólo mira nodos en modo toolkit (`aiEnabled` y un tipo de
+ * {@link TIPOS_CON_TOOLKIT}); cualquier otro nodo corre como siempre. En modo
+ * toolkit:
+ *   - sin `operation` → {@link MENSAJE_SIN_HERRAMIENTA};
+ *   - con una herramienta bloqueada en el nodo → su mensaje.
+ *
+ * Una operación que el registro no conoce NO se rechaza aquí: cada servicio
+ * sabe qué operaciones acepta (Mongo y Postgres las validan con más detalle),
+ * y rechazar lo desconocido aquí rompería operaciones legítimas que no son
+ * herramientas.
+ */
+export function motivoParaNoCorrer(nodeType, entidad, payload) {
+    const e = entidad;
+    if (!e || e.aiEnabled !== true || !tieneModoToolkit(nodeType))
+        return null;
+    const pedida = payload?.operation;
+    if (typeof pedida !== 'string' || !pedida.trim())
+        return MENSAJE_SIN_HERRAMIENTA;
+    if (herramientaBloqueadaEn(entidad, nodeType, pedida)) {
+        const op = operacionDeToolkit(nodeType, pedida);
+        return mensajeDeHerramientaBloqueada(op?.toolName ?? pedida);
+    }
+    return null;
+}

package/dist/google-contacts-toolkit.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Google Contacts AI Toolkit — las herramientas que un googleContactsAction
+ * expone cuando `aiEnabled` está encendido.
+ *
+ * **Se escribe una sola vez** (2026-09-24). Vivía dos veces: en
+ * `api/src/mcp-servers/toolkit-specs.ts` y en
+ * `dashboard/components/google-contacts-actions/google-contacts-operations-schemas.ts`,
+ * las dos a mano. Al mudarlas coincidían exactamente —las 15 operaciones, sus
+ * nombres, textos y parámetros—; el `group` del dashboard ya lo lleva el spec
+ * de formulario (`GOOGLE_CONTACTS_OPERATION_SPECS[op].group`).
+ *
+ * Se llama `GOOGLE_CONTACTS_TOOLKIT_SPECS` y no `…_OPERATION_SPECS` porque ese
+ * nombre ya es el del FORMULARIO del nodo en este paquete — la misma pareja que
+ * Discord y Slack.
+ *
+ * ⚠️ El `destructive` ya no se escribe a mano: lo pone `marcarDestructivas` por
+ * el verbo. Cuatro que la copia vieja marcaba dejan de serlo —crear o añadir no
+ * pisa nada—: `create_contact`, `add_contact_to_group`,
+ * `batch_create_contacts` y `create_contact_group`. El gate del AI Node ya las
+ * leía así (por el verbo del nombre); lo que cambia es la etiqueta del panel.
+ *
+ * Los textos van en inglés porque los lee el modelo.
+ */
+import type { GoogleContactsOperation } from './google-contacts-operations.js';
+export interface GoogleContactsToolkitParameter {
+    name: string;
+    type: 'string' | 'number' | 'boolean';
+    description: string;
+    required: boolean;
+}
+export interface GoogleContactsToolkitSpec {
+    operation: GoogleContactsOperation;
+    /** Etiqueta corta de la fila en la lista de herramientas. */
+    label: string;
+    /** Nombre con el que el LLM llama a la herramienta. */
+    toolName: string;
+    /** Descripción (más reglas de uso) que ve el LLM. */
+    description: string;
+    parameters: GoogleContactsToolkitParameter[];
+    /** 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 GOOGLE_CONTACTS_TOOLKIT_SPECS: GoogleContactsToolkitSpec[];
+/** Las herramientas por nombre, para despachar una llamada del modelo. */
+export declare const GOOGLE_CONTACTS_TOOLKIT_BY_TOOL_NAME: Record<string, GoogleContactsToolkitSpec>;

package/dist/google-contacts-toolkit.js

@@ -0,0 +1,183 @@
+"use strict";
+/**
+ * Google Contacts AI Toolkit — las herramientas que un googleContactsAction
+ * expone cuando `aiEnabled` está encendido.
+ *
+ * **Se escribe una sola vez** (2026-09-24). Vivía dos veces: en
+ * `api/src/mcp-servers/toolkit-specs.ts` y en
+ * `dashboard/components/google-contacts-actions/google-contacts-operations-schemas.ts`,
+ * las dos a mano. Al mudarlas coincidían exactamente —las 15 operaciones, sus
+ * nombres, textos y parámetros—; el `group` del dashboard ya lo lleva el spec
+ * de formulario (`GOOGLE_CONTACTS_OPERATION_SPECS[op].group`).
+ *
+ * Se llama `GOOGLE_CONTACTS_TOOLKIT_SPECS` y no `…_OPERATION_SPECS` porque ese
+ * nombre ya es el del FORMULARIO del nodo en este paquete — la misma pareja que
+ * Discord y Slack.
+ *
+ * ⚠️ El `destructive` ya no se escribe a mano: lo pone `marcarDestructivas` por
+ * el verbo. Cuatro que la copia vieja marcaba dejan de serlo —crear o añadir no
+ * pisa nada—: `create_contact`, `add_contact_to_group`,
+ * `batch_create_contacts` y `create_contact_group`. El gate del AI Node ya las
+ * leía así (por el verbo del nombre); lo que cambia es la etiqueta del panel.
+ *
+ * Los textos van en inglés porque los lee el modelo.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GOOGLE_CONTACTS_TOOLKIT_BY_TOOL_NAME = exports.GOOGLE_CONTACTS_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 });
+exports.GOOGLE_CONTACTS_TOOLKIT_SPECS = (0, clase_de_herramienta_js_1.marcarDestructivas)([
+    // ── Read ─────────────────────────────────────────────────────────
+    {
+        operation: 'searchContacts',
+        label: 'Search contacts',
+        toolName: 'search_contacts',
+        description: "Free-text search across the user's contacts. Matches names, emails, phones, and organization. Use this BEFORE updateContact / deleteContact / addContactToGroup when the user references a contact by name or email — never invent a resourceName.",
+        parameters: [
+            p('query', 'Free-text query (name fragment, email, phone, organization).'),
+            p('pageSize', 'Max results (default 30, hard cap 30).', false, 'number'),
+        ],
+    },
+    {
+        operation: 'listContacts',
+        label: 'List contacts',
+        toolName: 'list_contacts',
+        description: 'Paginated list of every contact. Prefer searchContacts for name/email lookup — listContacts returns hundreds of rows even when the user named one.',
+        parameters: [
+            p('pageSize', 'Page size (default 100, max 1000).', false, 'number'),
+            p('pageToken', 'Token returned by previous listContacts. Empty for first page.', false),
+        ],
+    },
+    {
+        operation: 'getContact',
+        label: 'Get contact',
+        toolName: 'get_contact',
+        description: 'Fetch a single contact by resourceName. Use AFTER searchContacts to read the full record before updating.',
+        parameters: [
+            p('resourceName', 'People API id, e.g. "people/c12345". Get from searchContacts results.'),
+        ],
+    },
+    // ── Write ────────────────────────────────────────────────────────
+    {
+        operation: 'createContact',
+        label: 'Create contact',
+        toolName: 'create_contact',
+        description: "Add a new contact to the user's address book. NEVER call this without confirming with the user first — duplicate contacts are messy to clean up. Pass `fullName` and the helper auto-splits given/family. Pass `emailAddresses` and `phoneNumbers` as arrays of strings.",
+        parameters: [
+            p('fullName', 'Full name (e.g. "Ariel Pérez"). Auto-splits to given + family.', false),
+            p('givenName', 'First name. Overrides the fullName split.', false),
+            p('familyName', 'Last name. Overrides the fullName split.', false),
+            p('emailAddresses', 'Array of email addresses. JSON-encode if your tool layer expects a string.', false),
+            p('phoneNumbers', 'Array of phone numbers.', false),
+            p('notes', 'Free-form note attached to the contact.', false),
+        ],
+    },
+    {
+        operation: 'updateContact',
+        label: 'Update contact',
+        toolName: 'update_contact',
+        description: "Change fields on an existing contact. Get the resourceName from searchContacts first. Update mask is auto-derived from the fields you pass — only include fields you want changed (passing `notes` won't blank out the email).",
+        parameters: [
+            p('resourceName', 'People API id, e.g. "people/c12345".'),
+            p('fullName', 'New full name (auto-splits).', false),
+            p('emailAddresses', 'Replace email list. Pass [] to clear.', false),
+            p('phoneNumbers', 'Replace phone list.', false),
+            p('notes', "Replace the contact's note.", false),
+        ],
+    },
+    {
+        operation: 'deleteContact',
+        label: 'Delete contact',
+        toolName: 'delete_contact',
+        description: 'Permanently remove a contact. Irreversible. ALWAYS confirm with the user before calling. Use searchContacts first to verify you have the right resourceName.',
+        parameters: [p('resourceName', 'People API id of the contact to delete.')],
+    },
+    // ── Groups ───────────────────────────────────────────────────────
+    {
+        operation: 'listContactGroups',
+        label: 'List groups',
+        toolName: 'list_contact_groups',
+        description: "List the user's contact groups (labels). Call this BEFORE addContactToGroup / removeContactFromGroup so you have the right groupResourceName.",
+        parameters: [
+            p('pageSize', 'Page size (default 200, max 1000).', false, 'number'),
+        ],
+    },
+    {
+        operation: 'addContactToGroup',
+        label: 'Add to group',
+        toolName: 'add_contact_to_group',
+        description: 'Add a contact to a group (label). Idempotent — no error if the contact is already in the group. Get the groupResourceName from listContactGroups.',
+        parameters: [
+            p('resourceName', 'Contact id, e.g. "people/c12345". Or array of contact ids.'),
+            p('groupResourceName', 'Group id, e.g. "contactGroups/12345".'),
+        ],
+    },
+    {
+        operation: 'removeContactFromGroup',
+        label: 'Remove from group',
+        toolName: 'remove_contact_from_group',
+        description: 'Remove a contact from a group. Idempotent. Does NOT delete the contact, only its membership in that group.',
+        parameters: [
+            p('resourceName', 'Contact id, e.g. "people/c12345".'),
+            p('groupResourceName', 'Group id, e.g. "contactGroups/12345".'),
+        ],
+    },
+    // ── V2 — bulk + group management ─────────────────────────────────
+    {
+        operation: 'batchCreateContacts',
+        label: 'Batch create contacts',
+        toolName: 'batch_create_contacts',
+        description: 'Bulk-create up to 200 contacts in one call. Each contact in the array uses the same shape as createContact (fullName / emailAddresses / phoneNumbers / notes / etc.).',
+        parameters: [
+            p('contacts', 'Array of contact objects. Same shape as createContact.', true),
+        ],
+    },
+    {
+        operation: 'batchUpdateContacts',
+        label: 'Batch update contacts',
+        toolName: 'batch_update_contacts',
+        description: 'Bulk-update up to 200 existing contacts. Each entry must include `resourceName`. Pass `updateMask` (e.g. "names,emailAddresses") to control which fields the API replaces.',
+        parameters: [
+            p('contacts', 'Array of {resourceName, ...fields} objects.', true),
+            p('updateMask', 'Comma-separated People API field paths to replace.'),
+        ],
+    },
+    {
+        operation: 'batchDeleteContacts',
+        label: 'Batch delete contacts',
+        toolName: 'batch_delete_contacts',
+        description: 'Bulk-delete up to 500 contacts by resourceName. Irreversible.',
+        parameters: [
+            p('resourceNames', 'Array of People API ids, each like "people/c12345".'),
+        ],
+    },
+    {
+        operation: 'createContactGroup',
+        label: 'Create group',
+        toolName: 'create_contact_group',
+        description: 'Create a new contact group (label).',
+        parameters: [p('name', 'Group name as displayed in Contacts.')],
+    },
+    {
+        operation: 'updateContactGroup',
+        label: 'Rename group',
+        toolName: 'update_contact_group',
+        description: 'Rename an existing contact group.',
+        parameters: [
+            p('resourceName', 'Group id, e.g. "contactGroups/12345".'),
+            p('name', 'New name for the group.'),
+        ],
+    },
+    {
+        operation: 'deleteContactGroup',
+        label: 'Delete group',
+        toolName: 'delete_contact_group',
+        description: 'Delete a contact group. Pass `deleteContacts: true` to also delete the contacts in the group (otherwise contacts stay, just lose this membership). Irreversible — confirm with the user before calling.',
+        parameters: [
+            p('resourceName', 'Group id, e.g. "contactGroups/12345".'),
+            p('deleteContacts', 'When true, also delete contacts in the group. Default false.', false, 'boolean'),
+        ],
+    },
+]);
+/** Las herramientas por nombre, para despachar una llamada del modelo. */
+exports.GOOGLE_CONTACTS_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(exports.GOOGLE_CONTACTS_TOOLKIT_SPECS.map((s) => [s.toolName, s]));

package/dist/index.d.ts

@@ -76,7 +76,9 @@ export { POSTGRES_TOOLKIT_SPECS, POSTGRES_TOOLKIT_BY_TOOL_NAME, } from './postgr
 export type { PostgresToolkitSpec, PostgresToolkitParameter, } from './postgres-toolkit.js';
 export { claseDeHerramienta, esHerramientaDestructiva, marcarDestructivas, } from './clase-de-herramienta.js';
 export type { ClaseDeHerramienta } from './clase-de-herramienta.js';
-export { TOOLKITS_POR_TIPO, operacionDeToolkit, esOperacionDestructiva, } from './toolkits.js';
+export { TOOLKITS_POR_TIPO, operacionDeToolkit, esOperacionDestructiva, TIPOS_CON_TOOLKIT, tieneModoToolkit, admiteBloqueo, nombresDeHerramientas, bloqueadasDe, herramientaBloqueadaEn, MENSAJE_SIN_HERRAMIENTA, mensajeDeHerramientaBloqueada, motivoParaNoCorrer, } from './toolkits.js';
+export { GOOGLE_CONTACTS_TOOLKIT_SPECS, GOOGLE_CONTACTS_TOOLKIT_BY_TOOL_NAME, } from './google-contacts-toolkit.js';
+export type { GoogleContactsToolkitSpec, GoogleContactsToolkitParameter, } from './google-contacts-toolkit.js';
 export type { OperacionDeToolkit } from './toolkits.js';
 export type { LlmProvider, LlmProviderOption, LlmModelOption, } from './llm-models.js';
 export { LLM_PROVIDERS, LLM_MODELS, MODEL_CONTEXT_WINDOWS, getModelsFor, getDefaultModel, getModelLabel, } from './llm-models.js';

package/dist/index.js

@@ -3,7 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GMAIL_SEND_LEGACY_FIELDS = exports.NATIVE_EMAIL_TOOLKIT_BY_TOOL_NAME = exports.GMAIL_TOOLKIT_BY_TOOL_NAME = exports.NATIVE_EMAIL_TOOLKIT_SPECS = exports.GMAIL_SEND_AND_WAIT_TOOL_SPEC = exports.GMAIL_ALL_TOOLKIT_SPECS = exports.GMAIL_TOOLKIT_SPECS = exports.GMAIL_TOOLKIT_OPERATIONS = exports.GMAIL_DROPDOWN_OPERATIONS = exports.GMAIL_OPERATION_GROUPS = exports.GMAIL_OPERATION_SPECS = exports.GMAIL_OPERATIONS = exports.versionCatalogErrors = exports.fieldsLost = exports.fieldsLostBetween = exports.currentVersion = exports.versionSpec = exports.versionsOf = exports.isVersioned = exports.NODE_TYPE_TO_PREFIX = exports.PREFIX_TO_NODE_TYPE = exports.NODE_STATE_KEYS = exports.NODE_COLORS = exports.NODE_DETAIL_PATHS = exports.getNodeRegistryEntry = exports.NODE_REGISTRY = exports.pasaLoQueRecibe = exports.getNodeDispatchConfig = exports.getAllNodeCollections = exports.NODE_DISPATCH = exports.todosLosOutputGroups = exports.outputGroupsFor = exports.esEtiquetaDeSentimiento = exports.SENTIMENT_PORT_SUMMARY = exports.SENTIMENT_PORT_LABEL = exports.SENTIMENT_PORTS = exports.SENTIMENT_UNCLEAR = exports.SENTIMENT_LABELS = exports.resolveNodeId = exports.PREFIX_TO_TYPE = exports.NODE_UI = exports.ALL_NODE_TYPES = exports.isNodeType = exports.isTerminal = exports.canSendToNodes = exports.canReceiveFromNodes = exports.canReceiveFrom = exports.NODE_CONNECTIONS = exports.iterableMeta = exports.singleMeta = void 0;
 exports.isGithubOperation = exports.GITHUB_ITERABLE_OPERATIONS = exports.GITHUB_DROPDOWN_OPERATIONS = exports.GITHUB_OPERATION_SPECS = exports.GITHUB_OPERATIONS = exports.scopesQueFaltanEnShopify = exports.isShopifyOperation = exports.SHOPIFY_PRODUCT_STATUSES = exports.SHOPIFY_CANCEL_REASONS = exports.SHOPIFY_SEARCHABLE_RESOURCES = exports.SHOPIFY_TAGGABLE_RESOURCES = exports.SHOPIFY_OPERATION_SCOPES = exports.SHOPIFY_OPERATION_SPECS = exports.SHOPIFY_OPERATIONS = exports.isMailchimpOperation = exports.MAILCHIMP_CONTACT_STATUSES = exports.MAILCHIMP_OPERATION_SPECS = exports.MAILCHIMP_OPERATIONS = exports.herramientasDeDiscordPara = exports.DISCORD_TOOLKIT_BY_TOOL_NAME = exports.DISCORD_TOOLKIT_SPECS = exports.isDiscordOperation = exports.camposDeDiscordNoDisponibles = exports.discordPuedeEjecutar = exports.operacionesDeDiscordPara = exports.DISCORD_CAPACIDADES_POR_CREDENCIAL = exports.DISCORD_OPERATION_SPECS = exports.DISCORD_OPERATIONS = exports.camposNoDisponiblesPara = exports.puedeEjecutar = exports.operacionesPara = exports.isWhatsAppOperation = exports.WHATSAPP_OPERATIONS = exports.TELEGRAM_TOOLKIT_BY_TOOL_NAME = exports.TELEGRAM_TOOLKIT_SPECS = exports.isTelegramOperation = exports.TELEGRAM_OPERATION_SPECS = exports.TELEGRAM_OPERATIONS = exports.DRIVE_TOOLKIT_BY_TOOL_NAME = exports.DRIVE_TOOLKIT_SPECS = exports.isDriveOperation = exports.DRIVE_OPERATION_SPECS = exports.DRIVE_OPERATIONS = exports.GOOGLE_CALENDAR_TOOLKIT_BY_TOOL_NAME = exports.GOOGLE_CALENDAR_TOOLKIT_SPECS = exports.isGoogleCalendarOperation = exports.GOOGLE_CALENDAR_OPERATION_SPECS = exports.GOOGLE_CALENDAR_OPERATIONS = exports.isGmailOperation = exports.resolveGmailSendFields = void 0;
 exports.NOTION_OPERATION_SPECS = exports.NOTION_OPERATIONS = exports.isGoogleAnalyticsOperation = exports.GOOGLE_ANALYTICS_DROPDOWN_OPERATIONS = exports.GOOGLE_ANALYTICS_OPERATION_SPECS = exports.GOOGLE_ANALYTICS_OPERATIONS = exports.isGoogleContactsOperation = exports.GOOGLE_CONTACTS_DEFAULT_PERSON_FIELDS = exports.GOOGLE_CONTACTS_OPERATION_GROUPS = exports.GOOGLE_CONTACTS_OPERATION_SPECS = exports.GOOGLE_CONTACTS_OPERATIONS_V2 = exports.GOOGLE_CONTACTS_OPERATIONS_V1 = exports.GOOGLE_CONTACTS_OPERATIONS = exports.SHEETS_TOOLKIT_DEFAULTABLE = exports.SHEETS_TOOLKIT_BY_TOOL_NAME = exports.SHEETS_TOOLKIT_SPECS = exports.isSheetsOperation = exports.SHEETS_OPERATION_SPECS = exports.SHEETS_OPERATIONS = exports.herramientasDeSlackPara = exports.SLACK_TOOLKIT_BY_TOOL_NAME = exports.SLACK_TOOLKIT_SPECS = exports.isSlackOperation = exports.camposDeSlackNoDisponibles = exports.slackPuedeEjecutar = exports.operacionesDeSlackPara = exports.SLACK_CAPACIDADES_POR_CREDENCIAL = exports.SLACK_OPERATION_SPECS = exports.SLACK_OPERATIONS = exports.isAirtableOperation = exports.AIRTABLE_ITERABLE_OPERATIONS = exports.AIRTABLE_OPERATION_SPECS = exports.AIRTABLE_OPERATIONS = exports.isCalendlyOperation = exports.CALENDLY_ITERABLE_OPERATIONS = exports.CALENDLY_OPERATION_SPECS = exports.CALENDLY_OPERATIONS = exports.isApifyOperation = exports.APIFY_ITERABLE_OPERATIONS = exports.APIFY_OPERATION_SPECS = exports.APIFY_OPERATIONS = exports.isBucketOperation = exports.BUCKET_ITERABLE_OPERATIONS = exports.BUCKET_OPERATION_SPECS = exports.BUCKET_OPERATIONS = exports.isJiraOperation = exports.JIRA_ITERABLE_OPERATIONS = exports.JIRA_DROPDOWN_OPERATIONS = exports.JIRA_OPERATION_SPECS = exports.JIRA_OPERATIONS = void 0;
-exports.armarRespuestaDelSync = exports.RESPUESTA_DEL_SYNC_POR_DEFECTO = exports.TOPE_DE_ESPERA_DEL_SYNC = exports.TOPES_DE_ESTADO = exports.SOBRES_DE_RESPUESTA = exports.MODOS_DE_PAYLOAD = exports.NIVELES_DE_DETALLE = exports.RESULTADOS_DEL_VALIDADOR = exports.contestaEnSync = exports.NODOS_QUE_CONTESTAN_EN_SYNC = exports.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = exports.ventanaDeContextoDeOpenRouter = exports.opcionesDeModelosDeOpenRouter = exports.URL_DE_MODELOS_DE_OPENROUTER = exports.getModelLabel = exports.getDefaultModel = exports.getModelsFor = exports.MODEL_CONTEXT_WINDOWS = exports.LLM_MODELS = exports.LLM_PROVIDERS = exports.esOperacionDestructiva = exports.operacionDeToolkit = exports.TOOLKITS_POR_TIPO = exports.marcarDestructivas = exports.esHerramientaDestructiva = exports.claseDeHerramienta = exports.POSTGRES_TOOLKIT_BY_TOOL_NAME = exports.POSTGRES_TOOLKIT_SPECS = exports.MONGO_TOOLKIT_BY_TOOL_NAME = exports.MONGO_TOOLKIT_SPECS = exports.DOCS_TOOLKIT_DEFAULTABLE = exports.DOCS_TOOLKIT_BY_TOOL_NAME = exports.DOCS_TOOLKIT_SPECS = exports.isDocsOperation = exports.DOCS_OPERATION_SPECS = exports.DOCS_OPERATIONS = exports.isMongoOperation = exports.MONGO_OPERATION_SPECS = exports.MONGO_OPERATIONS = exports.isPostgresOperation = exports.POSTGRES_OPERATION_SPECS = exports.POSTGRES_MODES = exports.POSTGRES_OPERATIONS = exports.isNotionOperation = exports.NOTION_DROPDOWN_OPERATIONS = void 0;
+exports.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = exports.ventanaDeContextoDeOpenRouter = exports.opcionesDeModelosDeOpenRouter = exports.URL_DE_MODELOS_DE_OPENROUTER = exports.getModelLabel = exports.getDefaultModel = exports.getModelsFor = exports.MODEL_CONTEXT_WINDOWS = exports.LLM_MODELS = exports.LLM_PROVIDERS = exports.GOOGLE_CONTACTS_TOOLKIT_BY_TOOL_NAME = exports.GOOGLE_CONTACTS_TOOLKIT_SPECS = exports.motivoParaNoCorrer = exports.mensajeDeHerramientaBloqueada = exports.MENSAJE_SIN_HERRAMIENTA = exports.herramientaBloqueadaEn = exports.bloqueadasDe = exports.nombresDeHerramientas = exports.admiteBloqueo = exports.tieneModoToolkit = exports.TIPOS_CON_TOOLKIT = exports.esOperacionDestructiva = exports.operacionDeToolkit = exports.TOOLKITS_POR_TIPO = exports.marcarDestructivas = exports.esHerramientaDestructiva = exports.claseDeHerramienta = exports.POSTGRES_TOOLKIT_BY_TOOL_NAME = exports.POSTGRES_TOOLKIT_SPECS = exports.MONGO_TOOLKIT_BY_TOOL_NAME = exports.MONGO_TOOLKIT_SPECS = exports.DOCS_TOOLKIT_DEFAULTABLE = exports.DOCS_TOOLKIT_BY_TOOL_NAME = exports.DOCS_TOOLKIT_SPECS = exports.isDocsOperation = exports.DOCS_OPERATION_SPECS = exports.DOCS_OPERATIONS = exports.isMongoOperation = exports.MONGO_OPERATION_SPECS = exports.MONGO_OPERATIONS = exports.isPostgresOperation = exports.POSTGRES_OPERATION_SPECS = exports.POSTGRES_MODES = exports.POSTGRES_OPERATIONS = exports.isNotionOperation = exports.NOTION_DROPDOWN_OPERATIONS = void 0;
+exports.armarRespuestaDelSync = exports.RESPUESTA_DEL_SYNC_POR_DEFECTO = exports.TOPE_DE_ESPERA_DEL_SYNC = exports.TOPES_DE_ESTADO = exports.SOBRES_DE_RESPUESTA = exports.MODOS_DE_PAYLOAD = exports.NIVELES_DE_DETALLE = exports.RESULTADOS_DEL_VALIDADOR = exports.contestaEnSync = exports.NODOS_QUE_CONTESTAN_EN_SYNC = void 0;
 var types_js_1 = require("./types.js");
 Object.defineProperty(exports, "singleMeta", { enumerable: true, get: function () { return types_js_1.singleMeta; } });
 Object.defineProperty(exports, "iterableMeta", { enumerable: true, get: function () { return types_js_1.iterableMeta; } });
@@ -239,6 +240,21 @@ var toolkits_js_1 = require("./toolkits.js");
 Object.defineProperty(exports, "TOOLKITS_POR_TIPO", { enumerable: true, get: function () { return toolkits_js_1.TOOLKITS_POR_TIPO; } });
 Object.defineProperty(exports, "operacionDeToolkit", { enumerable: true, get: function () { return toolkits_js_1.operacionDeToolkit; } });
 Object.defineProperty(exports, "esOperacionDestructiva", { enumerable: true, get: function () { return toolkits_js_1.esOperacionDestructiva; } });
+Object.defineProperty(exports, "TIPOS_CON_TOOLKIT", { enumerable: true, get: function () { return toolkits_js_1.TIPOS_CON_TOOLKIT; } });
+Object.defineProperty(exports, "tieneModoToolkit", { enumerable: true, get: function () { return toolkits_js_1.tieneModoToolkit; } });
+Object.defineProperty(exports, "admiteBloqueo", { enumerable: true, get: function () { return toolkits_js_1.admiteBloqueo; } });
+Object.defineProperty(exports, "nombresDeHerramientas", { enumerable: true, get: function () { return toolkits_js_1.nombresDeHerramientas; } });
+Object.defineProperty(exports, "bloqueadasDe", { enumerable: true, get: function () { return toolkits_js_1.bloqueadasDe; } });
+Object.defineProperty(exports, "herramientaBloqueadaEn", { enumerable: true, get: function () { return toolkits_js_1.herramientaBloqueadaEn; } });
+Object.defineProperty(exports, "MENSAJE_SIN_HERRAMIENTA", { enumerable: true, get: function () { return toolkits_js_1.MENSAJE_SIN_HERRAMIENTA; } });
+Object.defineProperty(exports, "mensajeDeHerramientaBloqueada", { enumerable: true, get: function () { return toolkits_js_1.mensajeDeHerramientaBloqueada; } });
+Object.defineProperty(exports, "motivoParaNoCorrer", { enumerable: true, get: function () { return toolkits_js_1.motivoParaNoCorrer; } });
+/* Contacts se escribía a mano en la api y en el dashboard; ahora una vez. Se
+   llama `…_TOOLKIT_SPECS` porque `GOOGLE_CONTACTS_OPERATION_SPECS` ya es el
+   formulario del nodo — la misma pareja que Discord y Slack. */
+var google_contacts_toolkit_js_1 = require("./google-contacts-toolkit.js");
+Object.defineProperty(exports, "GOOGLE_CONTACTS_TOOLKIT_SPECS", { enumerable: true, get: function () { return google_contacts_toolkit_js_1.GOOGLE_CONTACTS_TOOLKIT_SPECS; } });
+Object.defineProperty(exports, "GOOGLE_CONTACTS_TOOLKIT_BY_TOOL_NAME", { enumerable: true, get: function () { return google_contacts_toolkit_js_1.GOOGLE_CONTACTS_TOOLKIT_BY_TOOL_NAME; } });
 var llm_models_js_1 = require("./llm-models.js");
 Object.defineProperty(exports, "LLM_PROVIDERS", { enumerable: true, get: function () { return llm_models_js_1.LLM_PROVIDERS; } });
 Object.defineProperty(exports, "LLM_MODELS", { enumerable: true, get: function () { return llm_models_js_1.LLM_MODELS; } });

package/dist/toolkits.d.ts

@@ -14,11 +14,30 @@
  *
  * ## 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».
+ * WhatsApp y Social siguen con sus specs fuera de este paquete (WhatsApp
+ * escrito a mano en la api y el dashboard; Social armado por entidad desde el
+ * registro de proveedores). 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». Contacts se mudó el
+ * 2026-09-24.
+ *
+ * ## El bloqueo por nodo y la puerta sin herramienta (2026-09-24)
+ *
+ * Abajo viven también las dos reglas que se aplican a TODA llamada a un nodo en
+ * modo toolkit, en un solo sitio para que la api, hw-nodes, node-sdk y el
+ * dashboard pregunten lo mismo:
+ *
+ *   - «Block these tool calls»: el dueño bloquea herramientas en el nodo
+ *     (`blockedTools`, por nombre). Vale para todo tipo de este registro
+ *     ({@link admiteBloqueo}).
+ *   - Sin herramienta no se corre: en modo toolkit un nodo sólo ejecuta la
+ *     herramienta que le nombran en `operation`. Un evento sin ella —una arista
+ *     vieja del lienzo— ya no corre la operación de «Single operation», que en
+ *     ese modo no se ve. Decisión de Ariel para los catorce toolkits
+ *     ({@link TIPOS_CON_TOOLKIT}), no sólo los de este registro.
+ *
+ * {@link motivoParaNoCorrer} junta las dos y la llama node-sdk al registrar
+ * cada handler, así que cubre todo camino que acabe en `handler.execute`.
  */
 /** Lo mínimo de una herramienta de toolkit que hace falta para decidir. */
 export interface OperacionDeToolkit {
@@ -45,3 +64,48 @@ export declare function operacionDeToolkit(nodeType: string | undefined | null,
  * las herramientas que no son de toolkit (MCP, HTTP…).
  */
 export declare function esOperacionDestructiva(nodeType: string | undefined | null, operacionONombre: string | undefined | null): boolean | null;
+/**
+ * Los tipos con modo AI toolkit de VARIAS herramientas: los de este registro
+ * más WhatsApp y Social, cuyas herramientas aún no viven aquí. Es la lista de
+ * quién se niega a correr sin herramienta pedida.
+ *
+ * RSS, Mailchimp o Shopify también tienen `aiEnabled`, pero exponen el nodo
+ * como UNA herramienta sin `operation`: no están aquí a propósito.
+ */
+export declare const TIPOS_CON_TOOLKIT: readonly string[];
+export declare function tieneModoToolkit(nodeType: string | undefined | null): boolean;
+/**
+ * ¿Admite «Block these tool calls»? Los de este registro: para bloquear hay
+ * que saber traducir la operación que guarda el AI Node al nombre de la
+ * herramienta que guarda el nodo, y eso sólo se sabe aquí.
+ */
+export declare function admiteBloqueo(nodeType: string | undefined | null): boolean;
+/** Los nombres de herramienta de un toolkit: lo único que `blockedTools` acepta. */
+export declare function nombresDeHerramientas(nodeType: string | undefined | null): string[];
+/** Los nombres bloqueados de un nodo, tolerando documentos sin el campo. */
+export declare function bloqueadasDe(entidad: unknown): string[];
+/**
+ * ¿Está bloqueada en este nodo? Acepta la operación (`deleteOne`, lo que guarda
+ * el AI Node en `operationOverride`) o el nombre (`delete_document`, lo que
+ * recibe el servidor MCP).
+ */
+export declare function herramientaBloqueadaEn(entidad: unknown, nodeType: string | undefined | null, operacionONombre: string | undefined | null): boolean;
+/** Lo que se contesta a una llamada sin herramienta. Lo lee una persona en el
+ *  historial —una arista vieja— o el modelo, así que dice qué hacer. */
+export declare const MENSAJE_SIN_HERRAMIENTA = "This node is an AI toolkit: it only runs the tool an AI Node or an MCP client names, and this call named none. If a connection in the flow leads here, remove it \u2014 in toolkit mode the node is not part of the pipeline.";
+export declare function mensajeDeHerramientaBloqueada(toolName: string): string;
+/**
+ * Por qué una llamada NO debe correr en este nodo, o `null` si puede.
+ *
+ * Sólo mira nodos en modo toolkit (`aiEnabled` y un tipo de
+ * {@link TIPOS_CON_TOOLKIT}); cualquier otro nodo corre como siempre. En modo
+ * toolkit:
+ *   - sin `operation` → {@link MENSAJE_SIN_HERRAMIENTA};
+ *   - con una herramienta bloqueada en el nodo → su mensaje.
+ *
+ * Una operación que el registro no conoce NO se rechaza aquí: cada servicio
+ * sabe qué operaciones acepta (Mongo y Postgres las validan con más detalle),
+ * y rechazar lo desconocido aquí rompería operaciones legítimas que no son
+ * herramientas.
+ */
+export declare function motivoParaNoCorrer(nodeType: string | undefined | null, entidad: unknown, payload: unknown): string | null;

package/dist/toolkits.js

@@ -15,16 +15,42 @@
  *
  * ## 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».
+ * WhatsApp y Social siguen con sus specs fuera de este paquete (WhatsApp
+ * escrito a mano en la api y el dashboard; Social armado por entidad desde el
+ * registro de proveedores). 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». Contacts se mudó el
+ * 2026-09-24.
+ *
+ * ## El bloqueo por nodo y la puerta sin herramienta (2026-09-24)
+ *
+ * Abajo viven también las dos reglas que se aplican a TODA llamada a un nodo en
+ * modo toolkit, en un solo sitio para que la api, hw-nodes, node-sdk y el
+ * dashboard pregunten lo mismo:
+ *
+ *   - «Block these tool calls»: el dueño bloquea herramientas en el nodo
+ *     (`blockedTools`, por nombre). Vale para todo tipo de este registro
+ *     ({@link admiteBloqueo}).
+ *   - Sin herramienta no se corre: en modo toolkit un nodo sólo ejecuta la
+ *     herramienta que le nombran en `operation`. Un evento sin ella —una arista
+ *     vieja del lienzo— ya no corre la operación de «Single operation», que en
+ *     ese modo no se ve. Decisión de Ariel para los catorce toolkits
+ *     ({@link TIPOS_CON_TOOLKIT}), no sólo los de este registro.
+ *
+ * {@link motivoParaNoCorrer} junta las dos y la llama node-sdk al registrar
+ * cada handler, así que cubre todo camino que acabe en `handler.execute`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TOOLKITS_POR_TIPO = void 0;
+exports.MENSAJE_SIN_HERRAMIENTA = exports.TIPOS_CON_TOOLKIT = exports.TOOLKITS_POR_TIPO = void 0;
 exports.operacionDeToolkit = operacionDeToolkit;
 exports.esOperacionDestructiva = esOperacionDestructiva;
+exports.tieneModoToolkit = tieneModoToolkit;
+exports.admiteBloqueo = admiteBloqueo;
+exports.nombresDeHerramientas = nombresDeHerramientas;
+exports.bloqueadasDe = bloqueadasDe;
+exports.herramientaBloqueadaEn = herramientaBloqueadaEn;
+exports.mensajeDeHerramientaBloqueada = mensajeDeHerramientaBloqueada;
+exports.motivoParaNoCorrer = motivoParaNoCorrer;
 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");
@@ -35,6 +61,7 @@ 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");
+const google_contacts_toolkit_js_1 = require("./google-contacts-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,
@@ -47,6 +74,7 @@ exports.TOOLKITS_POR_TIPO = Object.freeze({
     docsAction: docs_toolkit_js_1.DOCS_TOOLKIT_SPECS,
     mongoAction: mongo_toolkit_js_1.MONGO_TOOLKIT_SPECS,
     postgresAction: postgres_toolkit_js_1.POSTGRES_TOOLKIT_SPECS,
+    googleContactsAction: google_contacts_toolkit_js_1.GOOGLE_CONTACTS_TOOLKIT_SPECS,
 });
 /**
  * La operación de un toolkit, buscada por su nombre interno (`updateRow`) O
@@ -77,3 +105,86 @@ function esOperacionDestructiva(nodeType, operacionONombre) {
     const op = operacionDeToolkit(nodeType, operacionONombre);
     return op ? op.destructive === true : null;
 }
+/* ── Quién tiene toolkit, el bloqueo por nodo y la puerta ───────────────── */
+/**
+ * Los tipos con modo AI toolkit de VARIAS herramientas: los de este registro
+ * más WhatsApp y Social, cuyas herramientas aún no viven aquí. Es la lista de
+ * quién se niega a correr sin herramienta pedida.
+ *
+ * RSS, Mailchimp o Shopify también tienen `aiEnabled`, pero exponen el nodo
+ * como UNA herramienta sin `operation`: no están aquí a propósito.
+ */
+exports.TIPOS_CON_TOOLKIT = Object.freeze([
+    ...Object.keys(exports.TOOLKITS_POR_TIPO),
+    'whatsappAction',
+    'socialMediaAction',
+]);
+function tieneModoToolkit(nodeType) {
+    return !!nodeType && exports.TIPOS_CON_TOOLKIT.includes(nodeType);
+}
+/**
+ * ¿Admite «Block these tool calls»? Los de este registro: para bloquear hay
+ * que saber traducir la operación que guarda el AI Node al nombre de la
+ * herramienta que guarda el nodo, y eso sólo se sabe aquí.
+ */
+function admiteBloqueo(nodeType) {
+    return !!nodeType && Object.prototype.hasOwnProperty.call(exports.TOOLKITS_POR_TIPO, nodeType);
+}
+/** Los nombres de herramienta de un toolkit: lo único que `blockedTools` acepta. */
+function nombresDeHerramientas(nodeType) {
+    if (!admiteBloqueo(nodeType))
+        return [];
+    return exports.TOOLKITS_POR_TIPO[nodeType].map((s) => s.toolName);
+}
+/** Los nombres bloqueados de un nodo, tolerando documentos sin el campo. */
+function bloqueadasDe(entidad) {
+    const lista = entidad?.blockedTools;
+    return Array.isArray(lista) ? lista.filter((x) => typeof x === 'string') : [];
+}
+/**
+ * ¿Está bloqueada en este nodo? Acepta la operación (`deleteOne`, lo que guarda
+ * el AI Node en `operationOverride`) o el nombre (`delete_document`, lo que
+ * recibe el servidor MCP).
+ */
+function herramientaBloqueadaEn(entidad, nodeType, operacionONombre) {
+    if (!operacionONombre)
+        return false;
+    const bloqueadas = bloqueadasDe(entidad);
+    if (bloqueadas.length === 0)
+        return false;
+    const op = operacionDeToolkit(nodeType, operacionONombre);
+    return bloqueadas.includes(op?.toolName ?? operacionONombre);
+}
+/** Lo que se contesta a una llamada sin herramienta. Lo lee una persona en el
+ *  historial —una arista vieja— o el modelo, así que dice qué hacer. */
+exports.MENSAJE_SIN_HERRAMIENTA = 'This node is an AI toolkit: it only runs the tool an AI Node or an MCP client names, and this call named none. If a connection in the flow leads here, remove it — in toolkit mode the node is not part of the pipeline.';
+function mensajeDeHerramientaBloqueada(toolName) {
+    return `The tool "${toolName}" is blocked on this node by its owner. Do not retry it; tell the user it is not allowed here.`;
+}
+/**
+ * Por qué una llamada NO debe correr en este nodo, o `null` si puede.
+ *
+ * Sólo mira nodos en modo toolkit (`aiEnabled` y un tipo de
+ * {@link TIPOS_CON_TOOLKIT}); cualquier otro nodo corre como siempre. En modo
+ * toolkit:
+ *   - sin `operation` → {@link MENSAJE_SIN_HERRAMIENTA};
+ *   - con una herramienta bloqueada en el nodo → su mensaje.
+ *
+ * Una operación que el registro no conoce NO se rechaza aquí: cada servicio
+ * sabe qué operaciones acepta (Mongo y Postgres las validan con más detalle),
+ * y rechazar lo desconocido aquí rompería operaciones legítimas que no son
+ * herramientas.
+ */
+function motivoParaNoCorrer(nodeType, entidad, payload) {
+    const e = entidad;
+    if (!e || e.aiEnabled !== true || !tieneModoToolkit(nodeType))
+        return null;
+    const pedida = payload?.operation;
+    if (typeof pedida !== 'string' || !pedida.trim())
+        return exports.MENSAJE_SIN_HERRAMIENTA;
+    if (herramientaBloqueadaEn(entidad, nodeType, pedida)) {
+        const op = operacionDeToolkit(nodeType, pedida);
+        return mensajeDeHerramientaBloqueada(op?.toolName ?? pedida);
+    }
+    return null;
+}

package/package.json

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