@hostwebhook/node-types 1.86.0 → 1.88.0

package/dist/gmail-operations.js

@@ -1,8 +1,4 @@
 "use strict";
-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_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:
@@ -17,6 +13,11 @@ exports.resolveGmailSendFields = resolveGmailSendFields;
  * dashboard owns the UI form schema, the api owns the dispatch logic),
  * but the canonical list of valid operation strings lives here.
  */
+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_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;
+const clase_de_herramienta_js_1 = require("./clase-de-herramienta.js");
 exports.GMAIL_OPERATIONS = [
     'send',
     // Pause-the-pipeline op — sends an email with Approve / (optional)
@@ -301,7 +302,7 @@ const p = (name, description, required = true, type = 'string') => ({ name, type
 const ADJUNTOS = p('attachments', 'Optional. Files to attach, taken from the payload: pass the `_file` reference object(s) ' +
     'exactly as they appear (a single `_file`, or the `_files` / `files` array), as a JSON ' +
     'string. Never invent one. Up to 5 files, 25 MB in total.', false);
-exports.GMAIL_TOOLKIT_SPECS = [
+exports.GMAIL_TOOLKIT_SPECS = (0, clase_de_herramienta_js_1.marcarDestructivas)([
     {
         operation: 'send',
         label: 'Send message',
@@ -510,7 +511,7 @@ exports.GMAIL_TOOLKIT_SPECS = [
             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
@@ -540,12 +541,12 @@ exports.GMAIL_SEND_AND_WAIT_TOOL_SPEC = {
     ],
 };
 /** Todo lo que el nodo sabe ejecutar, se ofrezca o no como herramienta. */
-exports.GMAIL_ALL_TOOLKIT_SPECS = [
+exports.GMAIL_ALL_TOOLKIT_SPECS = (0, clase_de_herramienta_js_1.marcarDestructivas)([
     ...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 = [
+exports.NATIVE_EMAIL_TOOLKIT_SPECS = (0, clase_de_herramienta_js_1.marcarDestructivas)([
     {
         operation: 'send',
         label: 'Send email',
@@ -564,7 +565,7 @@ exports.NATIVE_EMAIL_TOOLKIT_SPECS = [
             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. */

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

@@ -70,6 +70,16 @@ export { DOCS_OPERATIONS, DOCS_OPERATION_SPECS, isDocsOperation, } from './docs-
 export type { DocsOperation, DocsParamType, DocsParamSlot, DocsParamSpec, DocsOperationSpec, } from './docs-operations.js';
 export { DOCS_TOOLKIT_SPECS, DOCS_TOOLKIT_BY_TOOL_NAME, DOCS_TOOLKIT_DEFAULTABLE, } from './docs-toolkit.js';
 export type { DocsToolkitSpec, DocsToolkitParameter, } from './docs-toolkit.js';
+export { MONGO_TOOLKIT_SPECS, MONGO_TOOLKIT_BY_TOOL_NAME, } from './mongo-toolkit.js';
+export type { MongoToolkitSpec, MongoToolkitParameter, } from './mongo-toolkit.js';
+export { POSTGRES_TOOLKIT_SPECS, POSTGRES_TOOLKIT_BY_TOOL_NAME, } from './postgres-toolkit.js';
+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, 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';
 export type { ModeloDeOpenRouter, PrecioDeOpenRouter, RespuestaDeModelosDeOpenRouter, } from './openrouter.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.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; } });
@@ -224,6 +225,36 @@ var docs_toolkit_js_1 = require("./docs-toolkit.js");
 Object.defineProperty(exports, "DOCS_TOOLKIT_SPECS", { enumerable: true, get: function () { return docs_toolkit_js_1.DOCS_TOOLKIT_SPECS; } });
 Object.defineProperty(exports, "DOCS_TOOLKIT_BY_TOOL_NAME", { enumerable: true, get: function () { return docs_toolkit_js_1.DOCS_TOOLKIT_BY_TOOL_NAME; } });
 Object.defineProperty(exports, "DOCS_TOOLKIT_DEFAULTABLE", { enumerable: true, get: function () { return docs_toolkit_js_1.DOCS_TOOLKIT_DEFAULTABLE; } });
+// ── Toolkits de bases de datos, y la clase de cada herramienta (2026-09-24) ──
+var mongo_toolkit_js_1 = require("./mongo-toolkit.js");
+Object.defineProperty(exports, "MONGO_TOOLKIT_SPECS", { enumerable: true, get: function () { return mongo_toolkit_js_1.MONGO_TOOLKIT_SPECS; } });
+Object.defineProperty(exports, "MONGO_TOOLKIT_BY_TOOL_NAME", { enumerable: true, get: function () { return mongo_toolkit_js_1.MONGO_TOOLKIT_BY_TOOL_NAME; } });
+var postgres_toolkit_js_1 = require("./postgres-toolkit.js");
+Object.defineProperty(exports, "POSTGRES_TOOLKIT_SPECS", { enumerable: true, get: function () { return postgres_toolkit_js_1.POSTGRES_TOOLKIT_SPECS; } });
+Object.defineProperty(exports, "POSTGRES_TOOLKIT_BY_TOOL_NAME", { enumerable: true, get: function () { return postgres_toolkit_js_1.POSTGRES_TOOLKIT_BY_TOOL_NAME; } });
+var clase_de_herramienta_js_1 = require("./clase-de-herramienta.js");
+Object.defineProperty(exports, "claseDeHerramienta", { enumerable: true, get: function () { return clase_de_herramienta_js_1.claseDeHerramienta; } });
+Object.defineProperty(exports, "esHerramientaDestructiva", { enumerable: true, get: function () { return clase_de_herramienta_js_1.esHerramientaDestructiva; } });
+Object.defineProperty(exports, "marcarDestructivas", { enumerable: true, get: function () { return clase_de_herramienta_js_1.marcarDestructivas; } });
+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/mongo-toolkit.d.ts

@@ -0,0 +1,47 @@
+/**
+ * MongoDB AI Toolkit — las herramientas que un mongoAction expone cuando
+ * `aiEnabled` está encendido.
+ *
+ * ## Lo que el modelo NO elige (2026-09-24, decisiones de Ariel)
+ *
+ * - **La colección.** Es la del nodo y no hay parámetro para cambiarla: para
+ *   tocar otra se conecta otro nodo. Una herramienta de base de datos que deja
+ *   al modelo nombrar la colección le da acceso a todo lo que la credencial
+ *   alcanza, y eso no se ve al mirar el lienzo.
+ * - **El JavaScript del servidor.** `$where`, `$function` y `$accumulator`
+ *   ejecutan código dentro de Mongo; el handler los rechaza en cualquier
+ *   filtro o pipeline que venga del modelo.
+ * - **Escribir desde una agregación.** `$out` y `$merge` son las dos etapas que
+ *   escriben; `aggregate_documents` las rechaza, y por eso cuenta como lectura.
+ *
+ * ## Los nombres
+ *
+ * Cada nombre empieza por el verbo que dice lo que hace, porque el `destructive`
+ * de cada operación lo pone `marcarDestructivas` leyendo ese verbo (ver
+ * `clase-de-herramienta.ts`). Por eso `findOneAndUpdate` se ofrece como
+ * `update_and_return_document` y no como `find_and_update_document`: con el
+ * segundo nombre el verbo diría «lectura» de algo que pisa un documento.
+ *
+ * Los textos van en inglés porque los lee el modelo.
+ */
+import type { MongoOperation } from './mongo-operations';
+export interface MongoToolkitParameter {
+    name: string;
+    /** El esquema MCP sólo admite estos tres; lo estructurado viaja como JSON
+     *  en un `string`, igual que las filas de Sheets. */
+    type: 'string' | 'number' | 'boolean';
+    description: string;
+    required: boolean;
+}
+export interface MongoToolkitSpec {
+    operation: MongoOperation;
+    label: string;
+    toolName: string;
+    description: string;
+    parameters: MongoToolkitParameter[];
+    /** Pisa o borra. Lo pone `marcarDestructivas`, no se escribe a mano. */
+    destructive?: boolean;
+}
+export declare const MONGO_TOOLKIT_SPECS: MongoToolkitSpec[];
+/** Las herramientas por nombre, para despachar una llamada del modelo. */
+export declare const MONGO_TOOLKIT_BY_TOOL_NAME: Record<string, MongoToolkitSpec>;

package/dist/mongo-toolkit.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * MongoDB AI Toolkit — las herramientas que un mongoAction expone cuando
+ * `aiEnabled` está encendido.
+ *
+ * ## Lo que el modelo NO elige (2026-09-24, decisiones de Ariel)
+ *
+ * - **La colección.** Es la del nodo y no hay parámetro para cambiarla: para
+ *   tocar otra se conecta otro nodo. Una herramienta de base de datos que deja
+ *   al modelo nombrar la colección le da acceso a todo lo que la credencial
+ *   alcanza, y eso no se ve al mirar el lienzo.
+ * - **El JavaScript del servidor.** `$where`, `$function` y `$accumulator`
+ *   ejecutan código dentro de Mongo; el handler los rechaza en cualquier
+ *   filtro o pipeline que venga del modelo.
+ * - **Escribir desde una agregación.** `$out` y `$merge` son las dos etapas que
+ *   escriben; `aggregate_documents` las rechaza, y por eso cuenta como lectura.
+ *
+ * ## Los nombres
+ *
+ * Cada nombre empieza por el verbo que dice lo que hace, porque el `destructive`
+ * de cada operación lo pone `marcarDestructivas` leyendo ese verbo (ver
+ * `clase-de-herramienta.ts`). Por eso `findOneAndUpdate` se ofrece como
+ * `update_and_return_document` y no como `find_and_update_document`: con el
+ * segundo nombre el verbo diría «lectura» de algo que pisa un documento.
+ *
+ * Los textos van en inglés porque los lee el modelo.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MONGO_TOOLKIT_BY_TOOL_NAME = exports.MONGO_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 });
+const filtro = (para, required = true) => p('filter', `JSON object with a MongoDB query filter that selects ${para}, e.g. {"email": "a@b.c"} or {"total": {"$gt": 100}}. Server-side JavaScript operators ($where, $function, $accumulator) are rejected.`, required);
+const proyeccion = () => p('projection', 'Optional JSON object choosing the fields to return, e.g. {"name": 1, "email": 1}. Leave it out to return whole documents.', false);
+exports.MONGO_TOOLKIT_SPECS = (0, clase_de_herramienta_js_1.marcarDestructivas)([
+    {
+        operation: 'findAll',
+        label: 'Find documents',
+        toolName: 'find_documents',
+        description: "Return the documents of this node's collection that match a filter. Returns at most `limit` documents — use a filter that narrows the result instead of reading the whole collection.",
+        parameters: [
+            filtro('the documents to return. {} matches every document', false),
+            proyeccion(),
+            p('sort', 'Optional JSON object with the sort order, e.g. {"createdAt": -1} for newest first.', false),
+            p('limit', 'Maximum number of documents to return (default 20, maximum 100).', false, 'number'),
+        ],
+    },
+    {
+        operation: 'findOne',
+        label: 'Find one document',
+        toolName: 'find_one_document',
+        description: "Return the first document of this node's collection that matches a filter, or nothing when none does.",
+        parameters: [filtro('the document'), proyeccion()],
+    },
+    {
+        operation: 'aggregate',
+        label: 'Aggregate documents',
+        toolName: 'aggregate_documents',
+        description: "Run an aggregation pipeline over this node's collection and return its result — for counts, sums, groupings and joins with $lookup. It only reads: the $out and $merge stages, which write, are rejected.",
+        parameters: [
+            p('pipeline', 'JSON array of aggregation stages, e.g. [{"$match": {"status": "paid"}}, {"$group": {"_id": "$customer", "total": {"$sum": "$amount"}}}].'),
+        ],
+    },
+    {
+        operation: 'insertOne',
+        label: 'Insert document',
+        toolName: 'insert_document',
+        description: "Insert one new document into this node's collection and return its _id. It does not check for duplicates — when the document might already exist, find it first.",
+        parameters: [
+            p('document', 'JSON object with the new document, e.g. {"name": "Ariel", "email": "a@b.c"}.'),
+        ],
+    },
+    {
+        operation: 'updateOne',
+        label: 'Update document',
+        toolName: 'update_document',
+        description: "Update the first document of this node's collection that matches a filter. It overwrites the fields you set. When nothing matches it changes nothing — it does not create a document.",
+        parameters: [
+            filtro('the document to update. It cannot be empty'),
+            p('update', 'JSON object with MongoDB update operators, e.g. {"$set": {"status": "shipped"}} or {"$inc": {"stock": -1}}. A plain object without operators is rejected, because it would replace the whole document.'),
+        ],
+    },
+    {
+        operation: 'findOneAndUpdate',
+        label: 'Update and return document',
+        toolName: 'update_and_return_document',
+        description: "Update the first document of this node's collection that matches a filter and return it as it is AFTER the update. Use it when you need the updated values in your reply; otherwise update_document is enough.",
+        parameters: [
+            filtro('the document to update. It cannot be empty'),
+            p('update', 'JSON object with MongoDB update operators, e.g. {"$set": {"status": "shipped"}}. A plain object without operators is rejected.'),
+        ],
+    },
+    {
+        operation: 'deleteOne',
+        label: 'Delete document',
+        toolName: 'delete_document',
+        description: "Delete the first document of this node's collection that matches a filter. This cannot be undone. When you are not sure which document the filter selects, call find_one_document first.",
+        parameters: [filtro('the document to delete. It cannot be empty')],
+    },
+]);
+/** Las herramientas por nombre, para despachar una llamada del modelo. */
+exports.MONGO_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(exports.MONGO_TOOLKIT_SPECS.map((s) => [s.toolName, s]));

package/dist/postgres-toolkit.d.ts

@@ -0,0 +1,52 @@
+/**
+ * PostgreSQL AI Toolkit — las herramientas que un postgresAction expone cuando
+ * `aiEnabled` está encendido.
+ *
+ * ## Por qué las escrituras NO reciben SQL (2026-09-24, decisión de Ariel)
+ *
+ * El nodo, en modo de una operación, ejecuta el SQL que se le escribe: sus
+ * cinco operaciones son una etiqueta encima del mismo SQL crudo. Si el toolkit
+ * hiciera lo mismo, bloquear una herramienta no bloquearía nada — un
+ * `insert_rows` puede llevar un `DELETE` dentro de un `WITH`, y quien bloqueó
+ * `delete_rows` seguiría viendo desaparecer filas.
+ *
+ * Así que las tres escrituras reciben la tabla del nodo y JSON, y el SQL lo
+ * genera el handler, parametrizado y con los identificadores entrecomillados:
+ * el modelo no escribe SQL que se ejecute como escritura.
+ *
+ * ## Lo que queda con SQL, y cómo se contiene
+ *
+ * - `query_rows` recibe SQL, y corre dentro de una transacción **READ ONLY**:
+ *   un `DELETE`, un `UPDATE` o un `CREATE` los rechaza el propio Postgres, no
+ *   una expresión regular nuestra. Puede leer otras tablas —un JOIN hace
+ *   falta a menudo—; el límite ahí lo pone el usuario de base de datos de la
+ *   credencial.
+ * - `execute_sql` recibe SQL cualquiera, DDL incluido. Es la excepción
+ *   consciente a «sólo la tabla del nodo»: SQL crudo no se puede vallar a una
+ *   tabla. La contienen tres cosas: es siempre destructiva (el gate del AI
+ *   Node la para si está encendido), se puede bloquear en el nodo, y el
+ *   usuario de base de datos.
+ *
+ * Los textos van en inglés porque los lee el modelo.
+ */
+import type { PostgresOperation } from './postgres-operations';
+export interface PostgresToolkitParameter {
+    name: string;
+    /** El esquema MCP sólo admite estos tres; lo estructurado viaja como JSON
+     *  en un `string`. */
+    type: 'string' | 'number' | 'boolean';
+    description: string;
+    required: boolean;
+}
+export interface PostgresToolkitSpec {
+    operation: PostgresOperation;
+    label: string;
+    toolName: string;
+    description: string;
+    parameters: PostgresToolkitParameter[];
+    /** Pisa o borra. Lo pone `marcarDestructivas`, no se escribe a mano. */
+    destructive?: boolean;
+}
+export declare const POSTGRES_TOOLKIT_SPECS: PostgresToolkitSpec[];
+/** Las herramientas por nombre, para despachar una llamada del modelo. */
+export declare const POSTGRES_TOOLKIT_BY_TOOL_NAME: Record<string, PostgresToolkitSpec>;