@hostwebhook/node-types 1.64.0 → 1.66.0

package/dist/connections.js

@@ -80,6 +80,7 @@ exports.NODE_CONNECTIONS = {
     mailchimpAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     shopifyAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     githubAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
+    jiraAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     googleContactsAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     googleAnalyticsAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     notionAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },

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/dispatch.js

@@ -55,6 +55,7 @@ exports.NODE_DISPATCH = {
     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' },

package/dist/index.d.ts

@@ -24,14 +24,20 @@ 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';
 export type { ShopifyOperation, ShopifyTaggableResource, ShopifySearchableResource, ShopifyParamSpec, ShopifyOperationSpec, } from './shopify-operations';
 export { GITHUB_OPERATIONS, GITHUB_OPERATION_SPECS, GITHUB_DROPDOWN_OPERATIONS, GITHUB_ITERABLE_OPERATIONS, isGithubOperation, } from './github-operations';
 export type { GithubOperation, GithubParamType, GithubParamSpec, GithubOperationSpec, } from './github-operations';
+export { JIRA_OPERATIONS, JIRA_OPERATION_SPECS, JIRA_DROPDOWN_OPERATIONS, JIRA_ITERABLE_OPERATIONS, isJiraOperation, } from './jira-operations';
+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.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 = 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.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 = 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; } });
@@ -104,10 +111,21 @@ Object.defineProperty(exports, "GITHUB_OPERATION_SPECS", { enumerable: true, get
 Object.defineProperty(exports, "GITHUB_DROPDOWN_OPERATIONS", { enumerable: true, get: function () { return github_operations_1.GITHUB_DROPDOWN_OPERATIONS; } });
 Object.defineProperty(exports, "GITHUB_ITERABLE_OPERATIONS", { enumerable: true, get: function () { return github_operations_1.GITHUB_ITERABLE_OPERATIONS; } });
 Object.defineProperty(exports, "isGithubOperation", { enumerable: true, get: function () { return github_operations_1.isGithubOperation; } });
+var jira_operations_1 = require("./jira-operations");
+Object.defineProperty(exports, "JIRA_OPERATIONS", { enumerable: true, get: function () { return jira_operations_1.JIRA_OPERATIONS; } });
+Object.defineProperty(exports, "JIRA_OPERATION_SPECS", { enumerable: true, get: function () { return jira_operations_1.JIRA_OPERATION_SPECS; } });
+Object.defineProperty(exports, "JIRA_DROPDOWN_OPERATIONS", { enumerable: true, get: function () { return jira_operations_1.JIRA_DROPDOWN_OPERATIONS; } });
+Object.defineProperty(exports, "JIRA_ITERABLE_OPERATIONS", { enumerable: true, get: function () { return jira_operations_1.JIRA_ITERABLE_OPERATIONS; } });
+Object.defineProperty(exports, "isJiraOperation", { enumerable: true, get: function () { return jira_operations_1.isJiraOperation; } });
 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/jira-operations.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Las operaciones del nodo `jiraAction` — la lista que comparten la api, el
+ * dashboard y el broker.
+ *
+ * Mismo patrón que `github-operations.ts` y `shopify-operations.ts`.
+ *
+ * ── Contra qué está escrito ──
+ *
+ * Jira Cloud, **REST API v3**, servida en
+ * `https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/…`. El `cloudId` sale
+ * de la credencial `oauth2_atlassian`, que ya existe: la montó el trigger de
+ * Jira y aquí se reutiliza entera.
+ *
+ * El permiso que hace falta para escribir es **`write:jira-work`**. Se añadió a
+ * los de por defecto en api#384; toda credencial anterior a eso es de sólo
+ * lectura hasta que su dueño la reconecte, y el síntoma es un 403 al ejecutar,
+ * no un fallo al guardar.
+ *
+ * ── La decisión que ordena todo lo demás: ADF ──
+ *
+ * En la v3, `description` y el `body` de un comentario **no son texto**: son
+ * Atlassian Document Format, un árbol JSON de nodos tipados. Mandar una cadena
+ * da 400.
+ *
+ * La salida fácil sería escribir con la v2, que sí acepta texto plano y sigue
+ * soportada. No se hace, y el motivo está escrito en nuestro propio repositorio
+ * desde antes de este nodo: `jira-watch.service.ts` excluye `description` al
+ * hidratar campos y explica por qué — *"la REST devuelve ADF —un objeto— pero
+ * el webhook manda texto plano; mezclar formas rompería las plantillas de
+ * abajo, que esperan cadenas"*.
+ *
+ * O sea: si este nodo leyera con una versión y escribiera con otra,
+ * `{{payload.fields.description}}` significaría una cosa cuando el flujo lo
+ * dispara un trigger de Jira y otra cuando lo consulta este nodo. Por eso:
+ *
+ *   - **Todo en v3**, para leer y para escribir.
+ *   - Al escribir, el texto del usuario se envuelve en ADF.
+ *   - Al leer, el ADF se aplana a texto, y el árbol original viaja en una clave
+ *     hermana para quien lo necesite.
+ *   - `bodyFormat` deja pegar ADF crudo a quien quiera tablas o paneles.
+ *
+ * ── La otra trampa: la búsqueda cambió de sitio ──
+ *
+ * `GET/POST /rest/api/3/search` está **deprecado**. El sustituto es
+ * `POST /rest/api/3/search/jql`, y no es un renombre: pagina con
+ * `nextPageToken` en vez de `startAt`, **no devuelve `total`** (para contar hay
+ * `/search/approximate-count`) y los campos hay que pedirlos explícitamente.
+ * Casi todo ejemplo que hay por internet usa el endpoint muerto.
+ *
+ * ── Lo que NO es una operación ──
+ *
+ * Listar proyectos, tipos de incidencia, transiciones, estados o usuarios
+ * asignables **no** son operaciones: son endpoints del controlador que alimentan
+ * los selectores, como Drive alimenta su selector de ficheros. Una operación
+ * existe para producir payload en una corrida; esto otro es para rellenar el
+ * formulario. Mezclarlos llena el desplegable de cosas que nadie quiere
+ * ejecutar.
+ *
+ * ── Decisiones propias de Jira ──
+ *
+ *   - El proyecto y el tipo de incidencia se ELIGEN de una lista viva. Un
+ *     `issuetype` se identifica por un id numérico que nadie sabe de memoria.
+ *   - **Las transiciones no son una lista fija.** Dependen del flujo de trabajo
+ *     Y del estado actual de la incidencia, así que el selector las pide para
+ *     esa incidencia concreta. Ofrecer una lista global sería ofrecer
+ *     transiciones que fallan al ejecutarse.
+ *   - Los campos personalizados van en JSON crudo. Cada tipo tiene su forma
+ *     (`select`, `date`, `relation`, usuario…) y fingir que caben en tres
+ *     campos genéricos produce un 400 que no nombra el campo.
+ *   - Ninguna operación declarada sin implementar: el enum ES el contrato de la
+ *     pantalla, y una operación declarada se pinta en el desplegable y falla al
+ *     ejecutarse.
+ */
+export declare const JIRA_OPERATIONS: readonly ["createIssue", "getIssue", "updateIssue", "deleteIssue", "assignIssue", "transitionIssue", "addComment", "getComments", "addAttachment", "addWorklog", "linkIssues", "searchIssues"];
+export type JiraOperation = (typeof JIRA_OPERATIONS)[number];
+/** Type guard — para validar entrada no fiable (DTOs, tool calls). */
+export declare function isJiraOperation(value: unknown): value is JiraOperation;
+/**
+ * Las operaciones que devuelven un ARRAY y por tanto obligan a marcar
+ * `_meta.iterable` en `getOutputPayload`.
+ *
+ * Vive aquí y no sólo en la api porque olvidarlo no falla al compilar: falla
+ * en producción, callado, con el nodo de abajo recibiendo el sobre entero en
+ * vez de un elemento y el PayloadViewer pintando rutas con corchetes que nadie
+ * puede usar.
+ */
+export declare const JIRA_ITERABLE_OPERATIONS: readonly JiraOperation[];
+export type JiraParamType = 
+/** Selector vivo de proyectos que alcanza la credencial. Guarda la CLAVE
+ *  (`ACME`), no el id: es lo que se lee en las URLs y en el JQL. */
+'jiraProject'
+/** Selector de tipos de incidencia del proyecto elegido. Guarda el id, que
+ *  es lo que pide la API — el nombre no es único entre proyectos. */
+ | 'jiraIssueType'
+/** La incidencia sobre la que se actúa. Se escribe o se resuelve de una
+ *  plantilla: `{{payload.issueKey}}` es el caso del 90%. */
+ | 'jiraIssueKey'
+/** Transiciones legales para la incidencia elegida. Depende del flujo de
+ *  trabajo Y del estado actual, así que se piden en el momento. */
+ | 'jiraTransition'
+/** Usuarios asignables en el proyecto elegido. Guarda el `accountId`. */
+ | 'jiraUser'
+/** Tipos de enlace entre incidencias (`Blocks`, `Relates`…). */
+ | 'jiraLinkType'
+/** Texto con autocompletado de `{{payload.*}}`. */
+ | 'template'
+/** Área de texto larga, también con autocompletado. */
+ | 'textarea'
+/** `<select>` normal; las etiquetas no son los valores, `options` obliga. */
+ | 'select' | 'number'
+/**
+ * `<select>` de `''` / `'true'` / `'false'` que se guarda como BOOLEANO, o
+ * no se guarda si es `''`. "— sin tocar —" tiene que significar que la clave
+ * no viaja, no que viaja en `false`.
+ */
+ | 'booleanSelect'
+/** Área de texto para JSON crudo (campos personalizados, ADF). */
+ | 'json';
+export interface JiraParamSpec {
+    /** La clave de `operationConfig`. Es lo que lee la api, no un nombre de UI. */
+    name: string;
+    label: string;
+    type: JiraParamType;
+    required?: boolean;
+    /** Ayuda bajo el campo. Texto plano: el paquete no lleva React. */
+    description?: string;
+    placeholder?: string;
+    /** Prerrellenado cuando la config guardada no trae valor para esta clave. */
+    default?: string | number;
+    /** Obligatorio en `select` y `booleanSelect` — etiqueta y valor difieren. */
+    options?: ReadonlyArray<{
+        value: string;
+        label: string;
+    }>;
+    min?: number;
+    max?: number;
+    /** Se pinta en la pestaña "Advanced" en vez de en "Config". */
+    advanced?: boolean;
+    /** Sólo visible cuando un campo hermano vale uno de estos. */
+    showWhen?: {
+        field: string;
+        in: ReadonlyArray<string>;
+    };
+}
+export interface JiraOperationSpec {
+    /** Etiqueta de la fila en el desplegable de operación. */
+    label: string;
+    /** Sub-línea bajo la etiqueta. */
+    description: string;
+    /** Ruta a la que mapea, tal cual, para poder cotejarla con los docs. */
+    apiRoute: string;
+    /** Esquema de parámetros. El orden ES el orden en pantalla. */
+    params: JiraParamSpec[];
+}
+export declare const JIRA_OPERATION_SPECS: Record<JiraOperation, JiraOperationSpec>;
+/**
+ * Lo que se ofrece en el desplegable de operación.
+ *
+ * Hoy son todas. Existe como constante aparte —y no como alias de
+ * `JIRA_OPERATIONS`— porque es el punto donde otros nodos han necesitado
+ * esconder una operación sin sacarla del enum: retirarla del enum rompe las que
+ * ya estaban guardadas en la base de datos.
+ */
+export declare const JIRA_DROPDOWN_OPERATIONS: readonly JiraOperation[];