@n8n/n8n-nodes-langchain 2.5.1 → 2.6.0

package/dist/utils/agent-execution/index.js

@@ -1,42 +1,18 @@
 "use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var agent_execution_exports = {};
-__export(agent_execution_exports, {
-  buildSteps: () => import_buildSteps.buildSteps,
-  buildToolContext: () => import_memoryManagement.buildToolContext,
-  createEngineRequests: () => import_createEngineRequests.createEngineRequests,
-  loadMemory: () => import_memoryManagement.loadMemory,
-  processEventStream: () => import_processEventStream.processEventStream,
-  saveToMemory: () => import_memoryManagement.saveToMemory
-});
-module.exports = __toCommonJS(agent_execution_exports);
-var import_createEngineRequests = require("./createEngineRequests");
-var import_buildSteps = require("./buildSteps");
-var import_processEventStream = require("./processEventStream");
-var import_memoryManagement = require("./memoryManagement");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  buildSteps,
-  buildToolContext,
-  createEngineRequests,
-  loadMemory,
-  processEventStream,
-  saveToMemory
-});
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processHitlResponses = exports.buildToolContext = exports.saveToMemory = exports.loadMemory = exports.processEventStream = exports.buildSteps = exports.buildResponseMetadata = exports.createEngineRequests = void 0;
+var createEngineRequests_1 = require("./createEngineRequests");
+Object.defineProperty(exports, "createEngineRequests", { enumerable: true, get: function () { return createEngineRequests_1.createEngineRequests; } });
+var buildResponseMetadata_1 = require("./buildResponseMetadata");
+Object.defineProperty(exports, "buildResponseMetadata", { enumerable: true, get: function () { return buildResponseMetadata_1.buildResponseMetadata; } });
+var buildSteps_1 = require("./buildSteps");
+Object.defineProperty(exports, "buildSteps", { enumerable: true, get: function () { return buildSteps_1.buildSteps; } });
+var processEventStream_1 = require("./processEventStream");
+Object.defineProperty(exports, "processEventStream", { enumerable: true, get: function () { return processEventStream_1.processEventStream; } });
+var memoryManagement_1 = require("./memoryManagement");
+Object.defineProperty(exports, "loadMemory", { enumerable: true, get: function () { return memoryManagement_1.loadMemory; } });
+Object.defineProperty(exports, "saveToMemory", { enumerable: true, get: function () { return memoryManagement_1.saveToMemory; } });
+Object.defineProperty(exports, "buildToolContext", { enumerable: true, get: function () { return memoryManagement_1.buildToolContext; } });
+var processHitlResponses_1 = require("./processHitlResponses");
+Object.defineProperty(exports, "processHitlResponses", { enumerable: true, get: function () { return processHitlResponses_1.processHitlResponses; } });
 //# sourceMappingURL=index.js.map

package/dist/utils/agent-execution/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../utils/agent-execution/index.ts"],"sourcesContent":["/**\n * Agent Execution Utilities\n *\n * This module contains generalized utilities for agent execution that can be\n * reused across different agent types (Tools Agent, OpenAI Functions Agent, etc.).\n *\n * These utilities support engine-based tool execution, where tool calls are\n * delegated to the n8n workflow engine instead of being executed inline.\n */\n\nexport { createEngineRequests } from './createEngineRequests';\nexport { buildSteps } from './buildSteps';\nexport { processEventStream } from './processEventStream';\nexport { loadMemory, saveToMemory, buildToolContext } from './memoryManagement';\nexport type {\n\tToolCallRequest,\n\tToolCallData,\n\tAgentResult,\n\tRequestResponseMetadata,\n} from './types';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAUA,kCAAqC;AACrC,wBAA2B;AAC3B,gCAAmC;AACnC,8BAA2D;","names":[]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../utils/agent-execution/index.ts"],"names":[],"mappings":";;;AAUA,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAC7B,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAC9B,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,uDAAgF;AAAvE,8GAAA,UAAU,OAAA;AAAE,gHAAA,YAAY,OAAA;AAAE,oHAAA,gBAAgB,OAAA;AACnD,+DAAyF;AAAhF,4HAAA,oBAAoB,OAAA"}

package/dist/utils/agent-execution/memoryManagement.d.ts

@@ -0,0 +1,10 @@
+import type { BaseChatMemory } from '@langchain/classic/memory';
+import type { BaseChatModel } from '@langchain/core/language_models/chat_models';
+import type { BaseMessage } from '@langchain/core/messages';
+import type { IDataObject, GenericValue } from 'n8n-workflow';
+import type { ToolCallData } from './types';
+export declare function extractToolCallId(toolCallId: IDataObject | GenericValue | GenericValue[] | IDataObject[], toolName: string): string;
+export declare function buildMessagesFromSteps(steps: ToolCallData[]): BaseMessage[];
+export declare function buildToolContext(steps: ToolCallData[]): string;
+export declare function loadMemory(memory?: BaseChatMemory, model?: BaseChatModel, maxTokens?: number): Promise<BaseMessage[] | undefined>;
+export declare function saveToMemory(input: string, output: string, memory?: BaseChatMemory, steps?: ToolCallData[], previousStepsCount?: number): Promise<void>;

package/dist/utils/agent-execution/memoryManagement.js

@@ -1,142 +1,121 @@
 "use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var memoryManagement_exports = {};
-__export(memoryManagement_exports, {
-  buildMessagesFromSteps: () => buildMessagesFromSteps,
-  buildToolContext: () => buildToolContext,
-  extractToolCallId: () => extractToolCallId,
-  loadMemory: () => loadMemory,
-  saveToMemory: () => saveToMemory
-});
-module.exports = __toCommonJS(memoryManagement_exports);
-var import_messages = require("@langchain/core/messages");
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractToolCallId = extractToolCallId;
+exports.buildMessagesFromSteps = buildMessagesFromSteps;
+exports.buildToolContext = buildToolContext;
+exports.loadMemory = loadMemory;
+exports.saveToMemory = saveToMemory;
+const messages_1 = require("@langchain/core/messages");
 function extractToolCallId(toolCallId, toolName) {
-  if (typeof toolCallId === "string" && toolCallId.length > 0) {
-    return toolCallId;
-  }
-  if (typeof toolCallId === "object" && toolCallId !== null && !Array.isArray(toolCallId) && "id" in toolCallId) {
-    const id = toolCallId.id;
-    if (typeof id === "string" && id.length > 0) {
-      return id;
+    if (typeof toolCallId === 'string' && toolCallId.length > 0) {
+        return toolCallId;
     }
-  }
-  if (Array.isArray(toolCallId) && toolCallId.length > 0) {
-    return extractToolCallId(toolCallId[0], toolName);
-  }
-  return `synthetic_${toolName}_${Date.now()}`;
+    if (typeof toolCallId === 'object' &&
+        toolCallId !== null &&
+        !Array.isArray(toolCallId) &&
+        'id' in toolCallId) {
+        const id = toolCallId.id;
+        if (typeof id === 'string' && id.length > 0) {
+            return id;
+        }
+    }
+    if (Array.isArray(toolCallId) && toolCallId.length > 0) {
+        return extractToolCallId(toolCallId[0], toolName);
+    }
+    return `synthetic_${toolName}_${Date.now()}`;
 }
 function buildMessagesFromSteps(steps) {
-  const messages = [];
-  for (let i = 0; i < steps.length; i++) {
-    const step = steps[i];
-    const existingAIMessage = step.action.messageLog?.[0];
-    const existingToolCallId = existingAIMessage?.tool_calls?.[0]?.id;
-    const toolCallId = existingToolCallId ?? extractToolCallId(step.action.toolCallId, step.action.tool);
-    const aiMessage = existingAIMessage ?? new import_messages.AIMessage({
-      content: `Calling ${step.action.tool} with input: ${JSON.stringify(step.action.toolInput)}`,
-      tool_calls: [
-        {
-          id: toolCallId,
-          name: step.action.tool,
-          args: step.action.toolInput,
-          type: "tool_call"
-        }
-      ]
-    });
-    const toolMessage = new import_messages.ToolMessage({
-      content: step.observation,
-      tool_call_id: toolCallId,
-      name: step.action.tool
-    });
-    messages.push(aiMessage);
-    messages.push(toolMessage);
-  }
-  return messages;
+    const messages = [];
+    for (let i = 0; i < steps.length; i++) {
+        const step = steps[i];
+        const existingAIMessage = step.action.messageLog?.[0];
+        const existingToolCallId = existingAIMessage?.tool_calls?.[0]?.id;
+        const toolCallId = existingToolCallId ?? extractToolCallId(step.action.toolCallId, step.action.tool);
+        const aiMessage = existingAIMessage ??
+            new messages_1.AIMessage({
+                content: `Calling ${step.action.tool} with input: ${JSON.stringify(step.action.toolInput)}`,
+                tool_calls: [
+                    {
+                        id: toolCallId,
+                        name: step.action.tool,
+                        args: step.action.toolInput,
+                        type: 'tool_call',
+                    },
+                ],
+            });
+        const toolMessage = new messages_1.ToolMessage({
+            content: step.observation,
+            tool_call_id: toolCallId,
+            name: step.action.tool,
+        });
+        messages.push(aiMessage);
+        messages.push(toolMessage);
+    }
+    return messages;
 }
 function buildToolContext(steps) {
-  return steps.map(
-    (step) => `Tool: ${step.action.tool}, Input: ${JSON.stringify(step.action.toolInput)}, Result: ${step.observation}`
-  ).join("; ");
+    return steps
+        .map((step) => `Tool: ${step.action.tool}, Input: ${JSON.stringify(step.action.toolInput)}, Result: ${step.observation}`)
+        .join('; ');
 }
 function cleanupOrphanedMessages(chatHistory) {
-  while (chatHistory.length > 0 && chatHistory[0] instanceof import_messages.ToolMessage) {
-    chatHistory.shift();
-  }
-  const firstMessage = chatHistory[0];
-  const hasOrphanedAIMessage = firstMessage instanceof import_messages.AIMessage && (firstMessage.tool_calls?.length ?? 0) > 0 && !(chatHistory[1] instanceof import_messages.ToolMessage);
-  if (hasOrphanedAIMessage) {
-    chatHistory.shift();
-  }
-  return chatHistory;
+    while (chatHistory.length > 0 && chatHistory[0] instanceof messages_1.ToolMessage) {
+        chatHistory.shift();
+    }
+    const firstMessage = chatHistory[0];
+    const hasOrphanedAIMessage = firstMessage instanceof messages_1.AIMessage &&
+        (firstMessage.tool_calls?.length ?? 0) > 0 &&
+        !(chatHistory[1] instanceof messages_1.ToolMessage);
+    if (hasOrphanedAIMessage) {
+        chatHistory.shift();
+    }
+    return chatHistory;
 }
 async function loadMemory(memory, model, maxTokens) {
-  if (!memory) {
-    return void 0;
-  }
-  const memoryVariables = await memory.loadMemoryVariables({});
-  let chatHistory = memoryVariables["chat_history"] || [];
-  chatHistory = cleanupOrphanedMessages(chatHistory);
-  if (maxTokens && model) {
-    chatHistory = await (0, import_messages.trimMessages)(chatHistory, {
-      strategy: "last",
-      maxTokens,
-      tokenCounter: model,
-      includeSystem: true,
-      startOn: "human",
-      allowPartial: true
-    });
+    if (!memory) {
+        return undefined;
+    }
+    const memoryVariables = await memory.loadMemoryVariables({});
+    let chatHistory = memoryVariables['chat_history'] || [];
     chatHistory = cleanupOrphanedMessages(chatHistory);
-  }
-  return chatHistory;
+    if (maxTokens && model) {
+        chatHistory = await (0, messages_1.trimMessages)(chatHistory, {
+            strategy: 'last',
+            maxTokens,
+            tokenCounter: model,
+            includeSystem: true,
+            startOn: 'human',
+            allowPartial: true,
+        });
+        chatHistory = cleanupOrphanedMessages(chatHistory);
+    }
+    return chatHistory;
 }
 async function saveToMemory(input, output, memory, steps, previousStepsCount) {
-  if (!output || !memory) {
-    return;
-  }
-  if (!steps || steps.length === 0) {
-    await memory.saveContext({ input }, { output });
-    return;
-  }
-  const newSteps = previousStepsCount ? steps.slice(previousStepsCount) : steps;
-  if (newSteps.length === 0) {
-    await memory.saveContext({ input }, { output });
-    return;
-  }
-  if (!("addMessages" in memory.chatHistory) || typeof memory.chatHistory.addMessages !== "function") {
-    const toolContext = buildToolContext(newSteps);
-    const fullOutput = `[Used tools: ${toolContext}] ${output}`;
-    await memory.saveContext({ input }, { output: fullOutput });
-    return;
-  }
-  const messages = [];
-  messages.push(new import_messages.HumanMessage(input));
-  const toolMessages = buildMessagesFromSteps(newSteps);
-  messages.push.apply(messages, toolMessages);
-  messages.push(new import_messages.AIMessage(output));
-  await memory.chatHistory.addMessages(messages);
+    if (!output || !memory) {
+        return;
+    }
+    if (!steps || steps.length === 0) {
+        await memory.saveContext({ input }, { output });
+        return;
+    }
+    const newSteps = previousStepsCount ? steps.slice(previousStepsCount) : steps;
+    if (newSteps.length === 0) {
+        await memory.saveContext({ input }, { output });
+        return;
+    }
+    if (!('addMessages' in memory.chatHistory) ||
+        typeof memory.chatHistory.addMessages !== 'function') {
+        const toolContext = buildToolContext(newSteps);
+        const fullOutput = `[Used tools: ${toolContext}] ${output}`;
+        await memory.saveContext({ input }, { output: fullOutput });
+        return;
+    }
+    const messages = [];
+    messages.push(new messages_1.HumanMessage(input));
+    const toolMessages = buildMessagesFromSteps(newSteps);
+    messages.push.apply(messages, toolMessages);
+    messages.push(new messages_1.AIMessage(output));
+    await memory.chatHistory.addMessages(messages);
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  buildMessagesFromSteps,
-  buildToolContext,
-  extractToolCallId,
-  loadMemory,
-  saveToMemory
-});
 //# sourceMappingURL=memoryManagement.js.map

package/dist/utils/agent-execution/memoryManagement.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../utils/agent-execution/memoryManagement.ts"],"sourcesContent":["import type { BaseChatMemory } from '@langchain/classic/memory';\nimport type { BaseChatModel } from '@langchain/core/language_models/chat_models';\nimport type { BaseMessage } from '@langchain/core/messages';\nimport { AIMessage, HumanMessage, ToolMessage, trimMessages } from '@langchain/core/messages';\nimport type { IDataObject, GenericValue } from 'n8n-workflow';\n\nimport type { ToolCallData } from './types';\n\n/**\n * Extracts a string tool_call_id from various possible formats.\n * Handles the complex type: IDataObject | GenericValue | GenericValue[] | IDataObject[]\n *\n * @param toolCallId - The tool call ID in various possible formats\n * @param toolName - The tool name, used for generating synthetic IDs\n * @returns A valid string tool_call_id\n *\n * @example\n * ```typescript\n * extractToolCallId('call-123', 'calculator') // Returns: 'call-123'\n * extractToolCallId({ id: 'call-456' }, 'search') // Returns: 'call-456'\n * extractToolCallId(['call-789'], 'weather') // Returns: 'call-789'\n * extractToolCallId(null, 'unknown') // Returns: 'synthetic_unknown_1234567890'\n * ```\n */\nexport function extractToolCallId(\n\ttoolCallId: IDataObject | GenericValue | GenericValue[] | IDataObject[],\n\ttoolName: string,\n): string {\n\t// Case 1: Already a string\n\tif (typeof toolCallId === 'string' && toolCallId.length > 0) {\n\t\treturn toolCallId;\n\t}\n\n\t// Case 2: Object with 'id' property\n\tif (\n\t\ttypeof toolCallId === 'object' &&\n\t\ttoolCallId !== null &&\n\t\t!Array.isArray(toolCallId) &&\n\t\t'id' in toolCallId\n\t) {\n\t\tconst id = toolCallId.id;\n\t\tif (typeof id === 'string' && id.length > 0) {\n\t\t\treturn id;\n\t\t}\n\t}\n\n\t// Case 3: Array - recursively extract from first element\n\tif (Array.isArray(toolCallId) && toolCallId.length > 0) {\n\t\treturn extractToolCallId(toolCallId[0], toolName);\n\t}\n\n\t// Fallback: Generate synthetic ID\n\treturn `synthetic_${toolName}_${Date.now()}`;\n}\n\n/**\n * Converts ToolCallData array into LangChain message sequence.\n * Creates alternating AIMessage (with tool_calls) and ToolMessage pairs.\n *\n * @param steps - Array of tool call data with actions and observations\n * @returns Array of BaseMessage objects (AIMessage and ToolMessage pairs)\n *\n * @example\n * ```typescript\n * const messages = buildMessagesFromSteps([{\n *   action: {\n *     tool: 'calculator',\n *     toolInput: { expression: '2+2' },\n *     messageLog: [aiMessageWithToolCalls],\n *     toolCallId: 'call-123'\n *   },\n *   observation: '4'\n * }]);\n * // Returns: [AIMessage with tool_calls, ToolMessage with result]\n * ```\n */\nexport function buildMessagesFromSteps(steps: ToolCallData[]): BaseMessage[] {\n\tconst messages: BaseMessage[] = [];\n\n\tfor (let i = 0; i < steps.length; i++) {\n\t\tconst step = steps[i];\n\n\t\t// Try to extract existing AIMessage and its tool_call ID\n\t\tconst existingAIMessage = step.action.messageLog?.[0];\n\t\tconst existingToolCallId = existingAIMessage?.tool_calls?.[0]?.id;\n\n\t\t// Use existing ID if available, otherwise extract from step data\n\t\tconst toolCallId =\n\t\t\texistingToolCallId ?? extractToolCallId(step.action.toolCallId, step.action.tool);\n\n\t\t// Use existing AIMessage or create a synthetic one\n\t\tconst aiMessage =\n\t\t\texistingAIMessage ??\n\t\t\tnew AIMessage({\n\t\t\t\tcontent: `Calling ${step.action.tool} with input: ${JSON.stringify(step.action.toolInput)}`,\n\t\t\t\ttool_calls: [\n\t\t\t\t\t{\n\t\t\t\t\t\tid: toolCallId,\n\t\t\t\t\t\tname: step.action.tool,\n\t\t\t\t\t\targs: step.action.toolInput,\n\t\t\t\t\t\ttype: 'tool_call',\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t});\n\n\t\t// Create ToolMessage with the observation result\n\t\tconst toolMessage = new ToolMessage({\n\t\t\tcontent: step.observation,\n\t\t\ttool_call_id: toolCallId,\n\t\t\tname: step.action.tool,\n\t\t});\n\n\t\t// Add both messages\n\t\tmessages.push(aiMessage);\n\t\tmessages.push(toolMessage);\n\t}\n\n\treturn messages;\n}\n\n/**\n * Builds a formatted string representation of tool calls for memory storage.\n * This creates a consistent format that can be used across both streaming and non-streaming modes.\n *\n * @deprecated Used only as fallback for custom memory implementations that don't support addMessages\n * @param steps - Array of tool call data with actions and observations\n * @returns Formatted string of tool calls separated by semicolons\n *\n * @example\n * ```typescript\n * const context = buildToolContext([{\n *   action: { tool: 'calculator', toolInput: { expression: '2+2' }, ... },\n *   observation: '4'\n * }]);\n * // Returns: \"Tool: calculator, Input: {\"expression\":\"2+2\"}, Result: 4\"\n * ```\n */\nexport function buildToolContext(steps: ToolCallData[]): string {\n\treturn steps\n\t\t.map(\n\t\t\t(step) =>\n\t\t\t\t`Tool: ${step.action.tool}, Input: ${JSON.stringify(step.action.toolInput)}, Result: ${step.observation}`,\n\t\t)\n\t\t.join('; ');\n}\n\n/**\n * Removes orphaned ToolMessages and AIMessages with tool_calls from the start of chat history.\n * This happens when memory trimming cuts messages mid-turn, leaving incomplete tool call sequences.\n *\n * @param chatHistory - Array of messages to clean up\n * @returns Cleaned array with orphaned messages removed from the start\n */\nfunction cleanupOrphanedMessages(chatHistory: BaseMessage[]): BaseMessage[] {\n\t// Remove orphaned ToolMessages at the start\n\twhile (chatHistory.length > 0 && chatHistory[0] instanceof ToolMessage) {\n\t\tchatHistory.shift();\n\t}\n\n\t// Remove AIMessages with tool_calls if they don't have following ToolMessages\n\tconst firstMessage = chatHistory[0];\n\tconst hasOrphanedAIMessage =\n\t\tfirstMessage instanceof AIMessage &&\n\t\t(firstMessage.tool_calls?.length ?? 0) > 0 &&\n\t\t!(chatHistory[1] instanceof ToolMessage);\n\n\tif (hasOrphanedAIMessage) {\n\t\tchatHistory.shift();\n\t}\n\n\treturn chatHistory;\n}\n\n/**\n * Loads chat history from memory and optionally trims it to fit within token limits.\n * Automatically cleans up orphaned tool messages that may result from memory trimming.\n *\n * @param memory - The memory instance to load from\n * @param model - Optional chat model for token counting (required if maxTokens is specified)\n * @param maxTokens - Optional maximum number of tokens to load from memory\n * @returns Array of base messages representing the chat history\n *\n * @example\n * ```typescript\n * // Load all history\n * const messages = await loadMemory(memory);\n *\n * // Load with token limit\n * const messages = await loadMemory(memory, model, 2000);\n * ```\n */\nexport async function loadMemory(\n\tmemory?: BaseChatMemory,\n\tmodel?: BaseChatModel,\n\tmaxTokens?: number,\n): Promise<BaseMessage[] | undefined> {\n\tif (!memory) {\n\t\treturn undefined;\n\t}\n\tconst memoryVariables = await memory.loadMemoryVariables({});\n\tlet chatHistory = (memoryVariables['chat_history'] as BaseMessage[]) || [];\n\n\t// Clean up any orphaned messages from previous trimming operations\n\tchatHistory = cleanupOrphanedMessages(chatHistory);\n\n\t// Trim messages if token limit is specified and model is available\n\tif (maxTokens && model) {\n\t\tchatHistory = await trimMessages(chatHistory, {\n\t\t\tstrategy: 'last',\n\t\t\tmaxTokens,\n\t\t\ttokenCounter: model,\n\t\t\tincludeSystem: true,\n\t\t\tstartOn: 'human',\n\t\t\tallowPartial: true,\n\t\t});\n\n\t\t// Clean up again after trimming, as it may create new orphans\n\t\tchatHistory = cleanupOrphanedMessages(chatHistory);\n\t}\n\n\treturn chatHistory;\n}\n\n/**\n * Saves a conversation turn (user input + agent output) to memory.\n * Uses LangChain-native message types (AIMessage with tool_calls, ToolMessage)\n * when tools are involved, preserving semantic structure for LLMs.\n *\n * @param input - The user input/prompt\n * @param output - The agent's output/response\n * @param memory - The memory instance to save to\n * @param steps - Optional tool call data to save as proper message sequence\n * @param previousStepsCount - Number of steps from previous turns (to filter out duplicates)\n *\n * @example\n * ```typescript\n * // Simple conversation (no tools)\n * await saveToMemory('What is 2+2?', 'The answer is 4', memory);\n *\n * // With tool calls (saves full message sequence)\n * await saveToMemory('Calculate 2+2', 'The answer is 4', memory, steps, 0);\n * ```\n */\nexport async function saveToMemory(\n\tinput: string,\n\toutput: string,\n\tmemory?: BaseChatMemory,\n\tsteps?: ToolCallData[],\n\tpreviousStepsCount?: number,\n): Promise<void> {\n\tif (!output || !memory) {\n\t\treturn;\n\t}\n\n\t// No tool calls: use simple saveContext (backwards compatible)\n\tif (!steps || steps.length === 0) {\n\t\tawait memory.saveContext({ input }, { output });\n\t\treturn;\n\t}\n\n\t// Filter out previous steps to avoid duplicates (they're already in memory)\n\tconst newSteps = previousStepsCount ? steps.slice(previousStepsCount) : steps;\n\n\tif (newSteps.length === 0) {\n\t\tawait memory.saveContext({ input }, { output });\n\t\treturn;\n\t}\n\n\t// Check if memory supports addMessages (feature detection)\n\tif (\n\t\t!('addMessages' in memory.chatHistory) ||\n\t\ttypeof memory.chatHistory.addMessages !== 'function'\n\t) {\n\t\t// Fallback: use old string format (only with new steps to avoid duplicates)\n\t\tconst toolContext = buildToolContext(newSteps);\n\t\tconst fullOutput = `[Used tools: ${toolContext}] ${output}`;\n\t\tawait memory.saveContext({ input }, { output: fullOutput });\n\t\treturn;\n\t}\n\n\t// Build full conversation sequence using LangChain-native message types\n\tconst messages: BaseMessage[] = [];\n\n\t// 1. User input\n\tmessages.push(new HumanMessage(input));\n\n\t// 2. Tool call sequence (AIMessage with tool_calls → ToolMessage for each)\n\tconst toolMessages = buildMessagesFromSteps(newSteps);\n\tmessages.push.apply(messages, toolMessages);\n\n\t// 3. Final AI response (no tool_calls)\n\tmessages.push(new AIMessage(output));\n\n\t// 4. Save all messages in bulk\n\tawait memory.chatHistory.addMessages(messages);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,sBAAmE;AAqB5D,SAAS,kBACf,YACA,UACS;AAET,MAAI,OAAO,eAAe,YAAY,WAAW,SAAS,GAAG;AAC5D,WAAO;AAAA,EACR;AAGA,MACC,OAAO,eAAe,YACtB,eAAe,QACf,CAAC,MAAM,QAAQ,UAAU,KACzB,QAAQ,YACP;AACD,UAAM,KAAK,WAAW;AACtB,QAAI,OAAO,OAAO,YAAY,GAAG,SAAS,GAAG;AAC5C,aAAO;AAAA,IACR;AAAA,EACD;AAGA,MAAI,MAAM,QAAQ,UAAU,KAAK,WAAW,SAAS,GAAG;AACvD,WAAO,kBAAkB,WAAW,CAAC,GAAG,QAAQ;AAAA,EACjD;AAGA,SAAO,aAAa,QAAQ,IAAI,KAAK,IAAI,CAAC;AAC3C;AAuBO,SAAS,uBAAuB,OAAsC;AAC5E,QAAM,WAA0B,CAAC;AAEjC,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACtC,UAAM,OAAO,MAAM,CAAC;AAGpB,UAAM,oBAAoB,KAAK,OAAO,aAAa,CAAC;AACpD,UAAM,qBAAqB,mBAAmB,aAAa,CAAC,GAAG;AAG/D,UAAM,aACL,sBAAsB,kBAAkB,KAAK,OAAO,YAAY,KAAK,OAAO,IAAI;AAGjF,UAAM,YACL,qBACA,IAAI,0BAAU;AAAA,MACb,SAAS,WAAW,KAAK,OAAO,IAAI,gBAAgB,KAAK,UAAU,KAAK,OAAO,SAAS,CAAC;AAAA,MACzF,YAAY;AAAA,QACX;AAAA,UACC,IAAI;AAAA,UACJ,MAAM,KAAK,OAAO;AAAA,UAClB,MAAM,KAAK,OAAO;AAAA,UAClB,MAAM;AAAA,QACP;AAAA,MACD;AAAA,IACD,CAAC;AAGF,UAAM,cAAc,IAAI,4BAAY;AAAA,MACnC,SAAS,KAAK;AAAA,MACd,cAAc;AAAA,MACd,MAAM,KAAK,OAAO;AAAA,IACnB,CAAC;AAGD,aAAS,KAAK,SAAS;AACvB,aAAS,KAAK,WAAW;AAAA,EAC1B;AAEA,SAAO;AACR;AAmBO,SAAS,iBAAiB,OAA+B;AAC/D,SAAO,MACL;AAAA,IACA,CAAC,SACA,SAAS,KAAK,OAAO,IAAI,YAAY,KAAK,UAAU,KAAK,OAAO,SAAS,CAAC,aAAa,KAAK,WAAW;AAAA,EACzG,EACC,KAAK,IAAI;AACZ;AASA,SAAS,wBAAwB,aAA2C;AAE3E,SAAO,YAAY,SAAS,KAAK,YAAY,CAAC,aAAa,6BAAa;AACvE,gBAAY,MAAM;AAAA,EACnB;AAGA,QAAM,eAAe,YAAY,CAAC;AAClC,QAAM,uBACL,wBAAwB,8BACvB,aAAa,YAAY,UAAU,KAAK,KACzC,EAAE,YAAY,CAAC,aAAa;AAE7B,MAAI,sBAAsB;AACzB,gBAAY,MAAM;AAAA,EACnB;AAEA,SAAO;AACR;AAoBA,eAAsB,WACrB,QACA,OACA,WACqC;AACrC,MAAI,CAAC,QAAQ;AACZ,WAAO;AAAA,EACR;AACA,QAAM,kBAAkB,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAC3D,MAAI,cAAe,gBAAgB,cAAc,KAAuB,CAAC;AAGzE,gBAAc,wBAAwB,WAAW;AAGjD,MAAI,aAAa,OAAO;AACvB,kBAAc,UAAM,8BAAa,aAAa;AAAA,MAC7C,UAAU;AAAA,MACV;AAAA,MACA,cAAc;AAAA,MACd,eAAe;AAAA,MACf,SAAS;AAAA,MACT,cAAc;AAAA,IACf,CAAC;AAGD,kBAAc,wBAAwB,WAAW;AAAA,EAClD;AAEA,SAAO;AACR;AAsBA,eAAsB,aACrB,OACA,QACA,QACA,OACA,oBACgB;AAChB,MAAI,CAAC,UAAU,CAAC,QAAQ;AACvB;AAAA,EACD;AAGA,MAAI,CAAC,SAAS,MAAM,WAAW,GAAG;AACjC,UAAM,OAAO,YAAY,EAAE,MAAM,GAAG,EAAE,OAAO,CAAC;AAC9C;AAAA,EACD;AAGA,QAAM,WAAW,qBAAqB,MAAM,MAAM,kBAAkB,IAAI;AAExE,MAAI,SAAS,WAAW,GAAG;AAC1B,UAAM,OAAO,YAAY,EAAE,MAAM,GAAG,EAAE,OAAO,CAAC;AAC9C;AAAA,EACD;AAGA,MACC,EAAE,iBAAiB,OAAO,gBAC1B,OAAO,OAAO,YAAY,gBAAgB,YACzC;AAED,UAAM,cAAc,iBAAiB,QAAQ;AAC7C,UAAM,aAAa,gBAAgB,WAAW,KAAK,MAAM;AACzD,UAAM,OAAO,YAAY,EAAE,MAAM,GAAG,EAAE,QAAQ,WAAW,CAAC;AAC1D;AAAA,EACD;AAGA,QAAM,WAA0B,CAAC;AAGjC,WAAS,KAAK,IAAI,6BAAa,KAAK,CAAC;AAGrC,QAAM,eAAe,uBAAuB,QAAQ;AACpD,WAAS,KAAK,MAAM,UAAU,YAAY;AAG1C,WAAS,KAAK,IAAI,0BAAU,MAAM,CAAC;AAGnC,QAAM,OAAO,YAAY,YAAY,QAAQ;AAC9C;","names":[]}
+{"version":3,"file":"memoryManagement.js","sourceRoot":"","sources":["../../../utils/agent-execution/memoryManagement.ts"],"names":[],"mappings":"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"}

package/dist/utils/agent-execution/processEventStream.d.ts

@@ -0,0 +1,5 @@
+import type { StreamEvent } from '@langchain/core/dist/tracers/event_stream';
+import type { IterableReadableStream } from '@langchain/core/dist/utils/stream';
+import type { IExecuteFunctions } from 'n8n-workflow';
+import type { AgentResult } from './types';
+export declare function processEventStream(ctx: IExecuteFunctions, eventStream: IterableReadableStream<StreamEvent>, itemIndex: number): Promise<AgentResult>;

package/dist/utils/agent-execution/processEventStream.js

@@ -1,82 +1,61 @@
 "use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var processEventStream_exports = {};
-__export(processEventStream_exports, {
-  processEventStream: () => processEventStream
-});
-module.exports = __toCommonJS(processEventStream_exports);
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processEventStream = processEventStream;
 async function processEventStream(ctx, eventStream, itemIndex) {
-  const agentResult = {
-    output: ""
-  };
-  const toolCalls = [];
-  ctx.sendChunk("begin", itemIndex);
-  for await (const event of eventStream) {
-    switch (event.event) {
-      case "on_chat_model_stream":
-        const chunk = event.data?.chunk;
-        if (chunk?.content) {
-          const chunkContent = chunk.content;
-          let chunkText = "";
-          if (Array.isArray(chunkContent)) {
-            for (const message of chunkContent) {
-              if (message?.type === "text") {
-                chunkText += message?.text;
-              }
-            }
-          } else if (typeof chunkContent === "string") {
-            chunkText = chunkContent;
-          }
-          ctx.sendChunk("item", itemIndex, chunkText);
-          agentResult.output += chunkText;
+    const agentResult = {
+        output: '',
+    };
+    const toolCalls = [];
+    ctx.sendChunk('begin', itemIndex);
+    for await (const event of eventStream) {
+        switch (event.event) {
+            case 'on_chat_model_stream':
+                const chunk = event.data?.chunk;
+                if (chunk?.content) {
+                    const chunkContent = chunk.content;
+                    let chunkText = '';
+                    if (Array.isArray(chunkContent)) {
+                        for (const message of chunkContent) {
+                            if (message?.type === 'text') {
+                                chunkText += message?.text;
+                            }
+                        }
+                    }
+                    else if (typeof chunkContent === 'string') {
+                        chunkText = chunkContent;
+                    }
+                    ctx.sendChunk('item', itemIndex, chunkText);
+                    agentResult.output += chunkText;
+                }
+                break;
+            case 'on_chat_model_end':
+                if (event.data) {
+                    const chatModelData = event.data;
+                    const output = chatModelData.output;
+                    if (output?.tool_calls && output.tool_calls.length > 0) {
+                        for (const toolCall of output.tool_calls) {
+                            toolCalls.push({
+                                tool: toolCall.name,
+                                toolInput: toolCall.args,
+                                toolCallId: toolCall.id || 'unknown',
+                                type: toolCall.type || 'tool_call',
+                                log: output.content ||
+                                    `Calling ${toolCall.name} with input: ${JSON.stringify(toolCall.args)}`,
+                                messageLog: [output],
+                                additionalKwargs: output.additional_kwargs,
+                            });
+                        }
+                    }
+                }
+                break;
+            default:
+                break;
         }
-        break;
-      case "on_chat_model_end":
-        if (event.data) {
-          const chatModelData = event.data;
-          const output = chatModelData.output;
-          if (output?.tool_calls && output.tool_calls.length > 0) {
-            for (const toolCall of output.tool_calls) {
-              toolCalls.push({
-                tool: toolCall.name,
-                toolInput: toolCall.args,
-                toolCallId: toolCall.id || "unknown",
-                type: toolCall.type || "tool_call",
-                log: output.content || `Calling ${toolCall.name} with input: ${JSON.stringify(toolCall.args)}`,
-                messageLog: [output]
-              });
-            }
-          }
-        }
-        break;
-      default:
-        break;
     }
-  }
-  ctx.sendChunk("end", itemIndex);
-  if (toolCalls.length > 0) {
-    agentResult.toolCalls = toolCalls;
-  }
-  return agentResult;
+    ctx.sendChunk('end', itemIndex);
+    if (toolCalls.length > 0) {
+        agentResult.toolCalls = toolCalls;
+    }
+    return agentResult;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  processEventStream
-});
 //# sourceMappingURL=processEventStream.js.map

package/dist/utils/agent-execution/processEventStream.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../utils/agent-execution/processEventStream.ts"],"sourcesContent":["import type { StreamEvent } from '@langchain/core/dist/tracers/event_stream';\nimport type { IterableReadableStream } from '@langchain/core/dist/utils/stream';\nimport type { AIMessageChunk, MessageContentText } from '@langchain/core/messages';\nimport type { IExecuteFunctions } from 'n8n-workflow';\n\nimport type { AgentResult, ToolCallRequest } from './types';\n\n/**\n * Processes the event stream from a streaming agent execution.\n * Handles streaming chunks, tool calls, and intermediate steps.\n *\n * This is a generalized version that can be used across different agent types\n * (Tools Agent, OpenAI Functions Agent, etc.).\n *\n * @param ctx - The execution context\n * @param eventStream - The stream of events from the agent\n * @param itemIndex - The current item index\n * @returns AgentResult containing output and optional tool calls/steps\n */\nexport async function processEventStream(\n\tctx: IExecuteFunctions,\n\teventStream: IterableReadableStream<StreamEvent>,\n\titemIndex: number,\n): Promise<AgentResult> {\n\tconst agentResult: AgentResult = {\n\t\toutput: '',\n\t};\n\n\tconst toolCalls: ToolCallRequest[] = [];\n\n\tctx.sendChunk('begin', itemIndex);\n\tfor await (const event of eventStream) {\n\t\t// Stream chat model tokens as they come in\n\t\tswitch (event.event) {\n\t\t\tcase 'on_chat_model_stream':\n\t\t\t\tconst chunk = event.data?.chunk as AIMessageChunk;\n\t\t\t\tif (chunk?.content) {\n\t\t\t\t\tconst chunkContent = chunk.content;\n\t\t\t\t\tlet chunkText = '';\n\t\t\t\t\tif (Array.isArray(chunkContent)) {\n\t\t\t\t\t\tfor (const message of chunkContent) {\n\t\t\t\t\t\t\tif (message?.type === 'text') {\n\t\t\t\t\t\t\t\tchunkText += (message as MessageContentText)?.text;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t} else if (typeof chunkContent === 'string') {\n\t\t\t\t\t\tchunkText = chunkContent;\n\t\t\t\t\t}\n\t\t\t\t\tctx.sendChunk('item', itemIndex, chunkText);\n\n\t\t\t\t\tagentResult.output += chunkText;\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t\tcase 'on_chat_model_end':\n\t\t\t\t// Capture full LLM response with tool calls for intermediate steps\n\t\t\t\tif (event.data) {\n\t\t\t\t\tconst chatModelData = event.data;\n\t\t\t\t\tconst output = chatModelData.output;\n\n\t\t\t\t\t// Check if this LLM response contains tool calls\n\t\t\t\t\tif (output?.tool_calls && output.tool_calls.length > 0) {\n\t\t\t\t\t\t// Collect tool calls for request building\n\t\t\t\t\t\tfor (const toolCall of output.tool_calls) {\n\t\t\t\t\t\t\ttoolCalls.push({\n\t\t\t\t\t\t\t\ttool: toolCall.name,\n\t\t\t\t\t\t\t\ttoolInput: toolCall.args,\n\t\t\t\t\t\t\t\ttoolCallId: toolCall.id || 'unknown',\n\t\t\t\t\t\t\t\ttype: toolCall.type || 'tool_call',\n\t\t\t\t\t\t\t\tlog:\n\t\t\t\t\t\t\t\t\toutput.content ||\n\t\t\t\t\t\t\t\t\t`Calling ${toolCall.name} with input: ${JSON.stringify(toolCall.args)}`,\n\t\t\t\t\t\t\t\tmessageLog: [output],\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\tbreak;\n\t\t}\n\t}\n\tctx.sendChunk('end', itemIndex);\n\n\t// Include collected tool calls in the result\n\tif (toolCalls.length > 0) {\n\t\tagentResult.toolCalls = toolCalls;\n\t}\n\n\treturn agentResult;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAmBA,eAAsB,mBACrB,KACA,aACA,WACuB;AACvB,QAAM,cAA2B;AAAA,IAChC,QAAQ;AAAA,EACT;AAEA,QAAM,YAA+B,CAAC;AAEtC,MAAI,UAAU,SAAS,SAAS;AAChC,mBAAiB,SAAS,aAAa;AAEtC,YAAQ,MAAM,OAAO;AAAA,MACpB,KAAK;AACJ,cAAM,QAAQ,MAAM,MAAM;AAC1B,YAAI,OAAO,SAAS;AACnB,gBAAM,eAAe,MAAM;AAC3B,cAAI,YAAY;AAChB,cAAI,MAAM,QAAQ,YAAY,GAAG;AAChC,uBAAW,WAAW,cAAc;AACnC,kBAAI,SAAS,SAAS,QAAQ;AAC7B,6BAAc,SAAgC;AAAA,cAC/C;AAAA,YACD;AAAA,UACD,WAAW,OAAO,iBAAiB,UAAU;AAC5C,wBAAY;AAAA,UACb;AACA,cAAI,UAAU,QAAQ,WAAW,SAAS;AAE1C,sBAAY,UAAU;AAAA,QACvB;AACA;AAAA,MACD,KAAK;AAEJ,YAAI,MAAM,MAAM;AACf,gBAAM,gBAAgB,MAAM;AAC5B,gBAAM,SAAS,cAAc;AAG7B,cAAI,QAAQ,cAAc,OAAO,WAAW,SAAS,GAAG;AAEvD,uBAAW,YAAY,OAAO,YAAY;AACzC,wBAAU,KAAK;AAAA,gBACd,MAAM,SAAS;AAAA,gBACf,WAAW,SAAS;AAAA,gBACpB,YAAY,SAAS,MAAM;AAAA,gBAC3B,MAAM,SAAS,QAAQ;AAAA,gBACvB,KACC,OAAO,WACP,WAAW,SAAS,IAAI,gBAAgB,KAAK,UAAU,SAAS,IAAI,CAAC;AAAA,gBACtE,YAAY,CAAC,MAAM;AAAA,cACpB,CAAC;AAAA,YACF;AAAA,UACD;AAAA,QACD;AACA;AAAA,MACD;AACC;AAAA,IACF;AAAA,EACD;AACA,MAAI,UAAU,OAAO,SAAS;AAG9B,MAAI,UAAU,SAAS,GAAG;AACzB,gBAAY,YAAY;AAAA,EACzB;AAEA,SAAO;AACR;","names":[]}
+{"version":3,"file":"processEventStream.js","sourceRoot":"","sources":["../../../utils/agent-execution/processEventStream.ts"],"names":[],"mappings":";;AAmBA,gDA0EC;AA1EM,KAAK,UAAU,kBAAkB,CACvC,GAAsB,EACtB,WAAgD,EAChD,SAAiB;IAEjB,MAAM,WAAW,GAAgB;QAChC,MAAM,EAAE,EAAE;KACV,CAAC;IAEF,MAAM,SAAS,GAAsB,EAAE,CAAC;IAExC,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAClC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAEvC,QAAQ,KAAK,CAAC,KAAK,EAAE,CAAC;YACrB,KAAK,sBAAsB;gBAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,KAAuB,CAAC;gBAClD,IAAI,KAAK,EAAE,OAAO,EAAE,CAAC;oBACpB,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC;oBACnC,IAAI,SAAS,GAAG,EAAE,CAAC;oBACnB,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;wBACjC,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;4BACpC,IAAI,OAAO,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;gCAC9B,SAAS,IAAK,OAA8B,EAAE,IAAI,CAAC;4BACpD,CAAC;wBACF,CAAC;oBACF,CAAC;yBAAM,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;wBAC7C,SAAS,GAAG,YAAY,CAAC;oBAC1B,CAAC;oBACD,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;oBAE5C,WAAW,CAAC,MAAM,IAAI,SAAS,CAAC;gBACjC,CAAC;gBACD,MAAM;YACP,KAAK,mBAAmB;gBAEvB,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;oBAChB,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC;oBACjC,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;oBAGpC,IAAI,MAAM,EAAE,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAIxD,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;4BAC1C,SAAS,CAAC,IAAI,CAAC;gCACd,IAAI,EAAE,QAAQ,CAAC,IAAI;gCACnB,SAAS,EAAE,QAAQ,CAAC,IAAI;gCACxB,UAAU,EAAE,QAAQ,CAAC,EAAE,IAAI,SAAS;gCACpC,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,WAAW;gCAClC,GAAG,EACF,MAAM,CAAC,OAAO;oCACd,WAAW,QAAQ,CAAC,IAAI,gBAAgB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;gCACxE,UAAU,EAAE,CAAC,MAAM,CAAC;gCAEpB,gBAAgB,EAAE,MAAM,CAAC,iBAAwD;6BACjF,CAAC,CAAC;wBACJ,CAAC;oBACF,CAAC;gBACF,CAAC;gBACD,MAAM;YACP;gBACC,MAAM;QACR,CAAC;IACF,CAAC;IACD,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAGhC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,WAAW,CAAC,SAAS,GAAG,SAAS,CAAC;IACnC,CAAC;IAED,OAAO,WAAW,CAAC;AACpB,CAAC"}

package/dist/utils/agent-execution/processHitlResponses.d.ts

@@ -0,0 +1,8 @@
+import type { EngineResponse, EngineRequest } from 'n8n-workflow';
+import type { RequestResponseMetadata } from './types';
+export interface HitlProcessingResult {
+    pendingGatedToolRequest?: EngineRequest<RequestResponseMetadata>;
+    processedResponse: EngineResponse<RequestResponseMetadata>;
+    hasApprovedHitlTools: boolean;
+}
+export declare function processHitlResponses(response: EngineResponse<RequestResponseMetadata> | undefined, itemIndex: number): HitlProcessingResult;