n8n 2.28.3 → 2.29.0

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

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

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

@@ -0,0 +1,121 @@
+import { Tool } from '@n8n/agents';
+import type { AgentIntegrationConfig } from '@n8n/api-types';
+import { z } from 'zod';
+import type { IntegrationAction, IntegrationActionDefinition, IntegrationActionExecutor, IntegrationContextQuery, IntegrationContextQueryDefinition, IntegrationContextQueryExecutor, IntegrationMessageContextStore, IntegrationToolConnectionDescriptor, IntegrationToolConnectionSource } from './integration-tool-types';
+export interface IntegrationToolCapabilities {
+    contextQueries?: IntegrationContextQuery[];
+    actions?: IntegrationAction[];
+    contextToolDefinitions?: IntegrationContextQueryDefinition[];
+    actionToolDefinitions?: IntegrationActionDefinition[];
+    contextToolGuidance?: string[];
+    actionToolGuidance?: string[];
+}
+export declare function getIntegrationToolConnectionDescriptors(integrations: AgentIntegrationConfig[], agentId?: string, capabilitiesFor?: (integration: AgentIntegrationConfig) => IntegrationToolCapabilities | undefined): IntegrationToolConnectionDescriptor[];
+export declare function buildIntegrationConnectionId(integration: IntegrationToolConnectionSource): string;
+export declare function createIntegrationContextTool(params: {
+    descriptor: IntegrationToolConnectionDescriptor;
+    messageContextStore: IntegrationMessageContextStore;
+    queryExecutor: IntegrationContextQueryExecutor;
+}): Tool<z.ZodEffects<z.ZodObject<{
+    query: z.ZodOptional<z.ZodEnum<[IntegrationContextQuery, ...IntegrationContextQuery[]]>>;
+    input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    queries: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        query: z.ZodEnum<[IntegrationContextQuery, ...IntegrationContextQuery[]]>;
+        input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strict", z.ZodTypeAny, {
+        query: IntegrationContextQuery;
+        input: Record<string, unknown>;
+    }, {
+        query: IntegrationContextQuery;
+        input: Record<string, unknown>;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    query?: IntegrationContextQuery | undefined;
+    input?: Record<string, unknown> | undefined;
+    queries?: {
+        query: IntegrationContextQuery;
+        input: Record<string, unknown>;
+    }[] | undefined;
+}, {
+    query?: IntegrationContextQuery | undefined;
+    input?: Record<string, unknown> | undefined;
+    queries?: {
+        query: IntegrationContextQuery;
+        input: Record<string, unknown>;
+    }[] | undefined;
+}>, {
+    query?: IntegrationContextQuery | undefined;
+    input?: Record<string, unknown> | undefined;
+    queries?: {
+        query: IntegrationContextQuery;
+        input: Record<string, unknown>;
+    }[] | undefined;
+}, {
+    query?: IntegrationContextQuery | undefined;
+    input?: Record<string, unknown> | undefined;
+    queries?: {
+        query: IntegrationContextQuery;
+        input: Record<string, unknown>;
+    }[] | undefined;
+}>, z.ZodTypeAny, undefined, undefined>;
+export declare function createIntegrationActionTool(params: {
+    descriptor: IntegrationToolConnectionDescriptor;
+    messageContextStore: IntegrationMessageContextStore;
+    actionExecutor: IntegrationActionExecutor;
+}): Tool<z.ZodEffects<z.ZodObject<{
+    action: z.ZodOptional<z.ZodEnum<[IntegrationAction, ...IntegrationAction[]]>>;
+    input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        action: z.ZodEnum<[IntegrationAction, ...IntegrationAction[]]>;
+        input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strict", z.ZodTypeAny, {
+        input: Record<string, unknown>;
+        action: IntegrationAction;
+    }, {
+        input: Record<string, unknown>;
+        action: IntegrationAction;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    input?: Record<string, unknown> | undefined;
+    action?: IntegrationAction | undefined;
+    actions?: {
+        input: Record<string, unknown>;
+        action: IntegrationAction;
+    }[] | undefined;
+}, {
+    input?: Record<string, unknown> | undefined;
+    action?: IntegrationAction | undefined;
+    actions?: {
+        input: Record<string, unknown>;
+        action: IntegrationAction;
+    }[] | undefined;
+}>, {
+    input?: Record<string, unknown> | undefined;
+    action?: IntegrationAction | undefined;
+    actions?: {
+        input: Record<string, unknown>;
+        action: IntegrationAction;
+    }[] | undefined;
+}, {
+    input?: Record<string, unknown> | undefined;
+    action?: IntegrationAction | undefined;
+    actions?: {
+        input: Record<string, unknown>;
+        action: IntegrationAction;
+    }[] | undefined;
+}>, z.ZodTypeAny, z.ZodObject<{
+    type: z.ZodLiteral<"integration_action">;
+    action: z.ZodString;
+    integrationConnectionId: z.ZodString;
+    messageContext: z.ZodUnknown;
+}, "strip", z.ZodTypeAny, {
+    type: "integration_action";
+    action: string;
+    integrationConnectionId: string;
+    messageContext?: unknown;
+}, {
+    type: "integration_action";
+    action: string;
+    integrationConnectionId: string;
+    messageContext?: unknown;
+}>, z.ZodRecord<z.ZodString, z.ZodUnknown>>;

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

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getIntegrationToolConnectionDescriptors = getIntegrationToolConnectionDescriptors;
+exports.buildIntegrationConnectionId = buildIntegrationConnectionId;
+exports.createIntegrationContextTool = createIntegrationContextTool;
+exports.createIntegrationActionTool = createIntegrationActionTool;
+const agents_1 = require("@n8n/agents");
+const zod_1 = require("zod");
+const integration_tool_definitions_1 = require("./integration-tool-definitions");
+const integration_tool_descriptions_1 = require("./integration-tool-descriptions");
+const integration_tool_execution_1 = require("./integration-tool-execution");
+const integration_tool_schema_1 = require("./integration-tool-schema");
+const actionSuspendSchema = zod_1.z.object({
+    type: zod_1.z.literal('integration_action'),
+    action: zod_1.z.string(),
+    integrationConnectionId: zod_1.z.string(),
+    messageContext: zod_1.z.unknown(),
+});
+const actionResumeSchema = zod_1.z.record(zod_1.z.string(), zod_1.z.unknown());
+function getIntegrationToolConnectionDescriptors(integrations, agentId, capabilitiesFor) {
+    const sorted = [...integrations].sort((a, b) => {
+        const byType = a.type.localeCompare(b.type);
+        if (byType !== 0)
+            return byType;
+        return a.credentialId.localeCompare(b.credentialId);
+    });
+    const seenByType = new Map();
+    return sorted.map((integration) => {
+        const seenCount = seenByType.get(integration.type) ?? 0;
+        const nextCount = seenCount + 1;
+        seenByType.set(integration.type, nextCount);
+        const suffix = nextCount === 1 ? '' : `_${nextCount}`;
+        const baseName = `${integration.type}${suffix}`;
+        const capabilities = capabilitiesFor?.(integration);
+        const contextToolDefinitions = getContextToolDefinitions(capabilities);
+        const actionToolDefinitions = getActionToolDefinitions(capabilities);
+        return {
+            agentId,
+            integration,
+            integrationConnectionId: buildIntegrationConnectionId(integration),
+            contextToolName: `${baseName}_context`,
+            actionToolName: `${baseName}_action`,
+            contextQueries: contextToolDefinitions.map((definition) => definition.name),
+            actions: actionToolDefinitions.map((definition) => definition.name),
+            contextToolDefinitions,
+            actionToolDefinitions,
+            contextToolGuidance: capabilities?.contextToolGuidance,
+            actionToolGuidance: capabilities?.actionToolGuidance,
+        };
+    });
+}
+function buildIntegrationConnectionId(integration) {
+    return integration.credentialId === undefined
+        ? integration.type
+        : `${integration.type}:${integration.credentialId}`;
+}
+function createIntegrationContextTool(params) {
+    const { descriptor, messageContextStore, queryExecutor } = params;
+    return new agents_1.Tool(descriptor.contextToolName)
+        .description((0, integration_tool_descriptions_1.buildContextToolDescription)(descriptor))
+        .input((0, integration_tool_schema_1.buildContextInputSchema)(descriptor.contextToolDefinitions))
+        .handler(async (input, ctx) => {
+        const toolInput = input;
+        if (toolInput.queries !== undefined) {
+            const results = await Promise.all(toolInput.queries.map(async (operation) => ({
+                query: operation.query,
+                result: await (0, integration_tool_execution_1.executeContextToolOperation)({
+                    operation,
+                    descriptor,
+                    messageContextStore,
+                    queryExecutor,
+                    persistence: ctx.persistence,
+                }),
+            })));
+            return { ok: true, results };
+        }
+        return await (0, integration_tool_execution_1.executeContextToolOperation)({
+            operation: (0, integration_tool_schema_1.toSingleContextOperation)(toolInput),
+            descriptor,
+            messageContextStore,
+            queryExecutor,
+            persistence: ctx.persistence,
+        });
+    });
+}
+function createIntegrationActionTool(params) {
+    const { descriptor, messageContextStore, actionExecutor } = params;
+    return new agents_1.Tool(descriptor.actionToolName)
+        .description((0, integration_tool_descriptions_1.buildActionToolDescription)(descriptor))
+        .input((0, integration_tool_schema_1.buildActionInputSchema)(descriptor.actionToolDefinitions))
+        .suspend(actionSuspendSchema)
+        .resume(actionResumeSchema)
+        .handler(async (input, ctx) => {
+        if (ctx.resumeData) {
+            return ctx.resumeData;
+        }
+        const interruptCtx = ctx;
+        const toolInput = input;
+        if (toolInput.actions !== undefined) {
+            return await (0, integration_tool_execution_1.executeActionToolBatch)({
+                operations: toolInput.actions,
+                descriptor,
+                messageContextStore,
+                actionExecutor,
+                ctx,
+            });
+        }
+        return await (0, integration_tool_execution_1.executeActionToolOperation)({
+            operation: (0, integration_tool_schema_1.toSingleActionOperation)(toolInput),
+            descriptor,
+            messageContextStore,
+            actionExecutor,
+            ctx,
+            interruptCtx,
+            allowSuspend: true,
+        });
+    });
+}
+function getContextToolDefinitions(capabilities) {
+    if (capabilities?.contextToolDefinitions)
+        return [...capabilities.contextToolDefinitions];
+    if (capabilities?.contextQueries)
+        return (0, integration_tool_definitions_1.resolveIntegrationContextQueryDefinitions)(capabilities.contextQueries);
+    return [...integration_tool_definitions_1.DEFAULT_INTEGRATION_CONTEXT_TOOL_DEFINITIONS];
+}
+function getActionToolDefinitions(capabilities) {
+    if (capabilities?.actionToolDefinitions)
+        return [...capabilities.actionToolDefinitions];
+    if (capabilities?.actions)
+        return (0, integration_tool_definitions_1.resolveIntegrationActionDefinitions)(capabilities.actions);
+    return [...integration_tool_definitions_1.DEFAULT_INTEGRATION_ACTION_TOOL_DEFINITIONS];
+}
+//# sourceMappingURL=integration-tool-factory.js.map

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

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

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

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import type { IntegrationAction, IntegrationActionDefinition, IntegrationContextQuery, IntegrationContextQueryDefinition } from './integration-tool-types';
+export interface RawContextToolOperation {
+    query: IntegrationContextQuery;
+    input: Record<string, unknown>;
+}
+export type RawContextToolInput = {
+    query?: IntegrationContextQuery;
+    input?: Record<string, unknown>;
+    queries?: RawContextToolOperation[];
+};
+export interface RawActionToolOperation {
+    action: IntegrationAction;
+    input: Record<string, unknown>;
+}
+export type RawActionToolInput = {
+    action?: IntegrationAction;
+    input?: Record<string, unknown>;
+    actions?: RawActionToolOperation[];
+};
+export declare const MAX_BATCH_OPERATIONS = 20;
+export declare function buildContextInputSchema(definitions: IntegrationContextQueryDefinition[]): z.ZodEffects<z.ZodObject<{
+    query: z.ZodOptional<z.ZodEnum<[IntegrationContextQuery, ...IntegrationContextQuery[]]>>;
+    input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    queries: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        query: z.ZodEnum<[IntegrationContextQuery, ...IntegrationContextQuery[]]>;
+        input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strict", z.ZodTypeAny, {
+        query: IntegrationContextQuery;
+        input: Record<string, unknown>;
+    }, {
+        query: IntegrationContextQuery;
+        input: Record<string, unknown>;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    query?: IntegrationContextQuery | undefined;
+    input?: Record<string, unknown> | undefined;
+    queries?: {
+        query: IntegrationContextQuery;
+        input: Record<string, unknown>;
+    }[] | undefined;
+}, {
+    query?: IntegrationContextQuery | undefined;
+    input?: Record<string, unknown> | undefined;
+    queries?: {
+        query: IntegrationContextQuery;
+        input: Record<string, unknown>;
+    }[] | undefined;
+}>, {
+    query?: IntegrationContextQuery | undefined;
+    input?: Record<string, unknown> | undefined;
+    queries?: {
+        query: IntegrationContextQuery;
+        input: Record<string, unknown>;
+    }[] | undefined;
+}, {
+    query?: IntegrationContextQuery | undefined;
+    input?: Record<string, unknown> | undefined;
+    queries?: {
+        query: IntegrationContextQuery;
+        input: Record<string, unknown>;
+    }[] | undefined;
+}>;
+export declare function buildActionInputSchema(definitions: IntegrationActionDefinition[]): z.ZodEffects<z.ZodObject<{
+    action: z.ZodOptional<z.ZodEnum<[IntegrationAction, ...IntegrationAction[]]>>;
+    input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        action: z.ZodEnum<[IntegrationAction, ...IntegrationAction[]]>;
+        input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strict", z.ZodTypeAny, {
+        input: Record<string, unknown>;
+        action: IntegrationAction;
+    }, {
+        input: Record<string, unknown>;
+        action: IntegrationAction;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    input?: Record<string, unknown> | undefined;
+    action?: IntegrationAction | undefined;
+    actions?: {
+        input: Record<string, unknown>;
+        action: IntegrationAction;
+    }[] | undefined;
+}, {
+    input?: Record<string, unknown> | undefined;
+    action?: IntegrationAction | undefined;
+    actions?: {
+        input: Record<string, unknown>;
+        action: IntegrationAction;
+    }[] | undefined;
+}>, {
+    input?: Record<string, unknown> | undefined;
+    action?: IntegrationAction | undefined;
+    actions?: {
+        input: Record<string, unknown>;
+        action: IntegrationAction;
+    }[] | undefined;
+}, {
+    input?: Record<string, unknown> | undefined;
+    action?: IntegrationAction | undefined;
+    actions?: {
+        input: Record<string, unknown>;
+        action: IntegrationAction;
+    }[] | undefined;
+}>;
+export declare function toSingleContextOperation(input: RawContextToolInput): RawContextToolOperation;
+export declare function toSingleActionOperation(input: RawActionToolInput): RawActionToolOperation;

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

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_BATCH_OPERATIONS = void 0;
+exports.buildContextInputSchema = buildContextInputSchema;
+exports.buildActionInputSchema = buildActionInputSchema;
+exports.toSingleContextOperation = toSingleContextOperation;
+exports.toSingleActionOperation = toSingleActionOperation;
+const zod_1 = require("zod");
+exports.MAX_BATCH_OPERATIONS = 20;
+function buildContextInputSchema(definitions) {
+    const definitionsByName = toDefinitionMap(definitions);
+    const querySchema = zod_1.z.enum(toZodEnumValues(definitions.map((definition) => definition.name)));
+    const operationSchema = zod_1.z
+        .object({
+        query: querySchema,
+        input: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+    })
+        .strict();
+    return zod_1.z
+        .object({
+        query: querySchema.optional(),
+        input: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+        queries: zod_1.z.array(operationSchema).min(1).max(exports.MAX_BATCH_OPERATIONS).optional(),
+    })
+        .strict()
+        .superRefine((input, ctx) => {
+        if (input.queries !== undefined) {
+            if (input.query !== undefined || input.input !== undefined) {
+                ctx.addIssue({
+                    code: zod_1.z.ZodIssueCode.custom,
+                    message: 'Provide either query/input or queries, not both.',
+                });
+            }
+            input.queries.forEach((operation, index) => {
+                validateOperationSchema(definitionsByName, operation, ctx, ['queries', index]);
+            });
+            return;
+        }
+        if (input.query === undefined || input.input === undefined) {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                message: 'Provide query and input, or provide queries for a batch.',
+            });
+            return;
+        }
+        validateOperationSchema(definitionsByName, { query: input.query, input: input.input }, ctx);
+    });
+}
+function buildActionInputSchema(definitions) {
+    const definitionsByName = toDefinitionMap(definitions);
+    const actionSchema = zod_1.z.enum(toZodEnumValues(definitions.map((definition) => definition.name)));
+    const operationSchema = zod_1.z
+        .object({
+        action: actionSchema,
+        input: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+    })
+        .strict();
+    return zod_1.z
+        .object({
+        action: actionSchema.optional(),
+        input: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+        actions: zod_1.z.array(operationSchema).min(1).max(exports.MAX_BATCH_OPERATIONS).optional(),
+    })
+        .strict()
+        .superRefine((input, ctx) => {
+        if (input.actions !== undefined) {
+            if (input.action !== undefined || input.input !== undefined) {
+                ctx.addIssue({
+                    code: zod_1.z.ZodIssueCode.custom,
+                    message: 'Provide either action/input or actions, not both.',
+                });
+            }
+            input.actions.forEach((operation, index) => {
+                validateOperationSchema(definitionsByName, operation, ctx, ['actions', index]);
+            });
+            return;
+        }
+        if (input.action === undefined || input.input === undefined) {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                message: 'Provide action and input, or provide actions for a batch.',
+            });
+            return;
+        }
+        validateOperationSchema(definitionsByName, { action: input.action, input: input.input }, ctx);
+    });
+}
+function toSingleContextOperation(input) {
+    if (input.query === undefined || input.input === undefined) {
+        throw new Error('Integration context tool input was not validated.');
+    }
+    return { query: input.query, input: input.input };
+}
+function toSingleActionOperation(input) {
+    if (input.action === undefined || input.input === undefined) {
+        throw new Error('Integration action tool input was not validated.');
+    }
+    return { action: input.action, input: input.input };
+}
+function validateOperationSchema(definitionsByName, operation, ctx, pathPrefix = []) {
+    const operationName = 'query' in operation ? operation.query : operation.action;
+    const definition = definitionsByName.get(operationName);
+    if (!definition) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: pathPrefix,
+            message: `Unknown integration tool operation: ${operationName}`,
+        });
+        return;
+    }
+    const result = definition.inputSchema.safeParse(operation);
+    if (!result.success)
+        addSchemaIssues(ctx, result.error, pathPrefix);
+}
+function addSchemaIssues(ctx, error, pathPrefix = []) {
+    for (const issue of error.issues) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: [...pathPrefix, ...issue.path],
+            message: issue.message,
+        });
+    }
+}
+function toZodEnumValues(values) {
+    if (values.length === 0) {
+        throw new Error('Integration tools require at least one operation.');
+    }
+    return values;
+}
+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;
+}
+//# sourceMappingURL=integration-tool-schema.js.map

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

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

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

@@ -0,0 +1,105 @@
+import type { AgentIntegrationConfig, N8N_CHAT_INTEGRATION_TYPE } from '@n8n/api-types';
+import type { z } from 'zod';
+import type { IntegrationErrorCode } from './integration-error-codes';
+export type IntegrationMessageTarget = {
+    type: 'thread';
+    threadId: string;
+    channelId?: string;
+    userId?: string;
+} | {
+    type: 'channel';
+    channelId: string;
+    threadId?: string;
+} | {
+    type: 'dm';
+    userId: string;
+    threadId?: string;
+};
+export interface IntegrationMessageContext {
+    integrationConnectionId: string;
+    platform: string;
+    target: IntegrationMessageTarget;
+    messageId?: string;
+    interactingUserId?: string;
+    agentUserId?: string;
+    subject?: IntegrationMessageSubject;
+    updatedAt: string;
+}
+export interface IntegrationMessageSubject {
+    type: string;
+    id: string;
+    title?: string;
+    description?: string;
+    url?: string;
+    status?: string;
+    labels?: string[];
+    assignee?: IntegrationSubjectPerson;
+    author?: IntegrationSubjectPerson;
+}
+export interface IntegrationSubjectPerson {
+    id: string;
+    name: string;
+}
+export type IntegrationToolConnectionSource = AgentIntegrationConfig | {
+    type: typeof N8N_CHAT_INTEGRATION_TYPE;
+    credentialId?: undefined;
+};
+export type IntegrationContextQuery = 'get_current_message_context' | 'get_current_subject' | 'get_current_user' | 'get_current_channel_info' | 'get_user' | 'get_channel_info' | 'search_users' | 'search_channels' | 'get_team' | 'search_teams' | 'get_project' | 'search_projects' | 'search_labels' | 'search_issue_states' | 'get_issue' | 'search_issues';
+export type IntegrationAction = 'respond' | 'send_dm' | 'send_channel_message' | 'add_reaction' | 'create_issue' | 'update_issue' | 'create_comment';
+export interface IntegrationToolOperationDefinition<Name extends string = string> {
+    name: Name;
+    inputSchema: z.ZodType;
+    description: string;
+}
+export type IntegrationContextQueryDefinition = IntegrationToolOperationDefinition<IntegrationContextQuery>;
+export type IntegrationActionDefinition = IntegrationToolOperationDefinition<IntegrationAction>;
+export interface IntegrationToolConnectionDescriptor {
+    agentId?: string;
+    integration: IntegrationToolConnectionSource;
+    integrationConnectionId: string;
+    contextToolName: string;
+    actionToolName: string;
+    contextQueries: IntegrationContextQuery[];
+    actions: IntegrationAction[];
+    contextToolDefinitions: IntegrationContextQueryDefinition[];
+    actionToolDefinitions: IntegrationActionDefinition[];
+    contextToolGuidance?: string[];
+    actionToolGuidance?: string[];
+}
+export interface IntegrationMessageContextStore {
+    getLatest(threadId: string): Promise<IntegrationMessageContext | null>;
+    setLatest(threadId: string, resourceId: string, context: IntegrationMessageContext): Promise<void>;
+}
+export interface IntegrationContextQueryExecutor {
+    execute(params: {
+        descriptor: IntegrationToolConnectionDescriptor;
+        query: IntegrationContextQuery;
+        input: Record<string, unknown>;
+        persistence?: {
+            threadId: string;
+            resourceId: string;
+        };
+    }): Promise<unknown>;
+}
+export interface IntegrationActionExecutor {
+    execute(params: {
+        descriptor: IntegrationToolConnectionDescriptor;
+        action: IntegrationAction;
+        input: Record<string, unknown>;
+        awaitResponse: boolean;
+        runId?: string;
+        toolCallId?: string;
+        currentMessageContext?: IntegrationMessageContext;
+    }): Promise<IntegrationActionResult>;
+}
+export type IntegrationActionResult = {
+    ok: true;
+    messageContext?: IntegrationMessageContext;
+    [key: string]: unknown;
+} | {
+    ok: false;
+    error: {
+        code: IntegrationErrorCode;
+        message: string;
+    };
+};

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=integration-tool-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"integration-tool-types.js","sourceRoot":"","sources":["../../../../src/modules/agents/integrations/integration-tool-types.ts"],"names":[],"mappings":""}