@hostwebhook/node-types 1.86.0 → 1.88.0

package/dist/esm/discord-toolkit.d.ts

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

package/dist/esm/discord-toolkit.js

@@ -23,8 +23,9 @@
  * y quien mire la lista de herramientas del servidor MCP.
  */
 import { camposDeDiscordNoDisponibles, operacionesDeDiscordPara, } from './discord-operations.js';
+import { marcarDestructivas } from './clase-de-herramienta.js';
 const p = (name, description, required = true, type = 'string') => ({ name, type, description, required });
-export const DISCORD_TOOLKIT_SPECS = [
+export const DISCORD_TOOLKIT_SPECS = marcarDestructivas([
     // ── Messages ───────────────────────────────────────────────────
     {
         operation: 'sendMessage',
@@ -63,7 +64,6 @@ export const DISCORD_TOOLKIT_SPECS = [
             p('channelId', 'Channel snowflake where the message lives.'),
             p('messageId', 'Snowflake of the message to delete.'),
         ],
-        destructive: true,
     },
     {
         operation: 'getMessage',
@@ -149,7 +149,6 @@ export const DISCORD_TOOLKIT_SPECS = [
         toolName: 'delete_discord_channel',
         description: 'Permanently delete a Discord channel and ALL its messages. Irreversible. ALWAYS confirm with the user before calling — Discord does not provide a recovery window.',
         parameters: [p('channelId', 'Channel snowflake to delete.')],
-        destructive: true,
     },
     {
         operation: 'getChannel',
@@ -205,7 +204,6 @@ export const DISCORD_TOOLKIT_SPECS = [
             p('userId', 'Member snowflake.'),
             p('roleId', 'Role snowflake to grant.'),
         ],
-        destructive: true,
     },
     {
         operation: 'removeRole',
@@ -217,7 +215,6 @@ export const DISCORD_TOOLKIT_SPECS = [
             p('userId', 'Member snowflake.'),
             p('roleId', 'Role snowflake to remove.'),
         ],
-        destructive: true,
     },
     {
         operation: 'getMember',
@@ -229,7 +226,7 @@ export const DISCORD_TOOLKIT_SPECS = [
             p('userId', 'Member snowflake.'),
         ],
     },
-];
+]);
 export const DISCORD_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(DISCORD_TOOLKIT_SPECS.map((s) => [s.toolName, s]));
 /**
  * Las herramientas que ofrecerle al modelo con ESTA credencial.

package/dist/esm/docs-toolkit.d.ts

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

package/dist/esm/docs-toolkit.js

@@ -13,6 +13,7 @@
  * 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 { marcarDestructivas } from './clase-de-herramienta.js';
 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
@@ -31,7 +32,7 @@ const p = (name, description, required = true, type = 'string') => ({ name, type
  * 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.');
-export const DOCS_TOOLKIT_SPECS = [
+export const DOCS_TOOLKIT_SPECS = marcarDestructivas([
     {
         operation: 'readDoc',
         label: 'Read document',
@@ -48,7 +49,6 @@ export const DOCS_TOOLKIT_SPECS = [
             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',
@@ -59,7 +59,6 @@ export const DOCS_TOOLKIT_SPECS = [
             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',
@@ -71,7 +70,6 @@ export const DOCS_TOOLKIT_SPECS = [
             p('replaceWith', 'Text to put in its place. An empty string deletes the matches.'),
             documento(),
         ],
-        destructive: true,
     },
     {
         operation: 'insertTable',
@@ -83,9 +81,8 @@ export const DOCS_TOOLKIT_SPECS = [
             p('cols', 'Number of columns.', true, 'number'),
             documento(),
         ],
-        destructive: true,
     },
-];
+]);
 /** Las herramientas por nombre, para despachar una llamada del modelo. */
 export const DOCS_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(DOCS_TOOLKIT_SPECS.map((s) => [s.toolName, s]));
 /**

package/dist/esm/drive-toolkit.d.ts

@@ -42,10 +42,15 @@ export interface DriveToolkitSpec {
     /** Encabezado de grupo de la página de detalle. El orden es el que agrupa. */
     group?: string;
     /**
-     * Marca que la herramienta cambia algo difícil de deshacer, para que la página
-     * lo enseñe y el AI Node pida confirmación. Son **dos**, las mismas que ya
-     * estaban marcadas: `delete_drive_file` y `share_drive_file`. `move` no lo
-     * lleva, y es defendible — deshacerlo es otro move.
+     * Pisa o borra. Lo pone `marcarDestructivas` leyendo el verbo del nombre
+     * (ver `clase-de-herramienta.ts`), no se escribe a mano.
+     *
+     * ⚠️ Hasta el 2026-09-24 aquí se decía que `move` no lo llevaba —«deshacerlo
+     * es otro move»—, mientras la tabla de anotaciones MCP de la api decía lo
+     * contrario: sacar el fichero de su carpeta es quitarlo de donde estaba. Eran
+     * dos criterios para lo mismo; se queda el de la tabla, que es el único que
+     * estaba escrito como regla. `share_drive_file` sigue marcada, ahora como
+     * excepción explícita: compartir expone, y eso no se deshace.
      */
     destructive?: boolean;
 }

package/dist/esm/drive-toolkit.js

@@ -19,11 +19,12 @@
  * herramientas del mismo grupo tienen que ir seguidas. Los tres grupos son los
  * que ya inventaba el JSX que sustituye.
  */
+import { marcarDestructivas } from './clase-de-herramienta.js';
 const p = (name, description, required = true, type = 'string') => ({ name, type, description, required });
 const ENTRAN_Y_SALEN = 'Files in / out';
 const DESCUBRIR = 'Discovery';
 const MUTACIONES = 'Mutations (LLM confirms first)';
-export const DRIVE_TOOLKIT_SPECS = [
+export const DRIVE_TOOLKIT_SPECS = marcarDestructivas([
     /* ── Files in / out ─────────────────────────────────────────────────── */
     {
         operation: 'upload',
@@ -154,7 +155,6 @@ export const DRIVE_TOOLKIT_SPECS = [
             p('fileId', 'The Drive file ID to delete.'),
             p('permanent', 'Optional. true = bypass trash and erase forever (irreversible). Default false.', false, 'boolean'),
         ],
-        destructive: true,
     },
     {
         operation: 'share',
@@ -170,8 +170,7 @@ export const DRIVE_TOOLKIT_SPECS = [
             p('domain', 'Required when type=domain.', false),
             p('sendNotificationEmail', 'Optional. true = email the recipient about the share.', false, 'boolean'),
         ],
-        destructive: true,
     },
-];
+]);
 /** Índice por nombre de herramienta, para enrutar un `tools/call` sin recorrer. */
 export const DRIVE_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(DRIVE_TOOLKIT_SPECS.map((s) => [s.toolName, s]));

package/dist/esm/gmail-operations.d.ts

@@ -151,6 +151,8 @@ export interface GmailToolkitSpec {
     toolName: string;
     description: string;
     parameters: GmailToolkitParameter[];
+    /** 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 GMAIL_TOOLKIT_SPECS: GmailToolkitSpec[];

package/dist/esm/gmail-operations.js

@@ -12,6 +12,7 @@
  * dashboard owns the UI form schema, the api owns the dispatch logic),
  * but the canonical list of valid operation strings lives here.
  */
+import { marcarDestructivas } from './clase-de-herramienta.js';
 export const GMAIL_OPERATIONS = [
     'send',
     // Pause-the-pipeline op — sends an email with Approve / (optional)
@@ -296,7 +297,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);
-export const GMAIL_TOOLKIT_SPECS = [
+export const GMAIL_TOOLKIT_SPECS = marcarDestructivas([
     {
         operation: 'send',
         label: 'Send message',
@@ -505,7 +506,7 @@ export const 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
@@ -535,12 +536,12 @@ export const GMAIL_SEND_AND_WAIT_TOOL_SPEC = {
     ],
 };
 /** Todo lo que el nodo sabe ejecutar, se ofrezca o no como herramienta. */
-export const GMAIL_ALL_TOOLKIT_SPECS = [
+export const GMAIL_ALL_TOOLKIT_SPECS = marcarDestructivas([
     ...GMAIL_TOOLKIT_SPECS,
     GMAIL_SEND_AND_WAIT_TOOL_SPEC,
-];
+]);
 /** El toolkit del proveedor nativo (Resend): una sola herramienta. */
-export const NATIVE_EMAIL_TOOLKIT_SPECS = [
+export const NATIVE_EMAIL_TOOLKIT_SPECS = marcarDestructivas([
     {
         operation: 'send',
         label: 'Send email',
@@ -559,7 +560,7 @@ export const 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),
         ],
     },
-];
+]);
 export const GMAIL_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(GMAIL_ALL_TOOLKIT_SPECS.map((s) => [s.toolName, s]));
 export const NATIVE_EMAIL_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(NATIVE_EMAIL_TOOLKIT_SPECS.map((s) => [s.toolName, s]));
 /** Los tres campos que un día vivieron en la raíz. */

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

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

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

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

package/dist/esm/index.d.ts

@@ -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/esm/index.js

@@ -53,6 +53,15 @@ export { POSTGRES_OPERATIONS, POSTGRES_MODES, POSTGRES_OPERATION_SPECS, isPostgr
 export { MONGO_OPERATIONS, MONGO_OPERATION_SPECS, isMongoOperation, } from './mongo-operations.js';
 export { DOCS_OPERATIONS, DOCS_OPERATION_SPECS, isDocsOperation, } from './docs-operations.js';
 export { DOCS_TOOLKIT_SPECS, DOCS_TOOLKIT_BY_TOOL_NAME, DOCS_TOOLKIT_DEFAULTABLE, } from './docs-toolkit.js';
+// ── Toolkits de bases de datos, y la clase de cada herramienta (2026-09-24) ──
+export { MONGO_TOOLKIT_SPECS, MONGO_TOOLKIT_BY_TOOL_NAME, } from './mongo-toolkit.js';
+export { POSTGRES_TOOLKIT_SPECS, POSTGRES_TOOLKIT_BY_TOOL_NAME, } from './postgres-toolkit.js';
+export { claseDeHerramienta, esHerramientaDestructiva, marcarDestructivas, } from './clase-de-herramienta.js';
+export { TOOLKITS_POR_TIPO, operacionDeToolkit, esOperacionDestructiva, TIPOS_CON_TOOLKIT, tieneModoToolkit, admiteBloqueo, nombresDeHerramientas, bloqueadasDe, herramientaBloqueadaEn, MENSAJE_SIN_HERRAMIENTA, mensajeDeHerramientaBloqueada, motivoParaNoCorrer, } from './toolkits.js';
+/* Contacts se escribía a mano en la api y en el dashboard; ahora una vez. Se
+   llama `…_TOOLKIT_SPECS` porque `GOOGLE_CONTACTS_OPERATION_SPECS` ya es el
+   formulario del nodo — la misma pareja que Discord y Slack. */
+export { GOOGLE_CONTACTS_TOOLKIT_SPECS, GOOGLE_CONTACTS_TOOLKIT_BY_TOOL_NAME, } from './google-contacts-toolkit.js';
 export { LLM_PROVIDERS, LLM_MODELS, MODEL_CONTEXT_WINDOWS, getModelsFor, getDefaultModel, getModelLabel, } from './llm-models.js';
 export { URL_DE_MODELOS_DE_OPENROUTER, opcionesDeModelosDeOpenRouter, ventanaDeContextoDeOpenRouter, } from './openrouter.js';
 export { CREDENTIAL_TYPES, CREDENTIAL_TYPE_VALUES, credentialTypeValues, getCredentialType, isCredentialType, } from './credentials.js';

package/dist/esm/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/esm/mongo-toolkit.js

@@ -0,0 +1,98 @@
+/**
+ * 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 { marcarDestructivas } from './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);
+export const MONGO_TOOLKIT_SPECS = 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. */
+export const MONGO_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(MONGO_TOOLKIT_SPECS.map((s) => [s.toolName, s]));