n8n 2.28.3 → 2.29.0

package/dist/modules/agents/integrations/integration-tool-definitions.js

@@ -0,0 +1,231 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_INTEGRATION_ACTION_TOOL_DEFINITIONS = exports.DEFAULT_INTEGRATION_CONTEXT_TOOL_DEFINITIONS = exports.GENERIC_ACTION_TOOL_DEFINITIONS = exports.GENERIC_CONTEXT_QUERY_TOOL_DEFINITIONS = exports.messageSchema = void 0;
+exports.resolveIntegrationContextQueryDefinitions = resolveIntegrationContextQueryDefinitions;
+exports.resolveIntegrationActionDefinitions = resolveIntegrationActionDefinitions;
+const api_types_1 = require("@n8n/api-types");
+const zod_1 = require("zod");
+const linear_tool_definitions_1 = require("./platforms/linear-tool-definitions");
+const slack_tool_definitions_1 = require("./platforms/slack-tool-definitions");
+const _assertRichCardButtonStylesAreChatSdkStyles = true;
+void _assertRichCardButtonStylesAreChatSdkStyles;
+exports.messageSchema = api_types_1.richMessageSchema;
+const noInputSchema = zod_1.z.object({}).strict();
+const platformUserIdSchema = zod_1.z
+    .string()
+    .min(1)
+    .describe('Platform user ID, for example a Slack U... ID or Linear user UUID. Do not pass a name.');
+const platformChannelIdSchema = zod_1.z
+    .string()
+    .min(1)
+    .describe('Platform channel ID, for example a Slack C... channel ID. Do not pass a name.');
+const searchLimitSchema = zod_1.z
+    .number()
+    .int()
+    .min(1)
+    .max(50)
+    .optional()
+    .describe('Maximum number of matches to return. Defaults to 10.');
+const searchCursorSchema = zod_1.z
+    .string()
+    .min(1)
+    .optional()
+    .describe('Opaque pagination cursor returned as `nextCursor` by a previous call. Pass to fetch the next page of matches.');
+const getCurrentMessageContextInputSchema = zod_1.z.object({
+    query: zod_1.z.literal('get_current_message_context'),
+    input: noInputSchema,
+});
+const getCurrentSubjectInputSchema = zod_1.z.object({
+    query: zod_1.z.literal('get_current_subject'),
+    input: noInputSchema,
+});
+const getCurrentUserInputSchema = zod_1.z.object({
+    query: zod_1.z.literal('get_current_user'),
+    input: noInputSchema,
+});
+const getCurrentChannelInfoInputSchema = zod_1.z.object({
+    query: zod_1.z.literal('get_current_channel_info'),
+    input: noInputSchema,
+});
+const getUserInputSchema = zod_1.z.object({
+    query: zod_1.z.literal('get_user'),
+    input: zod_1.z
+        .object({
+        userId: platformUserIdSchema,
+    })
+        .strict(),
+});
+const getChannelInfoInputSchema = zod_1.z.object({
+    query: zod_1.z.literal('get_channel_info'),
+    input: zod_1.z
+        .object({
+        channelId: platformChannelIdSchema,
+    })
+        .strict(),
+});
+const searchUsersInputSchema = zod_1.z.object({
+    query: zod_1.z.literal('search_users'),
+    input: zod_1.z
+        .object({
+        query: zod_1.z
+            .string()
+            .min(1)
+            .optional()
+            .describe('User name, display name, handle, user ID, or email fragment to search for.'),
+        email: zod_1.z.string().min(1).optional().describe('Exact email address to look up when known.'),
+        limit: searchLimitSchema,
+        cursor: searchCursorSchema,
+        includeBots: zod_1.z
+            .boolean()
+            .optional()
+            .describe('Whether to include bot users. Defaults to false.'),
+        includeDeleted: zod_1.z
+            .boolean()
+            .optional()
+            .describe('Whether to include deleted/deactivated users. Defaults to false.'),
+    })
+        .strict()
+        .refine((input) => input.query !== undefined || input.email !== undefined, {
+        message: 'Provide query or email.',
+    }),
+});
+const searchChannelsInputSchema = zod_1.z.object({
+    query: zod_1.z.literal('search_channels'),
+    input: zod_1.z
+        .object({
+        query: zod_1.z.string().min(1).describe('Channel name, channel ID, or #channel search term.'),
+        limit: searchLimitSchema,
+        cursor: searchCursorSchema,
+        includeArchived: zod_1.z
+            .boolean()
+            .optional()
+            .describe('Whether to include archived channels. Defaults to false.'),
+    })
+        .strict(),
+});
+const respondActionInputSchema = zod_1.z.object({
+    action: zod_1.z.literal('respond'),
+    input: zod_1.z
+        .object({
+        message: exports.messageSchema,
+    })
+        .strict(),
+});
+const sendDmActionInputSchema = zod_1.z.object({
+    action: zod_1.z.literal('send_dm'),
+    input: zod_1.z
+        .object({
+        userId: platformUserIdSchema,
+        message: exports.messageSchema,
+    })
+        .strict(),
+});
+const sendChannelMessageActionInputSchema = zod_1.z.object({
+    action: zod_1.z.literal('send_channel_message'),
+    input: zod_1.z
+        .object({
+        channelId: platformChannelIdSchema,
+        message: exports.messageSchema,
+    })
+        .strict(),
+});
+exports.GENERIC_CONTEXT_QUERY_TOOL_DEFINITIONS = [
+    {
+        name: 'get_current_message_context',
+        inputSchema: getCurrentMessageContextInputSchema,
+        description: 'get_current_message_context: no input. Returns the latest place this agent communicated in this thread. For Slack, context.agentUserId is the bot user ID for this agent; do not look it up as another user.',
+    },
+    {
+        name: 'get_current_subject',
+        inputSchema: getCurrentSubjectInputSchema,
+        description: 'get_current_subject: no input. Returns the subject of the latest message context, such as a Linear issue, when available.',
+    },
+    {
+        name: 'get_current_user',
+        inputSchema: getCurrentUserInputSchema,
+        description: 'get_current_user: no input. Returns the latest user who interacted in the current message context.',
+    },
+    {
+        name: 'get_current_channel_info',
+        inputSchema: getCurrentChannelInfoInputSchema,
+        description: 'get_current_channel_info: no input. Returns metadata for the latest channel in the current message context.',
+    },
+    {
+        name: 'get_user',
+        inputSchema: getUserInputSchema,
+        description: 'get_user: input.userId is required. Use a platform user ID such as a Slack U... ID or Linear user UUID, not a name, handle, or email.',
+    },
+    {
+        name: 'get_channel_info',
+        inputSchema: getChannelInfoInputSchema,
+        description: 'get_channel_info: input.channelId is required. Use a platform channel ID such as a Slack C... ID, not a channel name.',
+    },
+    {
+        name: 'search_users',
+        inputSchema: searchUsersInputSchema,
+        description: 'search_users: input.query or input.email is required. Returns matching platform user IDs for names, handles, or emails. When the response includes nextCursor, pass it back as input.cursor to fetch the next page.',
+    },
+    {
+        name: 'search_channels',
+        inputSchema: searchChannelsInputSchema,
+        description: 'search_channels: input.query is required. Returns matching platform channel IDs for channel names or IDs. When the response includes nextCursor, pass it back as input.cursor to fetch the next page.',
+    },
+];
+exports.GENERIC_ACTION_TOOL_DEFINITIONS = [
+    {
+        name: 'respond',
+        inputSchema: respondActionInputSchema,
+        description: 'respond: input.message is required. Responds in the latest message context for this integration connection.',
+    },
+    {
+        name: 'send_dm',
+        inputSchema: sendDmActionInputSchema,
+        description: 'send_dm: input.userId and input.message are required. userId must be a platform user ID, not a name, handle, or email.',
+    },
+    {
+        name: 'send_channel_message',
+        inputSchema: sendChannelMessageActionInputSchema,
+        description: 'send_channel_message: input.channelId and input.message are required. channelId must be a platform channel ID, not a channel name.',
+    },
+];
+exports.DEFAULT_INTEGRATION_CONTEXT_TOOL_DEFINITIONS = exports.GENERIC_CONTEXT_QUERY_TOOL_DEFINITIONS;
+exports.DEFAULT_INTEGRATION_ACTION_TOOL_DEFINITIONS = exports.GENERIC_ACTION_TOOL_DEFINITIONS;
+const ALL_CONTEXT_QUERY_TOOL_DEFINITIONS = [
+    ...exports.GENERIC_CONTEXT_QUERY_TOOL_DEFINITIONS,
+    ...linear_tool_definitions_1.LINEAR_CONTEXT_QUERY_TOOL_DEFINITIONS,
+];
+const ALL_ACTION_TOOL_DEFINITIONS = [
+    ...exports.GENERIC_ACTION_TOOL_DEFINITIONS,
+    ...slack_tool_definitions_1.SLACK_ACTION_TOOL_DEFINITIONS,
+    ...linear_tool_definitions_1.LINEAR_ACTION_TOOL_DEFINITIONS,
+];
+const _assertContextQueryDefinitionsAreExhaustive = true;
+const _assertActionDefinitionsAreExhaustive = true;
+void _assertContextQueryDefinitionsAreExhaustive;
+void _assertActionDefinitionsAreExhaustive;
+const contextDefinitionsByName = toDefinitionMap(ALL_CONTEXT_QUERY_TOOL_DEFINITIONS);
+const actionDefinitionsByName = toDefinitionMap(ALL_ACTION_TOOL_DEFINITIONS);
+function resolveIntegrationContextQueryDefinitions(queries) {
+    return queries.map((query) => requireDefinition(contextDefinitionsByName, query));
+}
+function resolveIntegrationActionDefinitions(actions) {
+    return actions.map((action) => requireDefinition(actionDefinitionsByName, action));
+}
+function toDefinitionMap(definitions) {
+    const definitionsByName = new Map();
+    for (const definition of definitions) {
+        if (definitionsByName.has(definition.name)) {
+            throw new Error(`Duplicate integration tool operation definition: ${definition.name}`);
+        }
+        definitionsByName.set(definition.name, definition);
+    }
+    return definitionsByName;
+}
+function requireDefinition(definitionsByName, name) {
+    const definition = definitionsByName.get(name);
+    if (!definition) {
+        throw new Error(`Unknown integration tool operation definition: ${name}`);
+    }
+    return definition;
+}
+//# sourceMappingURL=integration-tool-definitions.js.map

package/dist/modules/agents/integrations/integration-tool-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-tool-definitions.js","sourceRoot":"","sources":["../../../../src/modules/agents/integrations/integration-tool-definitions.ts"],"names":[],"mappings":"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"}

package/dist/modules/agents/integrations/integration-tool-descriptions.d.ts

@@ -0,0 +1,3 @@
+import type { IntegrationToolConnectionDescriptor } from './integration-tool-types';
+export declare function buildContextToolDescription(descriptor: IntegrationToolConnectionDescriptor): string;
+export declare function buildActionToolDescription(descriptor: IntegrationToolConnectionDescriptor): string;

package/dist/modules/agents/integrations/integration-tool-descriptions.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildContextToolDescription = buildContextToolDescription;
+exports.buildActionToolDescription = buildActionToolDescription;
+const integration_tool_schema_1 = require("./integration-tool-schema");
+function buildContextToolDescription(descriptor) {
+    return [
+        `Read context from the ${descriptor.integration.type} integration connection.`,
+        `Available queries: ${descriptor.contextQueries.join(', ')}.`,
+        ...(descriptor.contextToolGuidance ?? []),
+        'Query inputs:',
+        ...descriptor.contextToolDefinitions.map((definition) => `- ${definition.description}`),
+        `Batch form: pass queries as an array of up to ${integration_tool_schema_1.MAX_BATCH_OPERATIONS} { query, input } objects to fetch multiple pieces of context in one tool call.`,
+        'Use this tool for read-only lookup before choosing an action target.',
+    ].join('\n\n');
+}
+function buildActionToolDescription(descriptor) {
+    return [
+        `Take actions in the ${descriptor.integration.type} integration connection.`,
+        `Available actions: ${descriptor.actions.join(', ')}.`,
+        ...(descriptor.actionToolGuidance ?? []),
+        'Action inputs:',
+        ...descriptor.actionToolDefinitions.map((definition) => `- ${definition.description}`),
+        `Batch form: pass actions as an array of up to ${integration_tool_schema_1.MAX_BATCH_OPERATIONS} { action, input } objects. Batch actions run sequentially and cannot include cards that wait for a user response.`,
+        'respond uses the latest message context for this integration connection.',
+        'Use message.card for cards, images, key-value summaries, and feedback requests. Include components such as section, fields, image, divider, button, select, or radio_select.',
+        'For fields components, use { type: "fields", fields: [{ label: "Account", value: "Acme" }] }. The key items is also accepted as a fields alias.',
+        'For button components, use { type: "button", label: "Approve", value: "approve" }. If label is omitted, text is used as the button label.',
+        'For radio-style choices, use { type: "radio_select", label: "Next step", options: [{ label: "Approve", value: "approve" }] }.',
+        'Use only the generic shape: message.text plus optional message.card. Do not provide platform-native component payloads, formatted text objects, or attachments; rendering is handled internally.',
+        ...buildGenericCardGuidance(),
+        'Interactive message.card components (button, select, or radio_select) send the message first, then suspend this action until the user responds.',
+        'Display-only message.card components without buttons/selects render the card and let the agent continue immediately.',
+    ].join('\n\n');
+}
+function buildGenericCardGuidance() {
+    return [
+        'Generic card examples:',
+        [
+            'Radio choice card:',
+            '```json',
+            JSON.stringify({
+                action: 'respond',
+                input: {
+                    message: {
+                        text: 'Acme Executive Briefing — Next Steps',
+                        card: {
+                            title: 'Acme Corporation — Executive Briefing Next Steps',
+                            components: [
+                                {
+                                    type: 'section',
+                                    text: '30X Expansion Briefing ($3.75M) — Internal owner: Paul G | Briefing contact: Mike D\n\nWhat should happen next?',
+                                },
+                                { type: 'divider' },
+                                {
+                                    type: 'radio_select',
+                                    id: 'next_step_selection',
+                                    label: 'Next step',
+                                    options: [
+                                        {
+                                            label: 'Schedule exec briefing prep call with Paul G',
+                                            value: 'schedule_prep_call',
+                                        },
+                                        {
+                                            label: 'Draft briefing agenda doc for Mike D',
+                                            value: 'draft_briefing_doc',
+                                        },
+                                    ],
+                                },
+                            ],
+                        },
+                    },
+                },
+            }, null, 2),
+            '```',
+        ].join('\n'),
+        [
+            'Button card:',
+            '```json',
+            JSON.stringify({
+                action: 'respond',
+                input: {
+                    message: {
+                        text: 'Approve or revise the briefing draft',
+                        card: {
+                            components: [
+                                { type: 'section', text: 'Review the briefing draft.' },
+                                { type: 'button', label: 'Approve', value: 'approve', style: 'primary' },
+                                { type: 'button', label: 'Revise', value: 'revise', style: 'default' },
+                            ],
+                        },
+                    },
+                },
+            }, null, 2),
+            '```',
+        ].join('\n'),
+        'Never send message.blocks, components of type actions, elements arrays, action_id, radio_buttons, or formatted text objects such as { type: "plain_text", text: "..." } or { type: "mrkdwn", text: "..." }.',
+    ];
+}
+//# sourceMappingURL=integration-tool-descriptions.js.map

package/dist/modules/agents/integrations/integration-tool-descriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-tool-descriptions.js","sourceRoot":"","sources":["../../../../src/modules/agents/integrations/integration-tool-descriptions.ts"],"names":[],"mappings":";;AAGA,kEAYC;AAED,gEAoBC;AArCD,uEAAiE;AAGjE,SAAgB,2BAA2B,CAC1C,UAA+C;IAE/C,OAAO;QACN,yBAAyB,UAAU,CAAC,WAAW,CAAC,IAAI,0BAA0B;QAC9E,sBAAsB,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC7D,GAAG,CAAC,UAAU,CAAC,mBAAmB,IAAI,EAAE,CAAC;QACzC,eAAe;QACf,GAAG,UAAU,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,UAAU,CAAC,WAAW,EAAE,CAAC;QACvF,iDAAiD,8CAAoB,iFAAiF;QACtJ,sEAAsE;KACtE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAChB,CAAC;AAED,SAAgB,0BAA0B,CACzC,UAA+C;IAE/C,OAAO;QACN,uBAAuB,UAAU,CAAC,WAAW,CAAC,IAAI,0BAA0B;QAC5E,sBAAsB,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QACtD,GAAG,CAAC,UAAU,CAAC,kBAAkB,IAAI,EAAE,CAAC;QACxC,gBAAgB;QAChB,GAAG,UAAU,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,UAAU,CAAC,WAAW,EAAE,CAAC;QACtF,iDAAiD,8CAAoB,oHAAoH;QACzL,0EAA0E;QAC1E,8KAA8K;QAC9K,iJAAiJ;QACjJ,2IAA2I;QAC3I,+HAA+H;QAC/H,kMAAkM;QAClM,GAAG,wBAAwB,EAAE;QAC7B,iJAAiJ;QACjJ,sHAAsH;KACtH,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,wBAAwB;IAChC,OAAO;QACN,wBAAwB;QACxB;YACC,oBAAoB;YACpB,SAAS;YACT,IAAI,CAAC,SAAS,CACb;gBACC,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE;oBACN,OAAO,EAAE;wBACR,IAAI,EAAE,sCAAsC;wBAC5C,IAAI,EAAE;4BACL,KAAK,EAAE,kDAAkD;4BACzD,UAAU,EAAE;gCACX;oCACC,IAAI,EAAE,SAAS;oCACf,IAAI,EAAE,iHAAiH;iCACvH;gCACD,EAAE,IAAI,EAAE,SAAS,EAAE;gCACnB;oCACC,IAAI,EAAE,cAAc;oCACpB,EAAE,EAAE,qBAAqB;oCACzB,KAAK,EAAE,WAAW;oCAClB,OAAO,EAAE;wCACR;4CACC,KAAK,EAAE,8CAA8C;4CACrD,KAAK,EAAE,oBAAoB;yCAC3B;wCACD;4CACC,KAAK,EAAE,sCAAsC;4CAC7C,KAAK,EAAE,oBAAoB;yCAC3B;qCACD;iCACD;6BACD;yBACD;qBACD;iBACD;aACD,EACD,IAAI,EACJ,CAAC,CACD;YACD,KAAK;SACL,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ;YACC,cAAc;YACd,SAAS;YACT,IAAI,CAAC,SAAS,CACb;gBACC,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE;oBACN,OAAO,EAAE;wBACR,IAAI,EAAE,sCAAsC;wBAC5C,IAAI,EAAE;4BACL,UAAU,EAAE;gCACX,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,4BAA4B,EAAE;gCACvD,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;gCACxE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE;6BACtE;yBACD;qBACD;iBACD;aACD,EACD,IAAI,EACJ,CAAC,CACD;YACD,KAAK;SACL,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,6MAA6M;KAC7M,CAAC;AACH,CAAC"}

package/dist/modules/agents/integrations/integration-tool-execution.d.ts

@@ -0,0 +1,27 @@
+import type { InterruptibleToolContext, ToolContext } from '@n8n/agents';
+import type { IntegrationActionExecutor, IntegrationMessageContext, IntegrationMessageContextStore, IntegrationContextQueryExecutor, IntegrationToolConnectionDescriptor } from './integration-tool-types';
+import type { RawActionToolOperation, RawContextToolOperation } from './integration-tool-schema';
+export declare function executeContextToolOperation(params: {
+    operation: RawContextToolOperation;
+    descriptor: IntegrationToolConnectionDescriptor;
+    messageContextStore: IntegrationMessageContextStore;
+    queryExecutor: IntegrationContextQueryExecutor;
+    persistence: ToolContext['persistence'];
+}): Promise<unknown>;
+export declare function executeActionToolBatch(params: {
+    operations: RawActionToolOperation[];
+    descriptor: IntegrationToolConnectionDescriptor;
+    messageContextStore: IntegrationMessageContextStore;
+    actionExecutor: IntegrationActionExecutor;
+    ctx: ToolContext;
+}): Promise<unknown>;
+export declare function executeActionToolOperation(params: {
+    operation: RawActionToolOperation;
+    descriptor: IntegrationToolConnectionDescriptor;
+    messageContextStore: IntegrationMessageContextStore;
+    actionExecutor: IntegrationActionExecutor;
+    ctx: ToolContext;
+    interruptCtx?: InterruptibleToolContext;
+    currentMessageContext?: IntegrationMessageContext;
+    allowSuspend: boolean;
+}): Promise<unknown>;

package/dist/modules/agents/integrations/integration-tool-execution.js

@@ -0,0 +1,278 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeContextToolOperation = executeContextToolOperation;
+exports.executeActionToolBatch = executeActionToolBatch;
+exports.executeActionToolOperation = executeActionToolOperation;
+const utils_1 = require("@n8n/utils");
+const integration_tool_definitions_1 = require("./integration-tool-definitions");
+const integration_error_codes_1 = require("./integration-error-codes");
+async function executeContextToolOperation(params) {
+    const { operation, descriptor, messageContextStore, queryExecutor, persistence } = params;
+    if (isCurrentContextQuery(operation.query)) {
+        if (!persistence) {
+            return {
+                ok: false,
+                error: {
+                    code: integration_error_codes_1.INTEGRATION_ERROR_CODES.NO_THREAD_CONTEXT,
+                    message: 'There is no current agent thread context.',
+                },
+            };
+        }
+        const context = await messageContextStore.getLatest(persistence.threadId);
+        if (!context || context.integrationConnectionId !== descriptor.integrationConnectionId) {
+            if (operation.query === 'get_current_message_context') {
+                return { ok: true, context: null };
+            }
+            if (operation.query === 'get_current_subject') {
+                return { ok: true, subject: null };
+            }
+            return {
+                ok: false,
+                error: {
+                    code: integration_error_codes_1.INTEGRATION_ERROR_CODES.NO_MESSAGE_CONTEXT,
+                    message: 'There is no current message context for this integration connection.',
+                },
+            };
+        }
+        if (operation.query === 'get_current_message_context') {
+            return { ok: true, context };
+        }
+        if (operation.query === 'get_current_subject') {
+            return { ok: true, subject: context.subject ?? null };
+        }
+        if (operation.query === 'get_current_user') {
+            if (!context.interactingUserId) {
+                return {
+                    ok: false,
+                    error: {
+                        code: integration_error_codes_1.INTEGRATION_ERROR_CODES.NO_INTERACTING_USER_CONTEXT,
+                        message: 'The latest message context does not include an interacting user ID.',
+                    },
+                };
+            }
+            return await queryExecutor.execute({
+                descriptor,
+                query: 'get_user',
+                input: { userId: context.interactingUserId },
+                persistence,
+            });
+        }
+        const channelId = getTargetChannelId(context.target);
+        if (!channelId) {
+            return {
+                ok: false,
+                error: {
+                    code: integration_error_codes_1.INTEGRATION_ERROR_CODES.NO_CHANNEL_CONTEXT,
+                    message: 'The latest message context does not include a channel ID.',
+                },
+            };
+        }
+        return await queryExecutor.execute({
+            descriptor,
+            query: 'get_channel_info',
+            input: { channelId },
+            persistence,
+        });
+    }
+    return await queryExecutor.execute({
+        descriptor,
+        query: operation.query,
+        input: operation.input,
+        persistence,
+    });
+}
+async function executeActionToolBatch(params) {
+    const { operations, descriptor, messageContextStore, actionExecutor, ctx } = params;
+    let currentMessageContext = ctx.persistence !== undefined
+        ? await getOptionalCurrentContext({
+            descriptor,
+            messageContextStore,
+            threadId: ctx.persistence.threadId,
+        })
+        : undefined;
+    const results = [];
+    for (const operation of operations) {
+        const result = await executeActionToolOperation({
+            operation,
+            descriptor,
+            messageContextStore,
+            actionExecutor,
+            ctx,
+            currentMessageContext,
+            allowSuspend: false,
+        });
+        const nextMessageContext = extractSuccessfulMessageContext(result);
+        if (nextMessageContext)
+            currentMessageContext = nextMessageContext;
+        results.push({ action: operation.action, result });
+    }
+    return { ok: true, results };
+}
+async function executeActionToolOperation(params) {
+    const { operation, descriptor, messageContextStore, actionExecutor, ctx, interruptCtx, allowSuspend, } = params;
+    const persistence = ctx.persistence;
+    const message = parseMessage(operation.input.message);
+    const actionInput = message === undefined ? operation.input : { ...operation.input, message };
+    const awaitsResponse = shouldAwaitResponse(message);
+    if (awaitsResponse && !allowSuspend) {
+        return {
+            ok: false,
+            error: {
+                code: integration_error_codes_1.INTEGRATION_ERROR_CODES.ACTION_FAILED,
+                message: 'Batch actions cannot include cards that wait for a user response. Send that action separately.',
+            },
+        };
+    }
+    let currentMessageContext = params.currentMessageContext;
+    if (operation.action === 'respond') {
+        if (!currentMessageContext) {
+            const contextResult = await getRespondContext({
+                descriptor,
+                messageContextStore,
+                persistence,
+            });
+            if (!contextResult.ok) {
+                return contextResult;
+            }
+            currentMessageContext = contextResult.context;
+        }
+    }
+    else if (!currentMessageContext && persistence) {
+        currentMessageContext = await getOptionalCurrentContext({
+            descriptor,
+            messageContextStore,
+            threadId: persistence.threadId,
+        });
+    }
+    const result = await actionExecutor.execute({
+        descriptor,
+        action: operation.action,
+        input: actionInput,
+        awaitResponse: awaitsResponse,
+        runId: ctx.runId,
+        toolCallId: ctx.toolCallId,
+        currentMessageContext,
+    });
+    if (!result.ok)
+        return result;
+    let actionResult = result;
+    if (result.messageContext && persistence) {
+        const messageContext = withPreviousSubject(result.messageContext, currentMessageContext);
+        await messageContextStore.setLatest(persistence.threadId, persistence.resourceId, messageContext);
+        actionResult = { ...result, messageContext };
+    }
+    if (!awaitsResponse)
+        return actionResult;
+    return await interruptCtx?.suspend({
+        type: 'integration_action',
+        action: operation.action,
+        integrationConnectionId: descriptor.integrationConnectionId,
+        messageContext: actionResult.messageContext,
+    });
+}
+function isCurrentContextQuery(query) {
+    return (query === 'get_current_message_context' ||
+        query === 'get_current_subject' ||
+        query === 'get_current_user' ||
+        query === 'get_current_channel_info');
+}
+function parseMessage(value) {
+    const result = integration_tool_definitions_1.messageSchema.safeParse(value);
+    return result.success ? result.data : undefined;
+}
+function shouldAwaitResponse(message) {
+    const card = message?.card;
+    if (card?.awaitResponse === true)
+        return true;
+    return card?.components.some(isInteractiveCardComponent) ?? false;
+}
+function isInteractiveCardComponent(component) {
+    switch (component.type) {
+        case 'button':
+        case 'select':
+        case 'radio_select':
+            return true;
+        case 'section':
+            return component.button !== undefined;
+        default:
+            return false;
+    }
+}
+function withPreviousSubject(context, previousContext) {
+    if (!previousContext)
+        return context;
+    if (context.integrationConnectionId !== previousContext.integrationConnectionId)
+        return context;
+    return {
+        ...context,
+        ...(!context.subject && previousContext.subject ? { subject: previousContext.subject } : {}),
+        ...(!context.agentUserId && previousContext.agentUserId
+            ? { agentUserId: previousContext.agentUserId }
+            : {}),
+    };
+}
+function extractSuccessfulMessageContext(result) {
+    if (!(0, utils_1.isRecord)(result) || result.ok !== true)
+        return undefined;
+    const messageContext = result.messageContext;
+    return isIntegrationMessageContext(messageContext) ? messageContext : undefined;
+}
+function isIntegrationMessageContext(value) {
+    return ((0, utils_1.isRecord)(value) &&
+        typeof value.integrationConnectionId === 'string' &&
+        typeof value.platform === 'string' &&
+        (0, utils_1.isRecord)(value.target) &&
+        (value.agentUserId === undefined || typeof value.agentUserId === 'string') &&
+        typeof value.updatedAt === 'string');
+}
+async function getOptionalCurrentContext(params) {
+    try {
+        const context = await params.messageContextStore.getLatest(params.threadId);
+        if (context?.integrationConnectionId !== params.descriptor.integrationConnectionId) {
+            return undefined;
+        }
+        return context;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function getRespondContext(params) {
+    const { descriptor, messageContextStore, persistence } = params;
+    if (!persistence) {
+        return {
+            ok: false,
+            error: {
+                code: integration_error_codes_1.INTEGRATION_ERROR_CODES.NO_MESSAGE_CONTEXT,
+                message: 'There is no current message context. Use an explicit send action.',
+            },
+        };
+    }
+    const context = await messageContextStore.getLatest(persistence.threadId);
+    if (!context) {
+        return {
+            ok: false,
+            error: {
+                code: integration_error_codes_1.INTEGRATION_ERROR_CODES.NO_MESSAGE_CONTEXT,
+                message: 'There is no current message context. Use an explicit send action.',
+            },
+        };
+    }
+    if (context.integrationConnectionId !== descriptor.integrationConnectionId) {
+        return {
+            ok: false,
+            error: {
+                code: integration_error_codes_1.INTEGRATION_ERROR_CODES.NO_MESSAGE_CONTEXT_FOR_INTEGRATION,
+                message: 'The latest message context belongs to another integration connection.',
+            },
+        };
+    }
+    return { ok: true, context };
+}
+function getTargetChannelId(target) {
+    if (target.type === 'thread' || target.type === 'channel') {
+        return target.channelId;
+    }
+    return undefined;
+}
+//# sourceMappingURL=integration-tool-execution.js.map