@hostwebhook/node-types 1.68.0 → 1.70.0

package/dist/esm/discord-toolkit.js

@@ -0,0 +1,260 @@
+/**
+ * Discord AI Toolkit — las herramientas que un discordAction expone cuando
+ * `aiEnabled` está encendido.
+ *
+ * **Se escribe una sola vez.** Antes vivía dos veces: una copia en
+ * `dashboard/components/discord-actions/discord-operations-schemas.ts` y otra en
+ * `api/src/mcp-servers/toolkit-specs.ts`, las dos a mano y en repos distintos,
+ * así que ningún test podía compararlas. Es la octava y novena mudanza de esta
+ * serie; de las siete anteriores, la de Contacts salió de que una copia
+ * anunciara 15 herramientas y expusiera una.
+ *
+ * Y sí había deriva, medida al mudar: la descripción de `addReaction` decía en
+ * el dashboard «URL-encoding is handled.» y en la api «URL-encoding is handled —
+ * pass the raw form.». Gana la de la api, que es la que el servidor MCP sirve
+ * hoy a clientes externos y la que dice qué hacer. Las 17 operaciones, sus
+ * nombres de herramienta y sus parámetros coincidían exactamente.
+ *
+ * Targets Discord API v10. Los parámetros snowflake son `string` porque los ids
+ * de Discord se pasan de la precisión de Number (17-20 dígitos).
+ *
+ * La forma es la que ya consume `toolkitSpecToMcpTool` en la api, para que
+ * pueda usarse sin adaptador. Los textos van en inglés porque los lee el modelo
+ * y quien mire la lista de herramientas del servidor MCP.
+ */
+import { camposDeDiscordNoDisponibles, operacionesDeDiscordPara, } from './discord-operations.js';
+const p = (name, description, required = true, type = 'string') => ({ name, type, description, required });
+export const DISCORD_TOOLKIT_SPECS = [
+    // ── Messages ───────────────────────────────────────────────────
+    {
+        operation: 'sendMessage',
+        label: 'Send message',
+        toolName: 'send_discord_message',
+        description: 'Post a message to a Discord channel or thread. ' +
+            'USAGE RULES: ' +
+            '(1) `channelId` is the snowflake of a channel the bot can see. Get it from the trigger payload, listChannels, or the user. Never invent one. ' +
+            '(2) For a quote-style reply pointing at a specific message, set `replyToMessageId`. ' +
+            "(3) To post INTO a thread instead of the parent channel, set `threadId` to the thread's snowflake. " +
+            '(4) Discord allows up to 2000 chars per message and supports markdown.',
+        parameters: [
+            p('channelId', 'Channel snowflake (or thread snowflake to post into a thread).'),
+            p('content', 'Message text. Markdown is supported. Max 2000 chars.'),
+            p('replyToMessageId', 'Snowflake of a message to quote-reply to.', false),
+            p('threadId', 'Thread snowflake to post into (overrides channelId for the actual destination).', false),
+        ],
+    },
+    {
+        operation: 'editMessage',
+        label: 'Edit message',
+        toolName: 'edit_discord_message',
+        description: "Edit an existing Discord message. The bot can only edit messages it sent itself — editing someone else's message will fail with 403.",
+        parameters: [
+            p('channelId', 'Channel snowflake where the message lives.'),
+            p('messageId', 'Snowflake of the message to edit.'),
+            p('content', 'New message content. Markdown supported. Max 2000 chars.'),
+        ],
+    },
+    {
+        operation: 'deleteMessage',
+        label: 'Delete message',
+        toolName: 'delete_discord_message',
+        description: "Permanently delete a Discord message. Irreversible. Deleting another user's message requires the bot to have Manage Messages permission. Always confirm with the user before calling this on user-authored messages.",
+        parameters: [
+            p('channelId', 'Channel snowflake where the message lives.'),
+            p('messageId', 'Snowflake of the message to delete.'),
+        ],
+        destructive: true,
+    },
+    {
+        operation: 'getMessage',
+        label: 'Get message',
+        toolName: 'get_discord_message',
+        description: 'Fetch a single Discord message with its content, author, embeds, attachments, reactions, and pinned state. Use BEFORE editing or reacting to verify the message still exists.',
+        parameters: [
+            p('channelId', 'Channel snowflake where the message lives.'),
+            p('messageId', 'Snowflake of the message to fetch.'),
+        ],
+    },
+    {
+        operation: 'addReaction',
+        label: 'Add reaction',
+        toolName: 'add_discord_reaction',
+        description: 'React to a message as the bot. ' +
+            'EMOJI FORMAT: ' +
+            '(1) Unicode emoji — pass the character itself (e.g. `🔥`, `👍`). ' +
+            '(2) Custom server emoji — pass `name:id` (e.g. `partyparrot:123456789012345678`). ' +
+            'URL-encoding is handled — pass the raw form. The bot must be in the server and have Add Reactions permission.',
+        parameters: [
+            p('channelId', 'Channel snowflake where the message lives.'),
+            p('messageId', 'Snowflake of the message to react to.'),
+            p('emoji', 'Unicode emoji or `name:id` for custom emoji.'),
+        ],
+    },
+    {
+        operation: 'removeReaction',
+        label: 'Remove reaction',
+        toolName: 'remove_discord_reaction',
+        description: "Remove the bot's own reaction from a message. Same emoji format as add_discord_reaction. Cannot remove other users' reactions through this tool.",
+        parameters: [
+            p('channelId', 'Channel snowflake where the message lives.'),
+            p('messageId', 'Snowflake of the reacted message.'),
+            p('emoji', 'Unicode emoji or `name:id` for custom emoji.'),
+        ],
+    },
+    {
+        operation: 'pinMessage',
+        label: 'Pin message',
+        toolName: 'pin_discord_message',
+        description: 'Pin a message in its channel. The bot must have Manage Messages permission. Each channel has a 50-pin limit; pinning a 51st message returns 403.',
+        parameters: [
+            p('channelId', 'Channel snowflake where the message lives.'),
+            p('messageId', 'Snowflake of the message to pin.'),
+        ],
+    },
+    // ── Channels ───────────────────────────────────────────────────
+    {
+        operation: 'createChannel',
+        label: 'Create channel',
+        toolName: 'create_discord_channel',
+        description: 'Create a new channel in a Discord guild. The bot must have Manage Channels permission. ' +
+            'TYPES: `text` (default), `voice`, `forum`, `announcement`, `category`. ' +
+            "To put the new channel under a category, set `parentId` to the category's snowflake.",
+        parameters: [
+            p('guildId', 'Guild (server) snowflake.'),
+            p('name', 'Channel name. Lowercase / hyphens recommended for text channels.'),
+            p('type', 'Channel type: text, voice, forum, announcement, category.', false),
+            p('parentId', 'Snowflake of the parent category. Optional.', false),
+            p('topic', 'Channel description (text channels only).', false),
+            p('slowmode', 'Per-user message rate limit in seconds (0-21600).', false, 'number'),
+            p('nsfw', 'Mark channel as age-restricted.', false, 'boolean'),
+        ],
+    },
+    {
+        operation: 'editChannel',
+        label: 'Edit channel',
+        toolName: 'edit_discord_channel',
+        description: 'Rename, change topic, slowmode, or move a channel under a different category. Pass only fields you want changed. Bot needs Manage Channels.',
+        parameters: [
+            p('channelId', 'Channel snowflake.'),
+            p('name', 'New channel name.', false),
+            p('topic', 'New channel description.', false),
+            p('slowmode', 'New slowmode in seconds (0-21600).', false, 'number'),
+            p('parentId', 'Move under a different category by snowflake.', false),
+            p('nsfw', 'Toggle age-restricted.', false, 'boolean'),
+        ],
+    },
+    {
+        operation: 'deleteChannel',
+        label: 'Delete channel',
+        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',
+        label: 'Get channel',
+        toolName: 'get_discord_channel',
+        description: "Fetch a Discord channel's full configuration: name, type, topic, parentId, NSFW flag, slowmode. Use to inspect before editing.",
+        parameters: [p('channelId', 'Channel snowflake to fetch.')],
+    },
+    {
+        operation: 'listChannels',
+        label: 'List channels',
+        toolName: 'list_discord_channels',
+        description: 'List every channel in a guild — text, voice, categories, threads, forums. Returns an iterable array. Use this to FIND a channel by name before posting.',
+        parameters: [p('guildId', 'Guild snowflake.')],
+    },
+    // ── Threads ────────────────────────────────────────────────────
+    {
+        operation: 'createThread',
+        label: 'Create thread',
+        toolName: 'create_discord_thread',
+        description: 'Create a thread in a channel. ' +
+            'TWO MODES: ' +
+            '(1) With `messageId` — spawns the thread off that message. Inherits its visibility. ' +
+            '(2) Without `messageId` — standalone thread. Pass `type: public|private|announcement`. Private threads require Manage Threads permission.',
+        parameters: [
+            p('channelId', 'Parent channel snowflake.'),
+            p('name', 'Thread name.'),
+            p('messageId', 'Optional anchor message snowflake. When set, thread spawns off it.', false),
+            p('type', 'Thread type: public, private, announcement (ignored when messageId is set).', false),
+            p('autoArchiveMinutes', 'Auto-archive after N minutes of inactivity (60 / 1440 / 4320 / 10080).', false, 'number'),
+        ],
+    },
+    // ── DMs ────────────────────────────────────────────────────────
+    {
+        operation: 'sendDM',
+        label: 'Send DM',
+        toolName: 'send_discord_dm',
+        description: "Direct-message a user. The user must share at least one server with the bot AND have DMs from server members enabled. Discord will silently drop the DM if the user has DMs disabled — that is the user's privacy choice. Do not retry.",
+        parameters: [
+            p('userId', 'User snowflake.'),
+            p('content', 'DM content. Markdown supported. Max 2000 chars.'),
+        ],
+    },
+    // ── Roles & members ────────────────────────────────────────────
+    {
+        operation: 'addRole',
+        label: 'Add role to member',
+        toolName: 'add_discord_role',
+        description: 'Grant a role to a guild member. ' +
+            'CRITICAL: the bot\'s OWN role must be ABOVE the role being granted in the server\'s role hierarchy. A 403 with "Missing Permissions" almost always means the bot needs to be moved up — tell the user to drag the bot role above the target role in Server Settings → Roles.',
+        parameters: [
+            p('guildId', 'Guild snowflake.'),
+            p('userId', 'Member snowflake.'),
+            p('roleId', 'Role snowflake to grant.'),
+        ],
+        destructive: true,
+    },
+    {
+        operation: 'removeRole',
+        label: 'Remove role from member',
+        toolName: 'remove_discord_role',
+        description: "Remove a role from a guild member. Same hierarchy rule as add_discord_role — bot's role must be above the target role. Cannot remove the @everyone role.",
+        parameters: [
+            p('guildId', 'Guild snowflake.'),
+            p('userId', 'Member snowflake.'),
+            p('roleId', 'Role snowflake to remove.'),
+        ],
+        destructive: true,
+    },
+    {
+        operation: 'getMember',
+        label: 'Get member',
+        toolName: 'get_discord_member',
+        description: 'Fetch a guild member: their server nickname, role IDs, joined-at timestamp, and the underlying user object. Use BEFORE addRole / removeRole to inspect current roles.',
+        parameters: [
+            p('guildId', 'Guild snowflake.'),
+            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.
+ *
+ * Vive aquí y no en cada consumidor porque son dos —la expansión MCP de la api
+ * y el selector del AI Node del dashboard— y filtrar «casi igual» en dos sitios
+ * es exactamente la duplicación que costó tres PR quitar de este paquete.
+ *
+ * Filtra en los dos niveles, que es lo que hace falta y no es obvio:
+ *
+ *   1. **Operaciones**: sin esto, a un nodo con credencial de webhook se le
+ *      entregan al modelo 17 herramientas de las que 13 fallan siempre. El
+ *      modelo no tiene forma de saberlo: las ve anunciadas.
+ *   2. **Parámetros**: una herramienta que sigue pidiendo `channelId` invita al
+ *      modelo a inventarse un canal que el webhook va a ignorar. Peor que
+ *      fallar, porque parece que funcionó.
+ */
+export function herramientasDeDiscordPara(tipoDeCredencial) {
+    const permitidas = new Set(operacionesDeDiscordPara(tipoDeCredencial));
+    const fuera = camposDeDiscordNoDisponibles(tipoDeCredencial);
+    return DISCORD_TOOLKIT_SPECS.filter((s) => permitidas.has(s.operation)).map((s) => 
+    /* Se devuelve una copia sólo cuando hay algo que quitar: así el camino
+       normal —el bot, que puede con todo— sigue entregando las MISMAS
+       referencias de siempre y nadie paga por una función que no le afecta. */
+    fuera.size === 0
+        ? s
+        : { ...s, parameters: s.parameters.filter((p) => !fuera.has(p.name)) });
+}

package/dist/esm/dispatch.d.ts

@@ -0,0 +1,16 @@
+/**
+ * API dispatch config — service names, collection names, filter support.
+ * Only imported by the API. Broker and Dashboard don't need this.
+ *
+ * `pipelineDispatch` is required by the type system so a new node type
+ * cannot be added without picking a dispatch shape — the api derives
+ * its loop directly from this field, so forgetting it would silently
+ * orphan the node (the symptom Vector Store / AI / Markdown / Code /
+ * File Transform all hit before this refactor).
+ */
+import type { NodeType, NodeDispatchConfig } from './types.js';
+export declare const NODE_DISPATCH: Record<NodeType, NodeDispatchConfig>;
+/** Get all MongoDB collection names for cascade cleanup */
+export declare function getAllNodeCollections(): string[];
+/** Find dispatch config by node type */
+export declare function getNodeDispatchConfig(type: string): NodeDispatchConfig | undefined;

package/dist/esm/dispatch.js

@@ -0,0 +1,76 @@
+/**
+ * API dispatch config — service names, collection names, filter support.
+ * Only imported by the API. Broker and Dashboard don't need this.
+ *
+ * `pipelineDispatch` is required by the type system so a new node type
+ * cannot be added without picking a dispatch shape — the api derives
+ * its loop directly from this field, so forgetting it would silently
+ * orphan the node (the symptom Vector Store / AI / Markdown / Code /
+ * File Transform all hit before this refactor).
+ */
+export const NODE_DISPATCH = {
+    // ── Pipeline processing — generic dispatch off webhook ──
+    filter: { service: 'filterNodesService', collection: 'filternodes', hasFilters: true, outputFields: ['outputNodes'], customDispatch: false, pipelineDispatch: 'generic' },
+    transform: { service: 'transformNodesService', collection: 'transformnodes', hasFilters: false, outputFields: ['outputNodes'], customDispatch: false, pipelineDispatch: 'generic' },
+    code: { service: 'codeNodesService', collection: 'codenodes', hasFilters: false, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'generic' },
+    ai: { service: 'aiNodesService', collection: 'ainodes', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'generic' },
+    markdown: { service: 'markdownNodesService', collection: 'markdownnodes', hasFilters: false, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'generic' },
+    fileTransform: { service: 'fileTransformNodesService', collection: 'filetransformnodes', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'generic' },
+    vectorStore: { service: 'vectorStoreNodesService', collection: 'vectorstorenodes', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'generic' },
+    limit: { service: 'limitNodesService', collection: 'limitnodes', hasFilters: false, outputFields: ['outputNodes'], customDispatch: false, pipelineDispatch: 'generic' },
+    // ── Pipeline processing — custom dispatch (dedicated switch case) ──
+    schemaValidator: { service: 'schemaValidatorsService', collection: 'schemavalidators', hasFilters: false, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'custom' },
+    delay: { service: 'delayNodesService', collection: 'delaynodes', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'custom' },
+    rateLimiter: { service: 'rateLimiterNodesService', collection: 'ratelimiternodes', hasFilters: false, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'custom' },
+    aggregator: { service: 'aggregatorNodesService', collection: 'aggregatornodes', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'custom' },
+    cache: { service: 'cacheNodesService', collection: 'cachenodes', hasFilters: false, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'custom' },
+    // ── Flow control — custom dispatch (branching / merging / loops) ──
+    split: { service: 'splitNodesService', collection: 'splitnodes', hasFilters: false, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'custom' },
+    conditional: { service: 'conditionalNodesService', collection: 'conditionalnodes', hasFilters: false, outputFields: ['outputNodes', 'elseOutputNodes'], customDispatch: true, pipelineDispatch: 'custom' },
+    merge: { service: 'mergeNodesService', collection: 'mergenodes', hasFilters: false, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'custom' },
+    approval: { service: 'approvalNodesService', collection: 'approvalnodes', hasFilters: false, outputFields: ['outputNodes', 'rejectionOutputNodes'], customDispatch: true, pipelineDispatch: 'custom' },
+    loop: { service: 'loopNodesService', collection: 'loopnodes', hasFilters: false, outputFields: ['loopOutputNodes', 'doneOutputNodes'], customDispatch: true, pipelineDispatch: 'custom' },
+    // ── Routing — custom dispatch ──
+    router: { service: 'routersService', collection: 'routers', hasFilters: false, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'custom' },
+    // ── Action nodes — fired in onDeliveryResult, excluded from webhook dispatch ──
+    emailAction: { service: 'emailActionsService', collection: 'emailactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    gmailAction: { service: 'gmailActionsService', collection: 'gmailactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    httpAction: { service: 'httpActionsService', collection: 'httpactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    mongoAction: { service: 'mongoActionsService', collection: 'mongoactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    postgresAction: { service: 'postgresActionsService', collection: 'postgresactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    notificationAction: { service: 'notificationActionsService', collection: 'notificationactions', hasFilters: true, outputFields: [], customDispatch: true, pipelineDispatch: 'excluded' },
+    sheetsAction: { service: 'sheetsActionsService', collection: 'sheetsactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    calendarAction: { service: 'calendarActionsService', collection: 'calendaractions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    docsAction: { service: 'docsActionsService', collection: 'docsactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    driveAction: { service: 'driveActionsService', collection: 'driveactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    firecrawlAction: { service: 'firecrawlActionsService', collection: 'firecrawlactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    telegramAction: { service: 'telegramActionsService', collection: 'telegramactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    whatsappAction: { service: 'whatsappActionsService', collection: 'whatsappactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    discordAction: { service: 'discordActionsService', collection: 'discordactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    mailchimpAction: { service: 'mailchimpActionsService', collection: 'mailchimpactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    shopifyAction: { service: 'shopifyActionsService', collection: 'shopifyactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    githubAction: { service: 'githubActionsService', collection: 'githubactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    jiraAction: { service: 'jiraActionsService', collection: 'jiraactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    slackAction: { service: 'slackActionsService', collection: 'slackactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    googleContactsAction: { service: 'googleContactsActionsService', collection: 'googlecontactsactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    googleAnalyticsAction: { service: 'googleAnalyticsActionsService', collection: 'googleanalyticsactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    notionAction: { service: 'notionActionsService', collection: 'notionactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    rssAction: { service: 'rssActionsService', collection: 'rssactions', hasFilters: false, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    socialMediaAction: { service: 'socialMediaActionsService', collection: 'socialmediaactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    // ── Sources — start the flow themselves, not dispatched ──
+    webhook: { service: 'webhooksService', collection: 'webhooks', hasFilters: false, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    scheduledWorkflow: { service: 'scheduledWorkflowsService', collection: 'scheduledworkflows', hasFilters: false, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    chatTrigger: { service: 'chatTriggersService', collection: 'chattriggers', hasFilters: false, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    trigger: { service: 'triggersService', collection: 'triggers', hasFilters: false, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    voiceAgent: { service: 'voiceAgentsService', collection: 'voiceagents', hasFilters: false, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    // ── Annotation — never executed in pipeline ──
+    stickyNote: { service: 'stickyNotesService', collection: 'stickynotes', hasFilters: false, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+};
+/** Get all MongoDB collection names for cascade cleanup */
+export function getAllNodeCollections() {
+    return Object.values(NODE_DISPATCH).map(n => n.collection);
+}
+/** Find dispatch config by node type */
+export function getNodeDispatchConfig(type) {
+    return NODE_DISPATCH[type];
+}

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

@@ -0,0 +1,99 @@
+/**
+ * Google Docs operation enum + esquema del formulario — una sola copia para la
+ * api, el Dashboard y el broker.
+ *
+ * ── Lo que quita ──
+ * La lista de cinco estaba escrita a mano **siete veces**: dos en la entidad
+ * (enum de Mongoose y unión de tipos), dos en el DTO (enum de Swagger y `@IsIn`),
+ * y tres en el dashboard (`lib/api.ts`, el array `OPERATIONS` de la página y el
+ * `OP_LABELS` del lienzo). El `operation` del DTO era además un `string` pelado:
+ * sólo lo sujetaba el `@IsIn` en tiempo de ejecución.
+ *
+ * ── Lo fácil de Docs ──
+ * Como Mongo, **no hay capa de renombrado**: el `name` de cada param es la prop
+ * de la entidad tal cual, y el `apiUpdate` de la página es un passthrough. El
+ * ejecutor lee `entity.documentId`, `entity.contentTemplate`… con esos mismos
+ * nombres.
+ *
+ * ── El orden de pantalla, y por qué cambió ──
+ * Hoy es el mismo que en Sheets, Drive, Telegram, Mongo y Postgres — primero
+ * qué hacer, luego sobre qué:
+ *
+ *     ── selector de operación ──
+ *     DocumentPicker + pegar ID     (o el título, si es createDoc)
+ *     Content / Search+Replace / Rows+Columns
+ *
+ * Estuvo al revés, con el desplegable EN MEDIO y el razonamiento «qué documento
+ * → qué hacer → con qué», y este comentario decía que un refactor no debía
+ * tocarlo. Se cambió a propósito el 2026-08-12 (dashboard#128) por dos motivos:
+ * la operación es la que decide QUÉ CAMPOS aparecen —`createDoc` ni siquiera
+ * pide documento, pide título—, y ser el único nodo con otro orden es una
+ * sorpresa por nodo.
+ *
+ * Los `slot` siguen haciendo falta: separan la identidad del documento de los
+ * campos de la operación, aunque ahora las dos vayan debajo del selector. Un
+ * bucle único ordenaría por el array de params y no por ese criterio.
+ */
+export declare const DOCS_OPERATIONS: readonly ["readDoc", "createDoc", "appendText", "replaceText", "insertTable"];
+export type DocsOperation = (typeof DOCS_OPERATIONS)[number];
+/** Type guard — útil al validar entrada que no controlas (DTOs, tool calls). */
+export declare function isDocsOperation(value: unknown): value is DocsOperation;
+export type DocsParamType = 
+/**
+ * El `DocumentPicker` en vivo (lista los Docs de la credencial) **y** debajo
+ * un `TemplateInput` para pegar un ID o una plantilla. Son dos controles para
+ * un solo campo, como el `driveFile` de Drive.
+ */
+'docPicker'
+/** `TemplateInput`: una línea con autocompletado de `{{payload.*}}`. */
+ | 'template'
+/** `TemplateEditor` con `language="html"`, que es lo que acepta la api. */
+ | 'htmlTemplate'
+/**
+ * `<input type="number">`. **Ojo**: en el cable esto viaja como NÚMERO, no
+ * como string. Es la razón del 400 que este cambio arregla — ver `min`/`max`.
+ */
+ | 'number';
+/**
+ * Antes o después del selector de operación.
+ *
+ * `'document'` es la identidad del documento, que se elige antes de decidir qué
+ * hacer con él. `'config'` son los campos de la operación.
+ */
+export type DocsParamSlot = 'document' | 'config';
+export interface DocsParamSpec {
+    /** La prop de la entidad. Sin renombrado: es también la clave del cable. */
+    name: string;
+    label: string;
+    type: DocsParamType;
+    slot: DocsParamSlot;
+    /** Texto de ayuda. Llano: el paquete no lleva React. */
+    description?: string;
+    placeholder?: string;
+    /** Sólo `number`. Los topes NO son iguales en los dos: 50 filas, 20 columnas. */
+    min?: number;
+    max?: number;
+    /**
+     * Sólo `number`. Coincide con el `default` del `@Prop` de Mongoose, que es de
+     * donde salía el 3×3 que nadie podía cambiar.
+     */
+    default?: number;
+}
+export interface DocsOperationSpec {
+    /** La del desplegable de la página de detalle y del panel: «Read Document». */
+    label: string;
+    /**
+     * La de la píldora del lienzo: «Read».
+     *
+     * **Son dos etiquetas a propósito**, como en Mongo y Calendar: la tarjeta del
+     * lienzo son 260px. Antes había una TERCERA convención, porque el panel pintaba
+     * el `operation` **crudo** y decía «insertTable» donde el lienzo decía «Table»
+     * y la página «Insert Table».
+     */
+    labelShort: string;
+    /** Sub-línea del desplegable. */
+    description: string;
+    /** Orden de pantalla dentro de cada `slot`. */
+    params: DocsParamSpec[];
+}
+export declare const DOCS_OPERATION_SPECS: Record<DocsOperation, DocsOperationSpec>;

package/dist/esm/docs-operations.js

@@ -0,0 +1,127 @@
+/**
+ * Google Docs operation enum + esquema del formulario — una sola copia para la
+ * api, el Dashboard y el broker.
+ *
+ * ── Lo que quita ──
+ * La lista de cinco estaba escrita a mano **siete veces**: dos en la entidad
+ * (enum de Mongoose y unión de tipos), dos en el DTO (enum de Swagger y `@IsIn`),
+ * y tres en el dashboard (`lib/api.ts`, el array `OPERATIONS` de la página y el
+ * `OP_LABELS` del lienzo). El `operation` del DTO era además un `string` pelado:
+ * sólo lo sujetaba el `@IsIn` en tiempo de ejecución.
+ *
+ * ── Lo fácil de Docs ──
+ * Como Mongo, **no hay capa de renombrado**: el `name` de cada param es la prop
+ * de la entidad tal cual, y el `apiUpdate` de la página es un passthrough. El
+ * ejecutor lee `entity.documentId`, `entity.contentTemplate`… con esos mismos
+ * nombres.
+ *
+ * ── El orden de pantalla, y por qué cambió ──
+ * Hoy es el mismo que en Sheets, Drive, Telegram, Mongo y Postgres — primero
+ * qué hacer, luego sobre qué:
+ *
+ *     ── selector de operación ──
+ *     DocumentPicker + pegar ID     (o el título, si es createDoc)
+ *     Content / Search+Replace / Rows+Columns
+ *
+ * Estuvo al revés, con el desplegable EN MEDIO y el razonamiento «qué documento
+ * → qué hacer → con qué», y este comentario decía que un refactor no debía
+ * tocarlo. Se cambió a propósito el 2026-08-12 (dashboard#128) por dos motivos:
+ * la operación es la que decide QUÉ CAMPOS aparecen —`createDoc` ni siquiera
+ * pide documento, pide título—, y ser el único nodo con otro orden es una
+ * sorpresa por nodo.
+ *
+ * Los `slot` siguen haciendo falta: separan la identidad del documento de los
+ * campos de la operación, aunque ahora las dos vayan debajo del selector. Un
+ * bucle único ordenaría por el array de params y no por ese criterio.
+ */
+export const DOCS_OPERATIONS = [
+    'readDoc', // leer el contenido como texto plano
+    'createDoc', // crear un documento nuevo
+    'appendText', // añadir texto al final
+    'replaceText', // buscar y reemplazar
+    'insertTable', // insertar una tabla al final
+];
+/** Type guard — útil al validar entrada que no controlas (DTOs, tool calls). */
+export function isDocsOperation(value) {
+    return typeof value === 'string' && DOCS_OPERATIONS.includes(value);
+}
+/* Los campos que comparten varias operaciones. */
+const documentId = () => ({
+    name: 'documentId',
+    label: 'Or paste Document ID / template',
+    type: 'docPicker',
+    slot: 'document',
+    placeholder: '1BxiMVs0XRA5nFMdKvBd... or {{payload.documentId}}',
+});
+const contentTemplate = () => ({
+    name: 'contentTemplate',
+    label: 'Content',
+    type: 'htmlTemplate',
+    slot: 'config',
+    placeholder: 'Text to insert... supports {{payload.x}} templates',
+});
+export const DOCS_OPERATION_SPECS = {
+    readDoc: {
+        label: 'Read Document',
+        labelShort: 'Read',
+        description: 'Get document content as plain text',
+        /* La única sin campos propios: sólo dice qué documento leer. */
+        params: [documentId()],
+    },
+    createDoc: {
+        label: 'Create Document',
+        labelShort: 'Create',
+        description: 'Create a new Google Doc',
+        /* La única SIN `documentId`: aquí el documento no existe todavía. Eso es lo
+           que en la página eran dos compuertas negadas (`!== "createDoc"`). */
+        params: [
+            {
+                name: 'documentTitle',
+                label: 'Document Title',
+                type: 'template',
+                slot: 'document',
+                placeholder: 'Report — {{payload.date}} or My Document',
+            },
+            contentTemplate(),
+        ],
+    },
+    appendText: {
+        label: 'Append Text',
+        labelShort: 'Append',
+        description: 'Add text to end of document',
+        params: [documentId(), contentTemplate()],
+    },
+    replaceText: {
+        label: 'Replace Text',
+        labelShort: 'Replace',
+        description: 'Find and replace text in document',
+        params: [
+            documentId(),
+            {
+                name: 'searchText',
+                label: 'Search Text',
+                type: 'template',
+                slot: 'config',
+                placeholder: '{{PLACEHOLDER}} or text to find',
+            },
+            {
+                name: 'replaceWith',
+                label: 'Replace With',
+                type: 'template',
+                slot: 'config',
+                placeholder: '{{payload.value}} or replacement text',
+            },
+        ],
+    },
+    insertTable: {
+        label: 'Insert Table',
+        labelShort: 'Table',
+        description: 'Insert a table at end of document',
+        params: [
+            documentId(),
+            /* Los topes son distintos y no es un descuido: 50 filas, 20 columnas. */
+            { name: 'tableRows', label: 'Rows', type: 'number', slot: 'config', min: 1, max: 50, default: 3 },
+            { name: 'tableCols', label: 'Columns', type: 'number', slot: 'config', min: 1, max: 20, default: 3 },
+        ],
+    },
+};

package/dist/esm/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.js';
+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"];