@hostwebhook/node-types 1.52.16 → 1.52.18

package/dist/docs-toolkit.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Google Docs AI Toolkit — las herramientas que un docsAction expone cuando
+ * `aiEnabled` está encendido.
+ *
+ * Se escribe **una sola vez**, aquí, y la importan la api
+ * (`mcp-servers/toolkit-specs.ts`) y el dashboard (`NodeAsToolPicker`,
+ * `DocsActionDetail`). Es el sexto toolkit que vive en el paquete —van Gmail,
+ * native email, Calendar, Drive, Telegram y Sheets—; los que siguen con copia a
+ * mano en los dos repos son WhatsApp, Discord, Slack y Contacts, y de ese
+ * reparto salió que Contacts anunciara 15 herramientas y expusiera una.
+ *
+ * La forma es la que ya consume `toolkitSpecToMcpTool` en la api, para poder
+ * usarse sin adaptador. Los textos van en inglés porque los lee el modelo y
+ * quien mire la lista de herramientas del servidor MCP.
+ */
+import type { DocsOperation } from './docs-operations';
+export interface DocsToolkitParameter {
+    name: string;
+    /** El esquema MCP sólo admite estos tres. */
+    type: 'string' | 'number' | 'boolean';
+    description: string;
+    required: boolean;
+}
+export interface DocsToolkitSpec {
+    operation: DocsOperation;
+    label: string;
+    toolName: string;
+    description: string;
+    parameters: DocsToolkitParameter[];
+    /** Escribe en el documento del usuario. Lo usa la confirmación previa del AI Node. */
+    destructive?: boolean;
+}
+export declare const DOCS_TOOLKIT_SPECS: DocsToolkitSpec[];
+/** Las herramientas por nombre, para despachar una llamada del modelo. */
+export declare const DOCS_TOOLKIT_BY_TOOL_NAME: Record<string, DocsToolkitSpec>;
+/**
+ * El parámetro que el nodo puede rellenar por defecto. Se exporta para que la
+ * api y el dashboard no vuelvan a escribir la lista a mano — `create_doc` no
+ * lo declara y por eso se queda fuera de la inyección sin necesidad de
+ * excepciones.
+ */
+export declare const DOCS_TOOLKIT_DEFAULTABLE: readonly ["documentId"];

package/dist/docs-toolkit.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * Google Docs AI Toolkit — las herramientas que un docsAction expone cuando
+ * `aiEnabled` está encendido.
+ *
+ * Se escribe **una sola vez**, aquí, y la importan la api
+ * (`mcp-servers/toolkit-specs.ts`) y el dashboard (`NodeAsToolPicker`,
+ * `DocsActionDetail`). Es el sexto toolkit que vive en el paquete —van Gmail,
+ * native email, Calendar, Drive, Telegram y Sheets—; los que siguen con copia a
+ * mano en los dos repos son WhatsApp, Discord, Slack y Contacts, y de ese
+ * reparto salió que Contacts anunciara 15 herramientas y expusiera una.
+ *
+ * La forma es la que ya consume `toolkitSpecToMcpTool` en la api, para poder
+ * usarse sin adaptador. Los textos van en inglés porque los lee el modelo y
+ * quien mire la lista de herramientas del servidor MCP.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DOCS_TOOLKIT_DEFAULTABLE = exports.DOCS_TOOLKIT_BY_TOOL_NAME = exports.DOCS_TOOLKIT_SPECS = void 0;
+const p = (name, description, required = true, type = 'string') => ({ name, type, description, required });
+/*
+ * El documento del nodo va como **defecto** y el modelo puede cambiarlo — la
+ * misma decisión y la misma maquinaria que la hoja de Sheets:
+ * `toolkitSpecToMcpTool(spec, nombre, { documentId })` lo saca de `required`
+ * **y le cuenta el valor al modelo** en la descripción. Las dos cosas o
+ * ninguna: mientras el esquema diga `required`, el LLM siempre lo rellena y el
+ * documento configurado no se usaría jamás.
+ *
+ * Por eso aquí se declara `required: true`: lo es para la API de Google, y es
+ * el defecto del nodo quien lo vuelve opcional, nodo por nodo.
+ *
+ * `create_doc` es el único que NO lo declara —todavía no hay documento al que
+ * apuntar— y su nombre de campo es `title`. Si se llamara `documentId`, la
+ * inyección de defectos se lo rellenaría con el documento del nodo y el
+ * documento nuevo nacería con el id del viejo por título.
+ */
+const documento = () => p('documentId', 'Id of the Google Docs document — the long chunk of its URL, between /d/ and /edit.');
+exports.DOCS_TOOLKIT_SPECS = [
+    {
+        operation: 'readDoc',
+        label: 'Read document',
+        toolName: 'read_doc',
+        description: 'Read the whole document as plain text. Use it before editing when you do not know what the document already says — replace_text and append_text act blindly otherwise.',
+        parameters: [documento()],
+    },
+    {
+        operation: 'createDoc',
+        label: 'Create document',
+        toolName: 'create_doc',
+        description: 'Create a new Google Docs document and return its id. The id it returns is what the other tools take as documentId.',
+        parameters: [
+            p('title', 'Name of the new document.'),
+            p('content', 'Initial body, as HTML. Basic tags work (<p>, <b>, <i>, <ul>, <li>, <h1>…). Plain text is fine too. Leave it out for an empty document.', false),
+        ],
+        destructive: true,
+    },
+    {
+        operation: 'appendText',
+        label: 'Append text',
+        toolName: 'append_text',
+        description: 'Add content at the END of the document. It never replaces what is already there, so it is the safe way to add a paragraph, a note or a log line.',
+        parameters: [
+            p('content', 'What to add, as HTML. Basic tags work (<p>, <b>, <i>, <ul>, <li>, <h1>…). Plain text is fine too.'),
+            documento(),
+        ],
+        destructive: true,
+    },
+    {
+        operation: 'replaceText',
+        label: 'Replace text',
+        toolName: 'replace_text',
+        description: 'Find every occurrence of a piece of text and swap it for another. It matches literally and it is case-sensitive; a search string that appears nowhere changes nothing and is not an error.',
+        parameters: [
+            p('searchText', 'Exact text to look for. Every occurrence is replaced, not just the first.'),
+            p('replaceWith', 'Text to put in its place. An empty string deletes the matches.'),
+            documento(),
+        ],
+        destructive: true,
+    },
+    {
+        operation: 'insertTable',
+        label: 'Insert table',
+        toolName: 'insert_table',
+        description: 'Insert an empty table at the end of the document. It creates the grid only — fill the cells afterwards with replace_text, or build the content as HTML and use append_text instead.',
+        parameters: [
+            p('rows', 'Number of rows, including the header row if you want one.', true, 'number'),
+            p('cols', 'Number of columns.', true, 'number'),
+            documento(),
+        ],
+        destructive: true,
+    },
+];
+/** Las herramientas por nombre, para despachar una llamada del modelo. */
+exports.DOCS_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(exports.DOCS_TOOLKIT_SPECS.map((s) => [s.toolName, s]));
+/**
+ * El parámetro que el nodo puede rellenar por defecto. Se exporta para que la
+ * api y el dashboard no vuelvan a escribir la lista a mano — `create_doc` no
+ * lo declara y por eso se queda fuera de la inyección sin necesidad de
+ * excepciones.
+ */
+exports.DOCS_TOOLKIT_DEFAULTABLE = ['documentId'];

package/dist/gmail-operations.d.ts

@@ -16,3 +16,175 @@ export declare const GMAIL_OPERATIONS: readonly ["send", "sendAndWaitForResponse
 export type GmailOperation = (typeof GMAIL_OPERATIONS)[number];
 /** Type guard — useful when validating untrusted input (DTOs, tool calls). */
 export declare function isGmailOperation(value: unknown): value is GmailOperation;
+/**
+ * Esquema de formulario, grupos del desplegable y toolkits de Gmail.
+ *
+ * El enum de arriba ya estaba aquí y ya lo importaban la api (DTO + entidad) y
+ * el dashboard. Lo que baja ahora es todo lo demás, que vivía escrito a mano en
+ * cuatro sitios:
+ *
+ *   - `OP_SCHEMA` de `OperationFieldsRenderer.tsx` — 17 ops, 53 campos
+ *   - `OPERATION_GROUPS` de `OperationSelector.tsx` — 16 ops con etiqueta,
+ *     descripción y grupo
+ *   - `GMAIL_OPERATION_SPECS` del dashboard y **la misma lista otra vez** en
+ *     `api/src/mcp-servers/toolkit-specs.ts` — 16 herramientas cada una
+ *   - `NATIVE_EMAIL_OPERATION_SPECS`, igual, por duplicado
+ *
+ * Las dos copias del toolkit estaban idénticas el día de la mudanza (0
+ * divergencias medidas), lo cual es suerte y no diseño: viven en repos
+ * distintos, así que **ningún test podía compararlas**. Por eso bajan.
+ *
+ * OJO CON EL NOMBRE. En el dashboard `GMAIL_OPERATION_SPECS` eran las specs del
+ * *toolkit*, al revés que en los otros diez nodos. Aquí se respeta la convención
+ * del paquete: `*_OPERATION_SPECS` es el **formulario** y `*_TOOLKIT_SPECS` son
+ * las **herramientas**.
+ */
+/** Encabezados del desplegable, en orden de aparición. */
+export declare const GMAIL_OPERATION_GROUPS: readonly ["Messages", "Drafts", "Labels", "Threads"];
+export type GmailOperationGroup = (typeof GMAIL_OPERATION_GROUPS)[number];
+/**
+ * Tipo de control del formulario. Todos tienen precedente en el paquete salvo
+ * `emails`, que es propio de este nodo (el `EmailChipsInput` con
+ * autocompletado), como el `docPicker` de Docs.
+ *
+ *   - `string`       — `TemplateInput` de una línea
+ *   - `htmlTemplate` — cuerpo con el interruptor Plain <-> Advanced (HTML).
+ *                      Igual que en Docs.
+ *   - `emails`       — `EmailChipsInput`; se guarda como **array**
+ *   - `csvList`      — se guarda como array y se edita como texto separado por
+ *                      comas. El mismo de Contacts; perder el array al guardar
+ *                      rompe el nodo en ejecución
+ *   - `select`       — `<select>`; las etiquetas no son los valores, así que
+ *                      `options` es obligatorio
+ *   - `number`, `boolean` — lo que parecen
+ *
+ * No hay `min`/`max`: hoy ningún campo numérico de este nodo los usa, y
+ * añadirlos sin que nadie los lea es el `color` que nadie leía en Postgres.
+ */
+export type GmailParamType = 'string' | 'htmlTemplate' | 'emails' | 'csvList' | 'select' | 'number' | 'boolean';
+export interface GmailParamSpec {
+    /** Clave dentro de `operationConfig`. */
+    name: string;
+    /** Etiqueta encima del control. */
+    label: string;
+    type: GmailParamType;
+    /** Lo exige la operación. Metadato: el formulario no bloquea el guardado. */
+    required?: boolean;
+    /** Texto de ayuda debajo del control (el `help` de antes). */
+    description?: string;
+    placeholder?: string;
+    /** Sólo `htmlTemplate`: lenguaje del editor cuando está en modo Advanced. */
+    language?: string;
+    /** Sólo `select`. */
+    options?: ReadonlyArray<{
+        value: string;
+        label: string;
+    }>;
+}
+export interface GmailOperationSpec {
+    /** Etiqueta del desplegable y de la página. */
+    label: string;
+    /**
+     * Etiqueta corta para la píldora del lienzo, que va en `uppercase` sobre una
+     * tarjeta de 260px. Sin esto la tarjeta pintaba el `operation` crudo y decía
+     * `SENDANDWAITFORRESPONSE`; es el mismo defecto que tenía Mongo.
+     */
+    labelShort: string;
+    /** Línea debajo de la etiqueta en el desplegable. */
+    description?: string;
+    /**
+     * Grupo del desplegable. **Ausente = no se ofrece en modo de una sola op**,
+     * que hoy es el caso de `sendDraft` y sólo de él.
+     */
+    group?: GmailOperationGroup;
+    /** Campos, en orden de pantalla. */
+    params: GmailParamSpec[];
+}
+/**
+ * El orden de las claves dentro de cada grupo **es** el orden del desplegable,
+ * igual que en Contacts: mover una clave mueve la pantalla.
+ *
+ * `send` ya no lleva `cc` ni `bcc`. Estaban declaradas y no se pintaban nunca —el
+ * renderizador se invocaba tras `operation !== "send"`— y la ruta determinista no
+ * las sabe mandar: `emailSender.send` recibe to/subject/html y nada más. Darles
+ * soporte es una función nueva, no una mudanza.
+ */
+export declare const GMAIL_OPERATION_SPECS: Record<GmailOperation, GmailOperationSpec>;
+export declare const GMAIL_DROPDOWN_OPERATIONS: readonly GmailOperation[];
+export declare const GMAIL_TOOLKIT_OPERATIONS: readonly GmailOperation[];
+/**
+ * Las herramientas que un emailAction con Gmail expone cuando `aiEnabled` está
+ * encendido. La forma es la que ya consume `toolkitSpecToMcpTool` en la api,
+ * para que pueda usarse sin adaptador. Los textos van en inglés porque los lee
+ * el modelo y quien mire la lista del servidor MCP.
+ *
+ * Ninguna lleva `destructive`, ni `delete_gmail_message` ni `trash_thread`.
+ * Lo merecerían —el toolkit de Drive marca sus borrados— pero hoy ninguna de las
+ * dos copias lo tenía y esto es una mudanza, no un cambio de comportamiento.
+ */
+export interface GmailToolkitParameter {
+    name: string;
+    type: 'string' | 'number' | 'boolean';
+    description: string;
+    required: boolean;
+}
+export interface GmailToolkitSpec {
+    operation: GmailOperation;
+    label: string;
+    /**
+     * Nombre con el que lo llama el LLM. Lleva `_gmail_` o `_email` para no
+     * chocar con el `send_telegram_message` ni el `create_event` de Calendar
+     * cuando un mismo AI Node tiene varios toolkits encendidos.
+     */
+    toolName: string;
+    description: string;
+    parameters: GmailToolkitParameter[];
+    destructive?: boolean;
+}
+export declare const GMAIL_TOOLKIT_SPECS: GmailToolkitSpec[];
+/**
+ * La op que espera, **fuera** del toolkit y aparte a propósito. Sigue haciendo
+ * falta para dos cosas que no son el toolkit: reconocer la operación de una
+ * herramienta ya guardada (si desapareciera, un `send_email_and_wait` creado antes
+ * se quedaría sin etiqueta) y el modo de una sola op elegido como herramienta
+ * suelta, donde el pipeline sí espera el clic.
+ */
+export declare const GMAIL_SEND_AND_WAIT_TOOL_SPEC: GmailToolkitSpec;
+/** Todo lo que el nodo sabe ejecutar, se ofrezca o no como herramienta. */
+export declare const GMAIL_ALL_TOOLKIT_SPECS: GmailToolkitSpec[];
+/** El toolkit del proveedor nativo (Resend): una sola herramienta. */
+export declare const NATIVE_EMAIL_TOOLKIT_SPECS: GmailToolkitSpec[];
+export declare const GMAIL_TOOLKIT_BY_TOOL_NAME: Record<string, GmailToolkitSpec>;
+export declare const NATIVE_EMAIL_TOOLKIT_BY_TOOL_NAME: Record<string, GmailToolkitSpec>;
+/**
+ * De dónde salen `to` / `subject` / `body` de un `send`.
+ *
+ * Los tres se guardaban planos en la raíz de la entidad mientras las otras 16
+ * operaciones usaban `operationConfig`. Desde la unificación **se escribe
+ * siempre en `operationConfig`**, y esto resuelve la lectura para que ninguna
+ * fila anterior se rompa: primero `operationConfig`, y si no está, el campo
+ * plano.
+ *
+ * Vive en el paquete a propósito. Si cada repo se escribiera su propio helper
+ * volveríamos a tener dos copias de la misma regla, que es justo lo que esta
+ * mudanza viene a quitar. Lo usan los 8 sitios que leían los campos planos: el
+ * envío, el send-and-wait, las entregas, la página, la tarjeta del lienzo, el
+ * resumen del panel y la validación.
+ *
+ * `??` y no `||`: si el usuario **vacía** los destinatarios, `operationConfig.to`
+ * es `[]` y tiene que ganar. Con `||` resucitaría el valor viejo del campo plano.
+ */
+export interface GmailSendFieldSource {
+    to?: unknown;
+    subject?: unknown;
+    body?: unknown;
+    operationConfig?: Record<string, unknown> | null;
+}
+export interface GmailSendFields {
+    to: string[];
+    subject: string;
+    body: string;
+}
+/** Los tres campos que un día vivieron en la raíz. */
+export declare const GMAIL_SEND_LEGACY_FIELDS: readonly ["to", "subject", "body"];
+export declare function resolveGmailSendFields(entity: GmailSendFieldSource | null | undefined): GmailSendFields;

package/dist/gmail-operations.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GMAIL_OPERATIONS = void 0;
+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_ALL_TOOLKIT_SPECS = exports.GMAIL_SEND_AND_WAIT_TOOL_SPEC = exports.GMAIL_TOOLKIT_SPECS = exports.GMAIL_TOOLKIT_OPERATIONS = exports.GMAIL_DROPDOWN_OPERATIONS = exports.GMAIL_OPERATION_SPECS = exports.GMAIL_OPERATION_GROUPS = exports.GMAIL_OPERATIONS = void 0;
 exports.isGmailOperation = isGmailOperation;
+exports.resolveGmailSendFields = resolveGmailSendFields;
 /**
  * Gmail operation enum — single source of truth across the API, Dashboard,
  * and Message Broker. Used by:
@@ -45,3 +46,520 @@ exports.GMAIL_OPERATIONS = [
 function isGmailOperation(value) {
     return typeof value === 'string' && exports.GMAIL_OPERATIONS.includes(value);
 }
+/**
+ * Esquema de formulario, grupos del desplegable y toolkits de Gmail.
+ *
+ * El enum de arriba ya estaba aquí y ya lo importaban la api (DTO + entidad) y
+ * el dashboard. Lo que baja ahora es todo lo demás, que vivía escrito a mano en
+ * cuatro sitios:
+ *
+ *   - `OP_SCHEMA` de `OperationFieldsRenderer.tsx` — 17 ops, 53 campos
+ *   - `OPERATION_GROUPS` de `OperationSelector.tsx` — 16 ops con etiqueta,
+ *     descripción y grupo
+ *   - `GMAIL_OPERATION_SPECS` del dashboard y **la misma lista otra vez** en
+ *     `api/src/mcp-servers/toolkit-specs.ts` — 16 herramientas cada una
+ *   - `NATIVE_EMAIL_OPERATION_SPECS`, igual, por duplicado
+ *
+ * Las dos copias del toolkit estaban idénticas el día de la mudanza (0
+ * divergencias medidas), lo cual es suerte y no diseño: viven en repos
+ * distintos, así que **ningún test podía compararlas**. Por eso bajan.
+ *
+ * OJO CON EL NOMBRE. En el dashboard `GMAIL_OPERATION_SPECS` eran las specs del
+ * *toolkit*, al revés que en los otros diez nodos. Aquí se respeta la convención
+ * del paquete: `*_OPERATION_SPECS` es el **formulario** y `*_TOOLKIT_SPECS` son
+ * las **herramientas**.
+ */
+/** Encabezados del desplegable, en orden de aparición. */
+exports.GMAIL_OPERATION_GROUPS = ['Messages', 'Drafts', 'Labels', 'Threads'];
+/**
+ * El orden de las claves dentro de cada grupo **es** el orden del desplegable,
+ * igual que en Contacts: mover una clave mueve la pantalla.
+ *
+ * `send` ya no lleva `cc` ni `bcc`. Estaban declaradas y no se pintaban nunca —el
+ * renderizador se invocaba tras `operation !== "send"`— y la ruta determinista no
+ * las sabe mandar: `emailSender.send` recibe to/subject/html y nada más. Darles
+ * soporte es una función nueva, no una mudanza.
+ */
+exports.GMAIL_OPERATION_SPECS = {
+    send: {
+        label: 'Send message',
+        labelShort: 'SEND',
+        description: 'Send a new email',
+        group: 'Messages',
+        params: [
+            { name: 'to', label: 'To', type: 'emails', required: true, placeholder: '{{payload.email}}' },
+            { name: 'subject', label: 'Subject', type: 'string', required: true, placeholder: 'Order #{{payload.id}}' },
+            { name: 'body', label: 'Body (HTML)', type: 'htmlTemplate', required: true, placeholder: '<p>Hi {{payload.name}}...</p>', language: 'html' },
+        ],
+    },
+    sendAndWaitForResponse: {
+        label: 'Send and wait for response',
+        labelShort: 'SEND & WAIT',
+        description: 'Send with Approve / Disapprove buttons; pause workflow until clicked',
+        group: 'Messages',
+        params: [
+            { name: 'to', label: 'To', type: 'emails', required: true, placeholder: '{{payload.email}}', description: 'Recipient(s) who will see the Approve / Disapprove buttons.' },
+            { name: 'subject', label: 'Subject', type: 'string', required: true, placeholder: 'Approve order #{{payload.id}}?' },
+            { name: 'body', label: 'Body (HTML)', type: 'htmlTemplate', required: true, placeholder: '<p>Please review and approve...</p>', language: 'html', description: 'Approve / Disapprove buttons are appended automatically below your content.' },
+            { name: 'approveLabel', label: 'Approve button label', type: 'string', placeholder: 'Approve', description: 'Default: Approve' },
+            { name: 'includeDisapprove', label: 'Include Disapprove button', type: 'boolean', description: 'Off = approve-only confirmation. Default: on.' },
+            { name: 'disapproveLabel', label: 'Disapprove button label', type: 'string', placeholder: 'Disapprove', description: 'Only used when Disapprove button is enabled.' },
+            { name: 'requireDisapproveComment', label: 'Require comment on disapprove', type: 'boolean', description: 'Off = 1-click decline. On = recipient sees a feedback form before submitting; the comment lands in payload._waitResponse.comment for downstream AI/Conditional nodes to read.' },
+            { name: 'disapproveCommentLabel', label: 'Comment form label', type: 'string', placeholder: 'Why are you disapproving?', description: "Heading shown above the textarea. Only used when 'Require comment' is on." },
+            { name: 'disapproveCommentPlaceholder', label: 'Comment placeholder', type: 'string', placeholder: 'Tell the sender why — this helps them improve the next attempt.', description: "Hint shown inside the empty textarea. Only used when 'Require comment' is on." },
+            { name: 'timeoutMinutes', label: 'Timeout (minutes)', type: 'number', placeholder: '1440', description: 'Auto-resolve as approved=false after this many minutes. Default 1440 (24h).' },
+        ],
+    },
+    createDraft: {
+        label: 'Create draft',
+        labelShort: 'DRAFT',
+        description: 'Save a draft without sending',
+        group: 'Drafts',
+        params: [
+            { name: 'to', label: 'To', type: 'emails', required: true, placeholder: '{{payload.email}}', description: 'Recipients the draft will be addressed to' },
+            { name: 'subject', label: 'Subject', type: 'string', placeholder: 'Draft: {{payload.topic}}' },
+            { name: 'body', label: 'Body (HTML)', type: 'htmlTemplate', language: 'html' },
+            { name: 'cc', label: 'CC', type: 'emails' },
+            { name: 'bcc', label: 'BCC', type: 'emails' },
+            { name: 'threadId', label: 'Thread ID', type: 'string', description: 'Optional — attach draft to an existing thread' },
+            { name: 'inReplyTo', label: 'In-Reply-To', type: 'string', description: 'Optional Message-ID header' },
+            { name: 'references', label: 'References', type: 'string', description: 'Optional References chain' },
+        ],
+    },
+    sendDraft: {
+        label: 'Send draft',
+        labelShort: 'SEND DRAFT',
+        description: 'Send a draft that createDraft already saved, in one shot',
+        params: [
+            { name: 'draftId', label: 'Draft ID', type: 'string', required: true, placeholder: '{{payload.draftId}}', description: 'Id returned by createDraft. The draft moves from Drafts/ to Sent/ in one shot — no orphans.' },
+        ],
+    },
+    replyToThread: {
+        label: 'Reply to thread',
+        labelShort: 'REPLY',
+        description: 'Reply preserving thread headers',
+        group: 'Messages',
+        params: [
+            { name: 'threadId', label: 'Thread ID', type: 'string', required: true, placeholder: '{{payload.threadId}}' },
+            { name: 'body', label: 'Body (HTML)', type: 'htmlTemplate', required: true, language: 'html' },
+            { name: 'subject', label: 'Subject', type: 'string', description: 'Optional — defaults to "Re: <original>"' },
+            { name: 'to', label: 'To', type: 'emails', description: 'Optional — defaults to last sender in thread' },
+            { name: 'cc', label: 'CC', type: 'emails' },
+            { name: 'bcc', label: 'BCC', type: 'emails' },
+        ],
+    },
+    getMessage: {
+        label: 'Get message',
+        labelShort: 'GET',
+        description: 'Fetch a single message by id',
+        group: 'Messages',
+        params: [
+            { name: 'messageId', label: 'Message ID', type: 'string', required: true, placeholder: '{{payload.messageId}}' },
+            { name: 'format', label: 'Format', type: 'select', options: [{ value: 'full', label: 'full' }, { value: 'metadata', label: 'metadata' }, { value: 'minimal', label: 'minimal' }] },
+        ],
+    },
+    listMessages: {
+        label: 'List messages',
+        labelShort: 'LIST',
+        description: 'Search inbox (Gmail query syntax)',
+        group: 'Messages',
+        params: [
+            { name: 'query', label: 'Query', type: 'string', placeholder: 'from:alice@example.com is:unread', description: 'Gmail search query — supports operators like from:, is:, has:, newer_than:' },
+            { name: 'labelIds', label: 'Label IDs', type: 'csvList', placeholder: 'INBOX,UNREAD', description: 'Comma-separated label IDs (use Gmail listLabels op to discover)' },
+            { name: 'maxResults', label: 'Max results', type: 'number', placeholder: '25' },
+            { name: 'includeSpamTrash', label: 'Include spam + trash', type: 'boolean' },
+            { name: 'expand', label: 'Expand each result (≤20)', type: 'boolean', description: 'Fetch headers + snippet per message. Off = id+threadId stubs only.' },
+            { name: 'expandFormat', label: 'Expand format', type: 'select', options: [{ value: 'metadata', label: 'Metadata (headers + snippet)' }, { value: 'full', label: 'Full body (expensive)' }], description: 'metadata = ~150-char snippet (default, cheap). full = entire body (expensive on tokens).' },
+        ],
+    },
+    deleteMessage: {
+        label: 'Delete message',
+        labelShort: 'DELETE',
+        description: 'Trash (default) or hard delete',
+        group: 'Messages',
+        params: [
+            { name: 'messageId', label: 'Message ID', type: 'string', required: true },
+            { name: 'permanent', label: 'Permanent delete (otherwise moves to trash)', type: 'boolean' },
+        ],
+    },
+    markRead: {
+        label: 'Mark as read',
+        labelShort: 'MARK READ',
+        description: 'Remove UNREAD label',
+        group: 'Messages',
+        params: [
+            { name: 'messageId', label: 'Message ID', type: 'string', required: true },
+        ],
+    },
+    markUnread: {
+        label: 'Mark as unread',
+        labelShort: 'MARK UNREAD',
+        description: 'Add UNREAD label',
+        group: 'Messages',
+        params: [
+            { name: 'messageId', label: 'Message ID', type: 'string', required: true },
+        ],
+    },
+    addLabel: {
+        label: 'Add label',
+        labelShort: 'ADD LABEL',
+        description: 'Attach label IDs to a message',
+        group: 'Messages',
+        params: [
+            { name: 'messageId', label: 'Message ID', type: 'string', required: true },
+            { name: 'labelIds', label: 'Label IDs to add', type: 'csvList', required: true, placeholder: 'Label_12345', description: 'Comma-separated' },
+        ],
+    },
+    removeLabel: {
+        label: 'Remove label',
+        labelShort: 'REMOVE LABEL',
+        description: 'Detach label IDs from a message',
+        group: 'Messages',
+        params: [
+            { name: 'messageId', label: 'Message ID', type: 'string', required: true },
+            { name: 'labelIds', label: 'Label IDs to remove', type: 'csvList', required: true, placeholder: 'Label_12345' },
+        ],
+    },
+    listLabels: {
+        label: 'List labels',
+        labelShort: 'LABELS',
+        description: 'All user + system labels',
+        group: 'Labels',
+        params: [],
+    },
+    createLabel: {
+        label: 'Create label',
+        labelShort: 'NEW LABEL',
+        description: 'New user label (supports / for nesting)',
+        group: 'Labels',
+        params: [
+            { name: 'name', label: 'Label name', type: 'string', required: true, placeholder: 'Clients/Active', description: 'Use / for nested labels' },
+            { name: 'messageListVisibility', label: 'Message list visibility', type: 'select', options: [{ value: 'show', label: 'show' }, { value: 'hide', label: 'hide' }] },
+            { name: 'labelListVisibility', label: 'Label list visibility', type: 'select', options: [{ value: 'labelShow', label: 'labelShow' }, { value: 'labelShowIfUnread', label: 'labelShowIfUnread' }, { value: 'labelHide', label: 'labelHide' }] },
+        ],
+    },
+    getThread: {
+        label: 'Get thread',
+        labelShort: 'THREAD',
+        description: 'Fetch an entire conversation',
+        group: 'Threads',
+        params: [
+            { name: 'threadId', label: 'Thread ID', type: 'string', required: true },
+            { name: 'format', label: 'Format', type: 'select', options: [{ value: 'full', label: 'full' }, { value: 'metadata', label: 'metadata' }, { value: 'minimal', label: 'minimal' }] },
+        ],
+    },
+    trashThread: {
+        label: 'Trash thread',
+        labelShort: 'TRASH',
+        description: 'Move all thread messages to trash',
+        group: 'Threads',
+        params: [
+            { name: 'threadId', label: 'Thread ID', type: 'string', required: true },
+        ],
+    },
+    untrashThread: {
+        label: 'Untrash thread',
+        labelShort: 'UNTRASH',
+        description: 'Restore a thread from trash',
+        group: 'Threads',
+        params: [
+            { name: 'threadId', label: 'Thread ID', type: 'string', required: true },
+        ],
+    },
+};
+/*
+ * Los dos subconjuntos de las 17, **declarados**. Antes había que deducirlos de
+ * qué lista se dejaba a quién fuera, y las dos ausencias son decisiones tomadas:
+ *
+ *   - `sendDraft` no se ofrece en el desplegable porque sólo tiene sentido
+ *     detrás de un `createDraft` de la misma conversación. Sí es herramienta.
+ *   - `sendAndWaitForResponse` no es herramienta porque por esa vía no espera:
+ *     el modelo recibe algo inmediato y acaba diciendo que ya se aprobó. Sí se
+ *     ofrece en el desplegable, con un Conditional detrás leyendo
+ *     `_waitResponse.approved`.
+ *
+ * Que cada una siga teniendo 16 lo fija un test. No las "arregles".
+ */
+exports.GMAIL_DROPDOWN_OPERATIONS = exports.GMAIL_OPERATIONS.filter((op) => exports.GMAIL_OPERATION_SPECS[op].group !== undefined);
+exports.GMAIL_TOOLKIT_OPERATIONS = exports.GMAIL_OPERATIONS.filter((op) => op !== 'sendAndWaitForResponse');
+const p = (name, description, required = true, type = 'string') => ({ name, type, description, required });
+exports.GMAIL_TOOLKIT_SPECS = [
+    {
+        operation: 'send',
+        label: 'Send message',
+        toolName: 'send_email',
+        description: 'Send a fresh Gmail message that you compose from scratch right now. USAGE RULES: (1) ' +
+            'Only use this when the user asks for a brand-new email and there is NO recent draft to ' +
+            'confirm. (2) If you previously called createDraft in this conversation and the user just ' +
+            'confirmed it, do NOT call send — call sendDraft with that draftId instead. Calling send ' +
+            're-composes the message from your memory and risks sending stale content from an earlier ' +
+            "conversation. (3) Compose the body fresh from the user's CURRENT request. Never reuse " +
+            'content recalled from memory unless the user explicitly references it. (4) Not for ' +
+            'replies inside an existing thread — use replyToThread for that.',
+        parameters: [
+            p('to', 'Recipient email address(es). Single string or comma-separated list.'),
+            p('subject', 'Email subject line.'),
+            p('body', 'HTML-formatted email body.'),
+            p('cc', 'Optional CC recipients.', false),
+            p('bcc', 'Optional BCC recipients.', false),
+        ],
+    },
+    {
+        operation: 'createDraft',
+        label: 'Create draft',
+        toolName: 'draft_email',
+        description: "Save a draft in the user's Gmail drafts folder. Does NOT send. Use when asked to draft, " +
+            'prepare, or compose without sending. USAGE RULES: (1) Compose the body fresh from the ' +
+            "user's CURRENT request. Never reuse content recalled from memory unless the user " +
+            "explicitly says 'use the same content as before' or similar. (2) Always return the " +
+            'draftId in your response so the user (and you, on the next turn) can reference it. (3) ' +
+            'After creating, ask the user to confirm. If they confirm, call sendDraft with the ' +
+            'returned draftId — never re-call this tool or send.',
+        parameters: [
+            p('to', 'Recipient email address(es).'),
+            p('subject', 'Email subject line.', false),
+            p('body', 'HTML-formatted email body.', false),
+            p('cc', 'Optional CC recipients.', false),
+            p('bcc', 'Optional BCC recipients.', false),
+            p('threadId', 'Optional — attach draft to an existing thread.', false),
+            p('inReplyTo', 'Optional Message-ID header to reply to.', false),
+            p('references', 'Optional References header chain.', false),
+        ],
+    },
+    {
+        operation: 'sendDraft',
+        label: 'Send draft',
+        toolName: 'send_draft',
+        description: 'Send an existing draft (it gets removed from Drafts and a copy appears in Sent). USAGE ' +
+            'RULES: (1) Only call this with a draftId returned by a createDraft tool call earlier in ' +
+            'THE CURRENT conversation. (2) Never use a draftId you remember from past conversations ' +
+            'or memory recall — those drafts may have been already sent, deleted, or belonged to a ' +
+            'different topic; sending the wrong one will silently deliver the wrong message to the ' +
+            "user's contacts. (3) If the user confirms a draft, immediately call sendDraft with the " +
+            "draftId from your latest createDraft response in this conversation. (4) If you're not " +
+            'sure which draftId is current, call createDraft again with the latest content the user ' +
+            'agreed to instead of guessing.',
+        parameters: [
+            p('draftId', 'Draft id returned by the MOST RECENT createDraft call in this conversation. Do NOT pull this id from memory or a past conversation — it will send the wrong content.'),
+        ],
+    },
+    {
+        operation: 'replyToThread',
+        label: 'Reply to thread',
+        toolName: 'reply_email',
+        description: 'Reply to an existing Gmail thread preserving thread integrity (In-Reply-To / References ' +
+            'chain). Recipient defaults to the last sender if not provided. USAGE RULES: (1) Compose ' +
+            "the reply body fresh from the user's CURRENT request. Never reuse content recalled from " +
+            'memory of past replies unless the user explicitly references it. (2) Use the threadId ' +
+            'from a getThread / listMessages tool call EARLIER IN THIS CONVERSATION, not from memory ' +
+            'of past conversations.',
+        parameters: [
+            p('threadId', 'Thread to reply to.'),
+            p('body', 'HTML-formatted reply body.'),
+            p('to', 'Optional — defaults to last sender in thread.', false),
+            p('subject', 'Optional — defaults to "Re: <original>".', false),
+            p('cc', 'Optional CC recipients.', false),
+            p('bcc', 'Optional BCC recipients.', false),
+        ],
+    },
+    {
+        operation: 'getMessage',
+        label: 'Get message',
+        toolName: 'get_email',
+        description: 'Fetch a single Gmail message by id. Returns headers, snippet, and decoded plain+HTML ' +
+            'body.',
+        parameters: [
+            p('messageId', 'Gmail message id.'),
+            p('format', 'full | metadata | minimal.', false),
+        ],
+    },
+    {
+        operation: 'listMessages',
+        label: 'List messages',
+        toolName: 'list_emails',
+        description: 'Search the inbox. Supports Gmail search syntax (e.g. "from:boss is:unread"). Returns ' +
+            'headers + a ~150-char snippet per message by default — enough to identify which messages ' +
+            'match without flooding context with full bodies. If the user needs the full content of a ' +
+            'SPECIFIC message, call getMessage with that id afterwards (cheaper than expanding all ' +
+            'results to full).',
+        parameters: [
+            p('query', 'Gmail search query. Examples: "from:alice@x.com", "is:unread", "has:attachment newer_than:7d".', false),
+            p('labelIds', 'Filter by label id(s), comma-separated.', false),
+            p('maxResults', 'Default 25, max 500.', false, 'number'),
+            p('includeSpamTrash', 'Include spam + trash (default false).', false, 'boolean'),
+            p('expand', 'Fetch headers+snippet for each result (default true). Set false to return only id+threadId stubs.', false, 'boolean'),
+            p('expandFormat', "When expanding: 'metadata' (default — headers + snippet) or 'full' (entire body, expensive on context).", false),
+        ],
+    },
+    {
+        operation: 'deleteMessage',
+        label: 'Delete message',
+        toolName: 'delete_email',
+        description: 'Move a message to trash (default) or permanently delete it. Trash is safer — users can ' +
+            'restore.',
+        parameters: [
+            p('messageId', 'Gmail message id.'),
+            p('permanent', 'true = permanent delete, false/default = trash.', false, 'boolean'),
+        ],
+    },
+    {
+        operation: 'markRead',
+        label: 'Mark as read',
+        toolName: 'mark_email_read',
+        description: 'Mark a message as read (removes the UNREAD label).',
+        parameters: [
+            p('messageId', 'Gmail message id.'),
+        ],
+    },
+    {
+        operation: 'markUnread',
+        label: 'Mark as unread',
+        toolName: 'mark_email_unread',
+        description: 'Mark a message as unread (adds the UNREAD label).',
+        parameters: [
+            p('messageId', 'Gmail message id.'),
+        ],
+    },
+    {
+        operation: 'addLabel',
+        label: 'Add label to message',
+        toolName: 'add_email_label',
+        description: 'Add one or more labels to a message. Use label IDs from listLabels (e.g. "Label_123") ' +
+            'not label names.',
+        parameters: [
+            p('messageId', 'Gmail message id.'),
+            p('labelIds', 'Label id(s) to add, comma-separated.'),
+        ],
+    },
+    {
+        operation: 'removeLabel',
+        label: 'Remove label from message',
+        toolName: 'remove_email_label',
+        description: 'Remove one or more labels from a message.',
+        parameters: [
+            p('messageId', 'Gmail message id.'),
+            p('labelIds', 'Label id(s) to remove, comma-separated.'),
+        ],
+    },
+    {
+        operation: 'listLabels',
+        label: 'List labels',
+        toolName: 'list_email_labels',
+        description: "List all labels in the user's Gmail account (system + user labels). Use to discover " +
+            'label ids before calling addLabel / removeLabel.',
+        parameters: [],
+    },
+    {
+        operation: 'createLabel',
+        label: 'Create label',
+        toolName: 'create_email_label',
+        description: "Create a new user label in the user's Gmail account.",
+        parameters: [
+            p('name', 'Label name (can use / for nested labels, e.g. "Clients/Active").'),
+            p('messageListVisibility', 'show | hide.', false),
+            p('labelListVisibility', 'labelShow | labelShowIfUnread | labelHide.', false),
+        ],
+    },
+    {
+        operation: 'getThread',
+        label: 'Get thread',
+        toolName: 'get_email_thread',
+        description: 'Fetch an entire Gmail thread with all its messages. Use for summarizing or deeply ' +
+            'analyzing a conversation.',
+        parameters: [
+            p('threadId', 'Gmail thread id.'),
+            p('format', 'full | metadata | minimal.', false),
+        ],
+    },
+    {
+        operation: 'trashThread',
+        label: 'Trash thread',
+        toolName: 'trash_email_thread',
+        description: 'Move an entire thread to trash.',
+        parameters: [
+            p('threadId', 'Gmail thread id.'),
+        ],
+    },
+    {
+        operation: 'untrashThread',
+        label: 'Untrash thread',
+        toolName: 'untrash_email_thread',
+        description: 'Restore a thread from trash.',
+        parameters: [
+            p('threadId', 'Gmail thread id.'),
+        ],
+    },
+];
+/**
+ * La op que espera, **fuera** del toolkit y aparte a propósito. Sigue haciendo
+ * falta para dos cosas que no son el toolkit: reconocer la operación de una
+ * herramienta ya guardada (si desapareciera, un `send_email_and_wait` creado antes
+ * se quedaría sin etiqueta) y el modo de una sola op elegido como herramienta
+ * suelta, donde el pipeline sí espera el clic.
+ */
+exports.GMAIL_SEND_AND_WAIT_TOOL_SPEC = {
+    operation: 'sendAndWaitForResponse',
+    label: 'Send and wait for response',
+    toolName: 'send_email_and_wait',
+    description: 'Send an email with Approve / Disapprove buttons and PAUSE the pipeline until the ' +
+        'recipient clicks one. Resumes downstream with `payload._waitResponse = { approved, ' +
+        'decidedAt, ipAddress, comment }` so a Conditional Node can branch on the decision. Times ' +
+        'out after timeoutMinutes (default 24h) if nobody clicks; the timeout cron auto-resolves ' +
+        'with approved=false. Use for human-in-the-loop approvals (e.g. confirm before sending ' +
+        'money, deploying, or notifying customers).',
+    parameters: [
+        p('to', 'Recipient email address(es). Single string or comma-separated list.'),
+        p('subject', 'Email subject line.'),
+        p('body', 'HTML-formatted email body. The Approve / Disapprove buttons are appended automatically below your content.'),
+        p('approveLabel', "Optional. Approve button label. Default: 'Approve'.", false),
+        p('disapproveLabel', "Optional. Disapprove button label. Default: 'Disapprove'.", false),
+        p('includeDisapprove', 'Optional. Include the Disapprove button. Default: true. Set to false for approve-only confirmations.', false),
+        p('timeoutMinutes', 'Optional. Minutes to wait before auto-resolving with approved=false. Default 1440 (24h).', false),
+    ],
+};
+/** Todo lo que el nodo sabe ejecutar, se ofrezca o no como herramienta. */
+exports.GMAIL_ALL_TOOLKIT_SPECS = [
+    ...exports.GMAIL_TOOLKIT_SPECS,
+    exports.GMAIL_SEND_AND_WAIT_TOOL_SPEC,
+];
+/** El toolkit del proveedor nativo (Resend): una sola herramienta. */
+exports.NATIVE_EMAIL_TOOLKIT_SPECS = [
+    {
+        operation: 'send',
+        label: 'Send email',
+        toolName: 'send_email',
+        description: 'Send a transactional email via Resend. Use for confirmations, notifications, receipts, ' +
+            'password resets. One email per call. The sender domain is fixed by the node; you cannot ' +
+            'change it per call. Body accepts HTML.',
+        parameters: [
+            p('to', 'Recipient email address(es). Single string or comma-separated list.'),
+            p('subject', 'Email subject line.'),
+            p('body', 'HTML-formatted email body.'),
+            p('cc', 'Optional CC recipients. Single string or comma-separated.', false),
+            p('bcc', 'Optional BCC recipients. Single string or comma-separated.', false),
+            p('reply_to', 'Optional Reply-To address.', false),
+            p('from_name', 'Optional display name for this specific email (overrides the node default).', false),
+            p('attachment_file_ids', 'Optional. Comma-separated list of file IDs from `_file.id` refs in the upstream payload (e.g., a File Transform output or a webhook multipart upload). Max 5 files, 30MB total. Do NOT invent IDs — only use values actually present in the current payload.', false),
+        ],
+    },
+];
+exports.GMAIL_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(exports.GMAIL_ALL_TOOLKIT_SPECS.map((s) => [s.toolName, s]));
+exports.NATIVE_EMAIL_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(exports.NATIVE_EMAIL_TOOLKIT_SPECS.map((s) => [s.toolName, s]));
+/** Los tres campos que un día vivieron en la raíz. */
+exports.GMAIL_SEND_LEGACY_FIELDS = ['to', 'subject', 'body'];
+function resolveGmailSendFields(entity) {
+    const cfg = (entity?.operationConfig ?? {});
+    const crudoTo = cfg.to ?? entity?.to;
+    const to = Array.isArray(crudoTo)
+        ? crudoTo.filter((x) => typeof x === 'string')
+        : typeof crudoTo === 'string' && crudoTo !== ''
+            ? [crudoTo]
+            : [];
+    const subject = cfg.subject ?? entity?.subject;
+    const body = cfg.body ?? entity?.body;
+    return {
+        to,
+        subject: typeof subject === 'string' ? subject : '',
+        body: typeof body === 'string' ? body : '',
+    };
+}

package/dist/index.d.ts

@@ -5,8 +5,8 @@ export { NODE_UI, PREFIX_TO_TYPE, resolveNodeId, } from './ui';
 export { NODE_DISPATCH, getAllNodeCollections, getNodeDispatchConfig, } from './dispatch';
 export type { NodeRegistryEntry, NodeGroup } from './registry';
 export { NODE_REGISTRY, getNodeRegistryEntry, NODE_DETAIL_PATHS, NODE_COLORS, NODE_STATE_KEYS, PREFIX_TO_NODE_TYPE, NODE_TYPE_TO_PREFIX, } from './registry';
-export { GMAIL_OPERATIONS, isGmailOperation, } from './gmail-operations';
-export type { GmailOperation } from './gmail-operations';
+export { GMAIL_OPERATIONS, GMAIL_OPERATION_SPECS, GMAIL_OPERATION_GROUPS, GMAIL_DROPDOWN_OPERATIONS, GMAIL_TOOLKIT_OPERATIONS, GMAIL_TOOLKIT_SPECS, GMAIL_ALL_TOOLKIT_SPECS, GMAIL_SEND_AND_WAIT_TOOL_SPEC, NATIVE_EMAIL_TOOLKIT_SPECS, GMAIL_TOOLKIT_BY_TOOL_NAME, NATIVE_EMAIL_TOOLKIT_BY_TOOL_NAME, GMAIL_SEND_LEGACY_FIELDS, resolveGmailSendFields, isGmailOperation, } from './gmail-operations';
+export type { GmailOperation, GmailOperationGroup, GmailParamType, GmailParamSpec, GmailOperationSpec, GmailToolkitParameter, GmailToolkitSpec, GmailSendFieldSource, GmailSendFields, } from './gmail-operations';
 export { GOOGLE_CALENDAR_OPERATIONS, GOOGLE_CALENDAR_OPERATION_SPECS, isGoogleCalendarOperation, } from './calendar-operations';
 export type { GoogleCalendarOperation, GoogleCalendarParamTarget, GoogleCalendarParamType, GoogleCalendarParamSpec, GoogleCalendarOperationSpec, } from './calendar-operations';
 export { GOOGLE_CALENDAR_TOOLKIT_SPECS, GOOGLE_CALENDAR_TOOLKIT_BY_TOOL_NAME, } from './calendar-toolkit';
@@ -37,5 +37,7 @@ export { MONGO_OPERATIONS, MONGO_OPERATION_SPECS, isMongoOperation, } from './mo
 export type { MongoOperation, MongoParamType, MongoParamSpec, MongoOperationSpec, } from './mongo-operations';
 export { DOCS_OPERATIONS, DOCS_OPERATION_SPECS, isDocsOperation, } from './docs-operations';
 export type { DocsOperation, DocsParamType, DocsParamSlot, DocsParamSpec, DocsOperationSpec, } from './docs-operations';
+export { DOCS_TOOLKIT_SPECS, DOCS_TOOLKIT_BY_TOOL_NAME, DOCS_TOOLKIT_DEFAULTABLE, } from './docs-toolkit';
+export type { DocsToolkitSpec, DocsToolkitParameter, } from './docs-toolkit';
 export type { CredentialTypeRegistration, CredentialType } from './credentials';
 export { CREDENTIAL_TYPES, CREDENTIAL_TYPE_VALUES, credentialTypeValues, getCredentialType, isCredentialType, } from './credentials';

package/dist/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isSheetsOperation = exports.SHEETS_OPERATION_SPECS = exports.SHEETS_OPERATIONS = exports.isSlackOperation = exports.SLACK_OPERATION_SPECS = exports.SLACK_OPERATIONS = exports.isDiscordOperation = exports.DISCORD_OPERATION_SPECS = exports.DISCORD_OPERATIONS = 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.GMAIL_OPERATIONS = 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.getNodeDispatchConfig = exports.getAllNodeCollections = exports.NODE_DISPATCH = 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.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = 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.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 = void 0;
+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 = 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.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.getNodeDispatchConfig = exports.getAllNodeCollections = exports.NODE_DISPATCH = 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.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = 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.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.isSlackOperation = exports.SLACK_OPERATION_SPECS = exports.SLACK_OPERATIONS = exports.isDiscordOperation = exports.DISCORD_OPERATION_SPECS = exports.DISCORD_OPERATIONS = exports.isWhatsAppOperation = exports.WHATSAPP_OPERATIONS = exports.TELEGRAM_TOOLKIT_BY_TOOL_NAME = void 0;
 var types_1 = require("./types");
 Object.defineProperty(exports, "singleMeta", { enumerable: true, get: function () { return types_1.singleMeta; } });
 Object.defineProperty(exports, "iterableMeta", { enumerable: true, get: function () { return types_1.iterableMeta; } });
@@ -35,6 +35,18 @@ Object.defineProperty(exports, "NODE_TYPE_TO_PREFIX", { enumerable: true, get: f
 // ── Per-service operation enums (ALL repos) ──
 var gmail_operations_1 = require("./gmail-operations");
 Object.defineProperty(exports, "GMAIL_OPERATIONS", { enumerable: true, get: function () { return gmail_operations_1.GMAIL_OPERATIONS; } });
+Object.defineProperty(exports, "GMAIL_OPERATION_SPECS", { enumerable: true, get: function () { return gmail_operations_1.GMAIL_OPERATION_SPECS; } });
+Object.defineProperty(exports, "GMAIL_OPERATION_GROUPS", { enumerable: true, get: function () { return gmail_operations_1.GMAIL_OPERATION_GROUPS; } });
+Object.defineProperty(exports, "GMAIL_DROPDOWN_OPERATIONS", { enumerable: true, get: function () { return gmail_operations_1.GMAIL_DROPDOWN_OPERATIONS; } });
+Object.defineProperty(exports, "GMAIL_TOOLKIT_OPERATIONS", { enumerable: true, get: function () { return gmail_operations_1.GMAIL_TOOLKIT_OPERATIONS; } });
+Object.defineProperty(exports, "GMAIL_TOOLKIT_SPECS", { enumerable: true, get: function () { return gmail_operations_1.GMAIL_TOOLKIT_SPECS; } });
+Object.defineProperty(exports, "GMAIL_ALL_TOOLKIT_SPECS", { enumerable: true, get: function () { return gmail_operations_1.GMAIL_ALL_TOOLKIT_SPECS; } });
+Object.defineProperty(exports, "GMAIL_SEND_AND_WAIT_TOOL_SPEC", { enumerable: true, get: function () { return gmail_operations_1.GMAIL_SEND_AND_WAIT_TOOL_SPEC; } });
+Object.defineProperty(exports, "NATIVE_EMAIL_TOOLKIT_SPECS", { enumerable: true, get: function () { return gmail_operations_1.NATIVE_EMAIL_TOOLKIT_SPECS; } });
+Object.defineProperty(exports, "GMAIL_TOOLKIT_BY_TOOL_NAME", { enumerable: true, get: function () { return gmail_operations_1.GMAIL_TOOLKIT_BY_TOOL_NAME; } });
+Object.defineProperty(exports, "NATIVE_EMAIL_TOOLKIT_BY_TOOL_NAME", { enumerable: true, get: function () { return gmail_operations_1.NATIVE_EMAIL_TOOLKIT_BY_TOOL_NAME; } });
+Object.defineProperty(exports, "GMAIL_SEND_LEGACY_FIELDS", { enumerable: true, get: function () { return gmail_operations_1.GMAIL_SEND_LEGACY_FIELDS; } });
+Object.defineProperty(exports, "resolveGmailSendFields", { enumerable: true, get: function () { return gmail_operations_1.resolveGmailSendFields; } });
 Object.defineProperty(exports, "isGmailOperation", { enumerable: true, get: function () { return gmail_operations_1.isGmailOperation; } });
 var calendar_operations_1 = require("./calendar-operations");
 Object.defineProperty(exports, "GOOGLE_CALENDAR_OPERATIONS", { enumerable: true, get: function () { return calendar_operations_1.GOOGLE_CALENDAR_OPERATIONS; } });
@@ -97,6 +109,10 @@ var docs_operations_1 = require("./docs-operations");
 Object.defineProperty(exports, "DOCS_OPERATIONS", { enumerable: true, get: function () { return docs_operations_1.DOCS_OPERATIONS; } });
 Object.defineProperty(exports, "DOCS_OPERATION_SPECS", { enumerable: true, get: function () { return docs_operations_1.DOCS_OPERATION_SPECS; } });
 Object.defineProperty(exports, "isDocsOperation", { enumerable: true, get: function () { return docs_operations_1.isDocsOperation; } });
+var docs_toolkit_1 = require("./docs-toolkit");
+Object.defineProperty(exports, "DOCS_TOOLKIT_SPECS", { enumerable: true, get: function () { return docs_toolkit_1.DOCS_TOOLKIT_SPECS; } });
+Object.defineProperty(exports, "DOCS_TOOLKIT_BY_TOOL_NAME", { enumerable: true, get: function () { return docs_toolkit_1.DOCS_TOOLKIT_BY_TOOL_NAME; } });
+Object.defineProperty(exports, "DOCS_TOOLKIT_DEFAULTABLE", { enumerable: true, get: function () { return docs_toolkit_1.DOCS_TOOLKIT_DEFAULTABLE; } });
 var credentials_1 = require("./credentials");
 Object.defineProperty(exports, "CREDENTIAL_TYPES", { enumerable: true, get: function () { return credentials_1.CREDENTIAL_TYPES; } });
 Object.defineProperty(exports, "CREDENTIAL_TYPE_VALUES", { enumerable: true, get: function () { return credentials_1.CREDENTIAL_TYPE_VALUES; } });

package/dist/sheets-toolkit.d.ts

@@ -2,11 +2,18 @@
  * Google Sheets AI Toolkit — las herramientas que un sheetsAction expone
  * cuando `aiEnabled` está encendido.
  *
- * **Se escribe una sola vez.** Las especificaciones de toolkit de los demás
- * nodos viven dos veces —una copia en el dashboard y otra en
+ * **Se escribe una sola vez.**
+ *
+ * Cuando esto se escribió, las especificaciones de los demás nodos vivían dos
+ * veces —una copia en el dashboard y otra en
  * `api/src/mcp-servers/toolkit-specs.ts`, las dos a mano y sin nada que las
  * ate— y de ahí salió que Contacts anunciara 15 herramientas y expusiera una.
- * Sheets empieza por el otro lado: aquí, y las dos capas la importan.
+ *
+ * Ya no es así, y este comentario decía lo contrario hasta 2026-08-12: hoy en
+ * el paquete viven **siete** toolkits —Gmail, native email, Calendar, Drive,
+ * Telegram, Sheets y Docs— y los que siguen duplicados a mano son WhatsApp,
+ * Discord, Slack y Contacts. El paquete es el sitio por defecto para uno
+ * nuevo; los cuatro rezagados están pendientes de migrar.
  *
  * La forma es la que ya consume `toolkitSpecToMcpTool` en la api, para que
  * pueda usarse sin adaptador. Los textos van en inglés porque los lee el modelo

package/dist/sheets-toolkit.js

@@ -3,11 +3,18 @@
  * Google Sheets AI Toolkit — las herramientas que un sheetsAction expone
  * cuando `aiEnabled` está encendido.
  *
- * **Se escribe una sola vez.** Las especificaciones de toolkit de los demás
- * nodos viven dos veces —una copia en el dashboard y otra en
+ * **Se escribe una sola vez.**
+ *
+ * Cuando esto se escribió, las especificaciones de los demás nodos vivían dos
+ * veces —una copia en el dashboard y otra en
  * `api/src/mcp-servers/toolkit-specs.ts`, las dos a mano y sin nada que las
  * ate— y de ahí salió que Contacts anunciara 15 herramientas y expusiera una.
- * Sheets empieza por el otro lado: aquí, y las dos capas la importan.
+ *
+ * Ya no es así, y este comentario decía lo contrario hasta 2026-08-12: hoy en
+ * el paquete viven **siete** toolkits —Gmail, native email, Calendar, Drive,
+ * Telegram, Sheets y Docs— y los que siguen duplicados a mano son WhatsApp,
+ * Discord, Slack y Contacts. El paquete es el sitio por defecto para uno
+ * nuevo; los cuatro rezagados están pendientes de migrar.
  *
  * La forma es la que ya consume `toolkitSpecToMcpTool` en la api, para que
  * pueda usarse sin adaptador. Los textos van en inglés porque los lee el modelo

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hostwebhook/node-types",
-  "version": "1.52.16",
+  "version": "1.52.18",
   "description": "Shared node type definitions, connection rules, and dispatch config for HostWebhook",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",