@hostwebhook/node-types 1.52.17 → 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/index.d.ts

@@ -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.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.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;
+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; } });
@@ -109,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.17",
+  "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",