@hostwebhook/node-types 1.65.0 → 1.66.0

package/dist/discord-toolkit.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 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 type { DiscordOperation } from './discord-operations';
+export interface DiscordToolkitParameter {
+    name: string;
+    type: 'string' | 'number' | 'boolean';
+    description: string;
+    required: boolean;
+}
+export interface DiscordToolkitSpec {
+    operation: DiscordOperation;
+    /** 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: 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. */
+    destructive?: boolean;
+}
+export declare const DISCORD_TOOLKIT_SPECS: DiscordToolkitSpec[];
+export declare const DISCORD_TOOLKIT_BY_TOOL_NAME: Record<string, DiscordToolkitSpec>;

package/dist/discord-toolkit.js

@@ -0,0 +1,235 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DISCORD_TOOLKIT_BY_TOOL_NAME = exports.DISCORD_TOOLKIT_SPECS = void 0;
+const p = (name, description, required = true, type = 'string') => ({ name, type, description, required });
+exports.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.'),
+        ],
+    },
+];
+exports.DISCORD_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(exports.DISCORD_TOOLKIT_SPECS.map((s) => [s.toolName, s]));

package/dist/index.d.ts

@@ -24,6 +24,8 @@ export { WHATSAPP_OPERATIONS, isWhatsAppOperation, } from './whatsapp-operations
 export type { WhatsAppOperation } from './whatsapp-operations';
 export { DISCORD_OPERATIONS, DISCORD_OPERATION_SPECS, isDiscordOperation, } from './discord-operations';
 export type { DiscordOperation, DiscordParamSpec, DiscordOperationSpec, } from './discord-operations';
+export { DISCORD_TOOLKIT_SPECS, DISCORD_TOOLKIT_BY_TOOL_NAME, } from './discord-toolkit';
+export type { DiscordToolkitSpec, DiscordToolkitParameter, } from './discord-toolkit';
 export { MAILCHIMP_OPERATIONS, MAILCHIMP_OPERATION_SPECS, MAILCHIMP_CONTACT_STATUSES, isMailchimpOperation, } from './mailchimp-operations';
 export type { MailchimpOperation, MailchimpContactStatus, MailchimpParamSpec, MailchimpOperationSpec, } from './mailchimp-operations';
 export { SHOPIFY_OPERATIONS, SHOPIFY_OPERATION_SPECS, SHOPIFY_TAGGABLE_RESOURCES, SHOPIFY_SEARCHABLE_RESOURCES, isShopifyOperation, } from './shopify-operations';
@@ -34,6 +36,8 @@ export { JIRA_OPERATIONS, JIRA_OPERATION_SPECS, JIRA_DROPDOWN_OPERATIONS, JIRA_I
 export type { JiraOperation, JiraParamType, JiraParamSpec, JiraOperationSpec, } from './jira-operations';
 export { SLACK_OPERATIONS, SLACK_OPERATION_SPECS, isSlackOperation, } from './slack-operations';
 export type { SlackOperation, SlackParamSpec, SlackOperationSpec, } from './slack-operations';
+export { SLACK_TOOLKIT_SPECS, SLACK_TOOLKIT_BY_TOOL_NAME, } from './slack-toolkit';
+export type { SlackToolkitSpec, SlackToolkitParameter, } from './slack-toolkit';
 export { SHEETS_OPERATIONS, SHEETS_OPERATION_SPECS, isSheetsOperation, } from './sheets-operations';
 export type { SheetsOperation, SheetsParamSpec, SheetsOperationSpec, } from './sheets-operations';
 export { SHEETS_TOOLKIT_SPECS, SHEETS_TOOLKIT_BY_TOOL_NAME, SHEETS_TOOLKIT_DEFAULTABLE, } from './sheets-toolkit';

package/dist/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DRIVE_OPERATION_SPECS = exports.DRIVE_OPERATIONS = exports.GOOGLE_CALENDAR_TOOLKIT_BY_TOOL_NAME = exports.GOOGLE_CALENDAR_TOOLKIT_SPECS = exports.isGoogleCalendarOperation = exports.GOOGLE_CALENDAR_OPERATION_SPECS = exports.GOOGLE_CALENDAR_OPERATIONS = exports.isGmailOperation = exports.resolveGmailSendFields = exports.GMAIL_SEND_LEGACY_FIELDS = exports.NATIVE_EMAIL_TOOLKIT_BY_TOOL_NAME = exports.GMAIL_TOOLKIT_BY_TOOL_NAME = exports.NATIVE_EMAIL_TOOLKIT_SPECS = exports.GMAIL_SEND_AND_WAIT_TOOL_SPEC = exports.GMAIL_ALL_TOOLKIT_SPECS = exports.GMAIL_TOOLKIT_SPECS = exports.GMAIL_TOOLKIT_OPERATIONS = exports.GMAIL_DROPDOWN_OPERATIONS = exports.GMAIL_OPERATION_GROUPS = exports.GMAIL_OPERATION_SPECS = exports.GMAIL_OPERATIONS = exports.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.getNodeDispatchConfig = exports.getAllNodeCollections = exports.NODE_DISPATCH = exports.resolveNodeId = exports.PREFIX_TO_TYPE = exports.NODE_UI = exports.ALL_NODE_TYPES = exports.isNodeType = exports.isTerminal = exports.canSendToNodes = exports.canReceiveFromNodes = exports.canReceiveFrom = exports.NODE_CONNECTIONS = exports.iterableMeta = exports.singleMeta = void 0;
-exports.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.isSlackOperation = exports.SLACK_OPERATION_SPECS = exports.SLACK_OPERATIONS = exports.isJiraOperation = exports.JIRA_ITERABLE_OPERATIONS = exports.JIRA_DROPDOWN_OPERATIONS = exports.JIRA_OPERATION_SPECS = exports.JIRA_OPERATIONS = exports.isGithubOperation = exports.GITHUB_ITERABLE_OPERATIONS = exports.GITHUB_DROPDOWN_OPERATIONS = exports.GITHUB_OPERATION_SPECS = exports.GITHUB_OPERATIONS = exports.isShopifyOperation = exports.SHOPIFY_SEARCHABLE_RESOURCES = exports.SHOPIFY_TAGGABLE_RESOURCES = exports.SHOPIFY_OPERATION_SPECS = exports.SHOPIFY_OPERATIONS = exports.isMailchimpOperation = exports.MAILCHIMP_CONTACT_STATUSES = exports.MAILCHIMP_OPERATION_SPECS = exports.MAILCHIMP_OPERATIONS = exports.isDiscordOperation = exports.DISCORD_OPERATION_SPECS = exports.DISCORD_OPERATIONS = exports.isWhatsAppOperation = exports.WHATSAPP_OPERATIONS = exports.TELEGRAM_TOOLKIT_BY_TOOL_NAME = exports.TELEGRAM_TOOLKIT_SPECS = exports.isTelegramOperation = exports.TELEGRAM_OPERATION_SPECS = exports.TELEGRAM_OPERATIONS = exports.DRIVE_TOOLKIT_BY_TOOL_NAME = exports.DRIVE_TOOLKIT_SPECS = exports.isDriveOperation = void 0;
-exports.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = 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 = exports.NOTION_OPERATION_SPECS = exports.NOTION_OPERATIONS = exports.isGoogleAnalyticsOperation = exports.GOOGLE_ANALYTICS_DROPDOWN_OPERATIONS = void 0;
+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.SLACK_TOOLKIT_BY_TOOL_NAME = exports.SLACK_TOOLKIT_SPECS = exports.isSlackOperation = exports.SLACK_OPERATION_SPECS = exports.SLACK_OPERATIONS = exports.isJiraOperation = exports.JIRA_ITERABLE_OPERATIONS = exports.JIRA_DROPDOWN_OPERATIONS = exports.JIRA_OPERATION_SPECS = exports.JIRA_OPERATIONS = exports.isGithubOperation = exports.GITHUB_ITERABLE_OPERATIONS = exports.GITHUB_DROPDOWN_OPERATIONS = exports.GITHUB_OPERATION_SPECS = exports.GITHUB_OPERATIONS = exports.isShopifyOperation = exports.SHOPIFY_SEARCHABLE_RESOURCES = exports.SHOPIFY_TAGGABLE_RESOURCES = exports.SHOPIFY_OPERATION_SPECS = exports.SHOPIFY_OPERATIONS = exports.isMailchimpOperation = exports.MAILCHIMP_CONTACT_STATUSES = exports.MAILCHIMP_OPERATION_SPECS = exports.MAILCHIMP_OPERATIONS = exports.DISCORD_TOOLKIT_BY_TOOL_NAME = exports.DISCORD_TOOLKIT_SPECS = exports.isDiscordOperation = exports.DISCORD_OPERATION_SPECS = exports.DISCORD_OPERATIONS = exports.isWhatsAppOperation = exports.WHATSAPP_OPERATIONS = exports.TELEGRAM_TOOLKIT_BY_TOOL_NAME = exports.TELEGRAM_TOOLKIT_SPECS = exports.isTelegramOperation = exports.TELEGRAM_OPERATION_SPECS = exports.TELEGRAM_OPERATIONS = exports.DRIVE_TOOLKIT_BY_TOOL_NAME = exports.DRIVE_TOOLKIT_SPECS = exports.isDriveOperation = void 0;
+exports.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = 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 = 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 = void 0;
 var types_1 = require("./types");
 Object.defineProperty(exports, "singleMeta", { enumerable: true, get: function () { return types_1.singleMeta; } });
 Object.defineProperty(exports, "iterableMeta", { enumerable: true, get: function () { return types_1.iterableMeta; } });
@@ -87,6 +87,13 @@ var discord_operations_1 = require("./discord-operations");
 Object.defineProperty(exports, "DISCORD_OPERATIONS", { enumerable: true, get: function () { return discord_operations_1.DISCORD_OPERATIONS; } });
 Object.defineProperty(exports, "DISCORD_OPERATION_SPECS", { enumerable: true, get: function () { return discord_operations_1.DISCORD_OPERATION_SPECS; } });
 Object.defineProperty(exports, "isDiscordOperation", { enumerable: true, get: function () { return discord_operations_1.isDiscordOperation; } });
+/* Ojo con los dos nombres parecidos, que vienen de dos ficheros y NO son lo
+   mismo: `DiscordOperationSpec` (arriba) describe el FORMULARIO —qué control
+   pintar por campo— y `DiscordToolkitSpec` (abajo) describe la HERRAMIENTA que
+   ve el LLM. Es la misma pareja que ya tienen Telegram, Sheets y compañía. */
+var discord_toolkit_1 = require("./discord-toolkit");
+Object.defineProperty(exports, "DISCORD_TOOLKIT_SPECS", { enumerable: true, get: function () { return discord_toolkit_1.DISCORD_TOOLKIT_SPECS; } });
+Object.defineProperty(exports, "DISCORD_TOOLKIT_BY_TOOL_NAME", { enumerable: true, get: function () { return discord_toolkit_1.DISCORD_TOOLKIT_BY_TOOL_NAME; } });
 var mailchimp_operations_1 = require("./mailchimp-operations");
 Object.defineProperty(exports, "MAILCHIMP_OPERATIONS", { enumerable: true, get: function () { return mailchimp_operations_1.MAILCHIMP_OPERATIONS; } });
 Object.defineProperty(exports, "MAILCHIMP_OPERATION_SPECS", { enumerable: true, get: function () { return mailchimp_operations_1.MAILCHIMP_OPERATION_SPECS; } });
@@ -114,6 +121,11 @@ var slack_operations_1 = require("./slack-operations");
 Object.defineProperty(exports, "SLACK_OPERATIONS", { enumerable: true, get: function () { return slack_operations_1.SLACK_OPERATIONS; } });
 Object.defineProperty(exports, "SLACK_OPERATION_SPECS", { enumerable: true, get: function () { return slack_operations_1.SLACK_OPERATION_SPECS; } });
 Object.defineProperty(exports, "isSlackOperation", { enumerable: true, get: function () { return slack_operations_1.isSlackOperation; } });
+/* Misma pareja que en Discord: `SlackOperationSpec` es el formulario,
+   `SlackToolkitSpec` es la herramienta que ve el LLM. */
+var slack_toolkit_1 = require("./slack-toolkit");
+Object.defineProperty(exports, "SLACK_TOOLKIT_SPECS", { enumerable: true, get: function () { return slack_toolkit_1.SLACK_TOOLKIT_SPECS; } });
+Object.defineProperty(exports, "SLACK_TOOLKIT_BY_TOOL_NAME", { enumerable: true, get: function () { return slack_toolkit_1.SLACK_TOOLKIT_BY_TOOL_NAME; } });
 var sheets_operations_1 = require("./sheets-operations");
 Object.defineProperty(exports, "SHEETS_OPERATIONS", { enumerable: true, get: function () { return sheets_operations_1.SHEETS_OPERATIONS; } });
 Object.defineProperty(exports, "SHEETS_OPERATION_SPECS", { enumerable: true, get: function () { return sheets_operations_1.SHEETS_OPERATION_SPECS; } });

package/dist/slack-toolkit.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Slack AI Toolkit — las herramientas que un slackAction expone cuando
+ * `aiEnabled` está encendido.
+ *
+ * **Se escribe una sola vez.** Antes vivía dos veces: una copia en
+ * `dashboard/components/slack-actions/slack-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.
+ *
+ * La deriva aquí era gorda: **14 de las 16 descripciones** diferían. Gana la de
+ * la api en todas —es sistemáticamente la más completa y es la que sirve el MCP
+ * hoy—, y una no era cosmética: en `deleteMessage` la api nombra el permiso que
+ * hace falta (`chat:write.public` + admin) y el dashboard sólo decía «admin
+ * perms». Operaciones, nombres de herramienta y parámetros sí coincidían.
+ *
+ * Los nombres llevan `_slack_` para no chocar con los de Telegram y Discord
+ * cuando un mismo AI Node tiene varios toolkits encendidos.
+ *
+ * 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 type { SlackOperation } from './slack-operations';
+export interface SlackToolkitParameter {
+    name: string;
+    type: 'string' | 'number' | 'boolean';
+    description: string;
+    required: boolean;
+}
+export interface SlackToolkitSpec {
+    operation: SlackOperation;
+    /** 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: SlackToolkitParameter[];
+    /** 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. */
+    destructive?: boolean;
+}
+export declare const SLACK_TOOLKIT_SPECS: SlackToolkitSpec[];
+export declare const SLACK_TOOLKIT_BY_TOOL_NAME: Record<string, SlackToolkitSpec>;

package/dist/slack-toolkit.js

@@ -0,0 +1,218 @@
+"use strict";
+/**
+ * Slack AI Toolkit — las herramientas que un slackAction expone cuando
+ * `aiEnabled` está encendido.
+ *
+ * **Se escribe una sola vez.** Antes vivía dos veces: una copia en
+ * `dashboard/components/slack-actions/slack-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.
+ *
+ * La deriva aquí era gorda: **14 de las 16 descripciones** diferían. Gana la de
+ * la api en todas —es sistemáticamente la más completa y es la que sirve el MCP
+ * hoy—, y una no era cosmética: en `deleteMessage` la api nombra el permiso que
+ * hace falta (`chat:write.public` + admin) y el dashboard sólo decía «admin
+ * perms». Operaciones, nombres de herramienta y parámetros sí coincidían.
+ *
+ * Los nombres llevan `_slack_` para no chocar con los de Telegram y Discord
+ * cuando un mismo AI Node tiene varios toolkits encendidos.
+ *
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SLACK_TOOLKIT_BY_TOOL_NAME = exports.SLACK_TOOLKIT_SPECS = void 0;
+const p = (name, description, required = true, type = 'string') => ({ name, type, description, required });
+exports.SLACK_TOOLKIT_SPECS = [
+    // ── Messages ─────────────────────────────────────────────────────
+    {
+        operation: 'sendMessage',
+        label: 'Send message',
+        toolName: 'send_slack_message',
+        description: 'Post a message to a Slack channel, group, or DM. ' +
+            'USAGE RULES: ' +
+            '(1) `channel` is a Slack channel id (C…), group id (G…), or DM id (D…). Get it from the trigger payload, listChannels, or the user. Never invent one. ' +
+            '(2) For a thread reply, set `threadTs` to the parent message timestamp. ' +
+            '(3) Either `text` or `blocks` is required. Use blocks for rich layouts.',
+        parameters: [
+            p('channel', 'Channel/group/DM id where the message will be posted.'),
+            p('text', 'Message text. Slack mrkdwn supported. Required when blocks is empty.', false),
+            p('blocks', 'Block Kit JSON for rich layouts. Stringified JSON or JSON array.', false),
+            p('threadTs', 'Parent message timestamp to reply inside an existing thread.', false),
+        ],
+    },
+    {
+        operation: 'updateMessage',
+        label: 'Update message',
+        toolName: 'update_slack_message',
+        description: 'Edit a message previously posted by the bot. The bot can only edit its own messages — editing another user/bot message returns cant_update_message.',
+        parameters: [
+            p('channel', 'Channel where the original message lives.'),
+            p('ts', 'Timestamp of the message to edit (returned by sendMessage).'),
+            p('text', 'New message text. Required when blocks is empty.', false),
+            p('blocks', 'New Block Kit JSON. Replaces the existing layout.', false),
+        ],
+    },
+    {
+        operation: 'deleteMessage',
+        label: 'Delete message',
+        toolName: 'delete_slack_message',
+        description: "Delete a message the bot posted. Other users' messages need chat:write.public + admin perms — usually fails for AI-driven calls. Confirm before destructive use.",
+        parameters: [
+            p('channel', 'Channel where the message lives.'),
+            p('ts', 'Timestamp of the message to delete.'),
+        ],
+        destructive: true,
+    },
+    {
+        operation: 'sendEphemeral',
+        label: 'Send ephemeral',
+        toolName: 'send_slack_ephemeral',
+        description: 'Post a message visible only to a specific user — the rest of the channel does not see it. Useful for per-user prompts, errors, or warnings.',
+        parameters: [
+            p('channel', 'Channel where the ephemeral message will appear.'),
+            p('user', 'User id (U…) — the only viewer of the message.'),
+            p('text', 'Message text. Required when blocks is empty.', false),
+            p('blocks', 'Block Kit JSON for rich layouts.', false),
+        ],
+    },
+    {
+        operation: 'scheduleMessage',
+        label: 'Schedule message',
+        toolName: 'schedule_slack_message',
+        description: 'Schedule a Slack message to be posted at a future time. Returns a scheduled_message_id useful for cancellation later.',
+        parameters: [
+            p('channel', 'Channel where the message will be posted.'),
+            p('postAt', 'When to post — unix timestamp in SECONDS, not milliseconds.', true, 'number'),
+            p('text', 'Message text. Required when blocks is empty.', false),
+            p('blocks', 'Block Kit JSON for rich layouts.', false),
+        ],
+    },
+    {
+        operation: 'getMessage',
+        label: 'Get message',
+        toolName: 'get_slack_message',
+        description: 'Fetch a single message by its timestamp. Returns the message text + author + reactions + attachments. Use BEFORE editing or reacting to verify state.',
+        parameters: [
+            p('channel', 'Channel where the message lives.'),
+            p('ts', 'Timestamp of the message to fetch.'),
+        ],
+    },
+    // ── Channels ─────────────────────────────────────────────────────
+    {
+        operation: 'listChannels',
+        label: 'List channels',
+        toolName: 'list_slack_channels',
+        description: 'List public + private channels the bot can see in the workspace. Returns id, name, isMember, memberCount per channel. Pre-pick a channel before sendMessage.',
+        parameters: [
+            p('limit', 'Max channels to return (1-1000). Default 200.', false, 'number'),
+            p('excludeArchived', 'Hide archived channels. Default true.', false, 'boolean'),
+        ],
+    },
+    {
+        operation: 'getChannelHistory',
+        label: 'Get channel history',
+        toolName: 'get_slack_channel_history',
+        description: 'Read recent messages from a Slack channel. Useful for summarization, context retrieval, or finding a message by content before editing/reacting.',
+        parameters: [
+            p('channel', 'Channel id to read from.'),
+            p('limit', 'Max messages to return (1-200). Default 50.', false, 'number'),
+            p('oldest', 'Only messages newer than this timestamp.', false),
+            p('latest', 'Only messages older than this timestamp.', false),
+        ],
+    },
+    {
+        operation: 'getThreadReplies',
+        label: 'Get thread replies',
+        toolName: 'get_slack_thread_replies',
+        description: 'Fetch the replies inside a Slack thread, given the parent message timestamp. Use for summarizing or continuing a thread.',
+        parameters: [
+            p('channel', 'Channel where the thread lives.'),
+            p('ts', 'Timestamp of the thread parent message.'),
+            p('limit', 'Max replies to return (1-1000). Default 100.', false, 'number'),
+        ],
+    },
+    {
+        operation: 'createChannel',
+        label: 'Create channel',
+        toolName: 'create_slack_channel',
+        description: 'Create a new public or private Slack channel. Names must be lowercase, no spaces, max 80 chars. Confirm with the user before creating channels — they are usually long-lived org artifacts.',
+        parameters: [
+            p('name', 'Channel name — lowercase, no spaces, max 80 chars.'),
+            p('isPrivate', 'Create a private channel instead of public. Default false.', false, 'boolean'),
+        ],
+        destructive: true,
+    },
+    {
+        operation: 'inviteToChannel',
+        label: 'Invite to channel',
+        toolName: 'invite_to_slack_channel',
+        description: 'Invite one or more users to a Slack channel by user id. Comma-separated `users` argument.',
+        parameters: [
+            p('channel', 'Channel id to invite users to.'),
+            p('users', 'Comma-separated user ids (U…) to invite.'),
+        ],
+    },
+    // ── Reactions ────────────────────────────────────────────────────
+    {
+        operation: 'addReaction',
+        label: 'Add reaction',
+        toolName: 'add_slack_reaction',
+        description: 'Add an emoji reaction to a Slack message as the bot. Use the emoji NAME without colons (e.g. `thumbsup`, `white_check_mark`, `eyes`).',
+        parameters: [
+            p('channel', 'Channel where the message lives.'),
+            p('ts', 'Timestamp of the message to react to.'),
+            p('name', 'Emoji name without colons.'),
+        ],
+    },
+    {
+        operation: 'removeReaction',
+        label: 'Remove reaction',
+        toolName: 'remove_slack_reaction',
+        description: "Remove the bot's own emoji reaction from a Slack message. Cannot remove other users' reactions.",
+        parameters: [
+            p('channel', 'Channel where the message lives.'),
+            p('ts', 'Timestamp of the message.'),
+            p('name', 'Emoji name without colons.'),
+        ],
+    },
+    // ── Users ────────────────────────────────────────────────────────
+    {
+        operation: 'listUsers',
+        label: 'List users',
+        toolName: 'list_slack_users',
+        description: 'List human members of the Slack workspace. Returns id, name, real_name, email, avatarUrl. Excludes deleted users + bots by default.',
+        parameters: [
+            p('limit', 'Max users to return (1-1000). Default 200.', false, 'number'),
+            p('includeDeleted', 'Include deactivated users. Default false.', false, 'boolean'),
+            p('includeBots', 'Include bot users + app users. Default false.', false, 'boolean'),
+        ],
+    },
+    {
+        operation: 'getUserInfo',
+        label: 'Get user info',
+        toolName: 'get_slack_user_info',
+        description: 'Fetch a Slack user profile (real_name, email, timezone, status, avatar). Use BEFORE sendEphemeral to confirm the user id is valid.',
+        parameters: [p('user', 'User id (U…) to look up.')],
+    },
+    // ── Files ────────────────────────────────────────────────────────
+    {
+        operation: 'uploadFile',
+        label: 'Upload file',
+        toolName: 'upload_slack_file',
+        description: 'Upload a file to Slack and optionally share it in a channel. Provide either a public `url` to fetch or inline `contentBase64` for small payloads. Optionally attach to a thread via `threadTs`.',
+        parameters: [
+            p('url', 'Public URL or HW _file.downloadUrl that HW will fetch and re-upload.', false),
+            p('contentBase64', 'Inline base64 file content (alternative to url).', false),
+            p('filename', 'Display name in Slack. Auto-derived from URL when omitted.', false),
+            p('channel', 'Channel id to share the uploaded file in.', false),
+            p('title', 'Title shown above the file.', false),
+            p('initialComment', 'Message Slack posts together with the file.', false),
+            p('threadTs', 'Thread to attach the file to.', false),
+        ],
+    },
+];
+exports.SLACK_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(exports.SLACK_TOOLKIT_SPECS.map((s) => [s.toolName, s]));

package/package.json

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