n8n 2.23.2 → 2.24.0

package/dist/modules/agents/tools/knowledge/search.operation.js

@@ -0,0 +1,332 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInternalCommand = runInternalCommand;
+exports.runSearchOperation = runSearchOperation;
+const file_references_1 = require("./file-references");
+const DEFAULT_READ_RANGE_CONTEXT = 6;
+const MAX_SEARCH_MATCH_TEXT_LENGTH = 500;
+const MULTI_QUERY_WINDOW_LINES = 3;
+async function runInternalCommand(commandService, workspaceRoot, request) {
+    const result = await commandService.run(workspaceRoot, request);
+    return { ...result, command: request.command };
+}
+async function runSearchOperation(input, workspaceRoot, files, commandService) {
+    if (input.query === undefined && input.queries === undefined) {
+        return {
+            operation: 'search',
+            files,
+            error: 'Either query or queries must be provided for search.',
+        };
+    }
+    const requestedFiles = (0, file_references_1.mapFileReferences)(files, input.files);
+    const primaryPattern = getPrimarySearchPattern(input);
+    const commandPattern = getSearchCommandPattern(input);
+    const commandFixedStrings = getSearchCommandFixedStrings(input);
+    let contentResult;
+    const countResult = await runInternalCommand(commandService, workspaceRoot, {
+        command: 'git_grep',
+        pattern: commandPattern,
+        outputMode: 'count',
+        caseInsensitive: input.caseInsensitive,
+        fixedStrings: commandFixedStrings,
+        files: requestedFiles,
+    });
+    let counts = parseCountOutput(countResult.stdout, files);
+    let multiQueryMatches;
+    if (input.queries) {
+        contentResult = await runInternalCommand(commandService, workspaceRoot, {
+            command: 'git_grep',
+            pattern: commandPattern,
+            caseInsensitive: input.caseInsensitive,
+            fixedStrings: commandFixedStrings,
+            context: input.context,
+            files: requestedFiles,
+        });
+        multiQueryMatches = filterMultiQueryMatches(parseSearchMatches(contentResult.stdout, files), input.queries, input.match_mode, input.caseInsensitive);
+        counts = buildCountsFromMatches(multiQueryMatches, files);
+    }
+    if (input.output_mode === 'files_with_matches') {
+        const slicedCounts = sliceResults(counts, input.offset, input.head_limit);
+        return {
+            operation: 'search',
+            files,
+            result: toDisplayResult(countResult, formatSearchFiles(counts, input.offset, input.head_limit), slicedCounts.truncated),
+            search: buildSearchResult({
+                mode: input.output_mode,
+                query: primaryPattern,
+                queries: input.queries,
+                matchMode: input.queries ? input.match_mode : undefined,
+                counts,
+                matches: [],
+                offset: input.offset,
+                headLimit: input.head_limit,
+                hint: buildSearchHint('files_with_matches', slicedCounts, input.head_limit),
+            }),
+        };
+    }
+    if (input.output_mode === 'count') {
+        const slicedCounts = sliceResults(counts, input.offset, input.head_limit);
+        return {
+            operation: 'search',
+            files,
+            result: toDisplayResult(countResult, formatSearchCounts(counts, input.offset, input.head_limit), slicedCounts.truncated),
+            search: buildSearchResult({
+                mode: input.output_mode,
+                query: primaryPattern,
+                queries: input.queries,
+                matchMode: input.queries ? input.match_mode : undefined,
+                counts,
+                matches: [],
+                offset: input.offset,
+                headLimit: input.head_limit,
+                hint: buildSearchHint('count', slicedCounts, input.head_limit),
+            }),
+        };
+    }
+    contentResult ??= await runInternalCommand(commandService, workspaceRoot, {
+        command: 'git_grep',
+        pattern: commandPattern,
+        caseInsensitive: input.caseInsensitive,
+        fixedStrings: commandFixedStrings,
+        context: input.context,
+        files: requestedFiles,
+    });
+    const parsedMatches = parseSearchMatches(contentResult.stdout, files);
+    const matches = multiQueryMatches ?? parsedMatches;
+    const slicedMatches = sliceResults(matches, input.offset, input.head_limit);
+    const displayMatches = slicedMatches.items.map(toSearchMatchOutput);
+    const search = buildSearchResult({
+        mode: input.output_mode,
+        query: primaryPattern,
+        queries: input.queries,
+        matchMode: input.queries ? input.match_mode : undefined,
+        counts,
+        matches: displayMatches,
+        offset: input.offset,
+        headLimit: input.head_limit,
+        nextOffset: slicedMatches.nextOffset,
+        hint: buildSearchHint('content', slicedMatches, input.head_limit),
+    });
+    return {
+        operation: 'search',
+        files,
+        result: toDisplayResult(contentResult, formatSearchMatches(displayMatches, slicedMatches, input.head_limit), search.truncated || contentResult.truncated),
+        search,
+    };
+}
+function toDisplayResult(result, stdout, truncated = false) {
+    return {
+        ...result,
+        stdout,
+        truncated: result.truncated || truncated,
+    };
+}
+function parseCountOutput(stdout, files) {
+    const byRelativePath = new Map(files.map((file) => [file.relativePath, file]));
+    const counts = stdout
+        .split('\n')
+        .flatMap((line) => {
+        if (line.trim() === '')
+            return [];
+        const separatorIndex = line.lastIndexOf(':');
+        if (separatorIndex === -1)
+            return [];
+        const relativePath = normaliseGrepPath(line.slice(0, separatorIndex));
+        const matchCount = Number(line.slice(separatorIndex + 1));
+        const file = byRelativePath.get(relativePath);
+        if (!file || !Number.isFinite(matchCount) || matchCount <= 0)
+            return [];
+        return [
+            {
+                id: file.id,
+                fileName: file.fileName,
+                relativePath: file.relativePath,
+                matchCount,
+            },
+        ];
+    })
+        .sort((left, right) => right.matchCount - left.matchCount);
+    return counts;
+}
+function parseSearchMatches(stdout, files) {
+    const byRelativePath = new Map(files.map((file) => [file.relativePath, file]));
+    return stdout.split('\n').flatMap((line) => {
+        const parsed = parseGrepLine(line);
+        if (!parsed?.isMatch)
+            return [];
+        const file = byRelativePath.get(normaliseGrepPath(parsed.filePath));
+        if (!file || parsed.lineNumber === undefined)
+            return [];
+        const fullText = line.slice(parsed.contentStartIndex);
+        const { text, truncated } = truncateMatchText(fullText);
+        return [
+            {
+                fileId: file.id,
+                fileName: file.fileName,
+                relativePath: file.relativePath,
+                lineNumber: parsed.lineNumber,
+                fullText,
+                text,
+                readRange: toReadRange(parsed.lineNumber),
+                truncated,
+            },
+        ];
+    });
+}
+function toSearchMatchOutput({ fullText: _fullText, ...match }) {
+    return match;
+}
+function truncateMatchText(text) {
+    if (text.length <= MAX_SEARCH_MATCH_TEXT_LENGTH)
+        return { text };
+    return {
+        text: `${text.slice(0, MAX_SEARCH_MATCH_TEXT_LENGTH)}... [line truncated; use read for full text]`,
+        truncated: true,
+    };
+}
+function filterMultiQueryMatches(matches, queries, matchMode, caseInsensitive) {
+    const normalizedQueries = queries.map((query) => normalizeSearchText(query, caseInsensitive));
+    if (matchMode === 'any') {
+        return matches.filter((match) => normalizedQueries.some((query) => normalizeSearchText(match.fullText, caseInsensitive).includes(query)));
+    }
+    if (matchMode === 'all_on_same_line') {
+        return matches.filter((match) => {
+            const text = normalizeSearchText(match.fullText, caseInsensitive);
+            return normalizedQueries.every((query) => text.includes(query));
+        });
+    }
+    return matches.filter((match) => hasAllQueriesInNearbyWindow(matches, match.relativePath, match.lineNumber, normalizedQueries, caseInsensitive));
+}
+function buildCountsFromMatches(matches, files) {
+    const countByRelativePath = new Map();
+    for (const match of matches) {
+        countByRelativePath.set(match.relativePath, (countByRelativePath.get(match.relativePath) ?? 0) + 1);
+    }
+    return files
+        .flatMap((file) => {
+        const matchCount = countByRelativePath.get(file.relativePath) ?? 0;
+        if (matchCount === 0)
+            return [];
+        return [
+            {
+                id: file.id,
+                fileName: file.fileName,
+                relativePath: file.relativePath,
+                matchCount,
+            },
+        ];
+    })
+        .sort((left, right) => right.matchCount - left.matchCount);
+}
+function hasAllQueriesInNearbyWindow(matches, relativePath, lineNumber, queries, caseInsensitive) {
+    const sameFileMatches = matches.filter((match) => match.relativePath === relativePath);
+    return sameFileMatches.some((windowStart) => {
+        const start = windowStart.lineNumber;
+        const end = start + MULTI_QUERY_WINDOW_LINES - 1;
+        if (lineNumber < start || lineNumber > end)
+            return false;
+        const windowText = sameFileMatches
+            .filter((match) => match.lineNumber >= start && match.lineNumber <= end)
+            .map((match) => normalizeSearchText(match.fullText, caseInsensitive))
+            .join('\n');
+        return queries.every((query) => windowText.includes(query));
+    });
+}
+function normalizeSearchText(text, caseInsensitive) {
+    return caseInsensitive ? text.toLowerCase() : text;
+}
+function toReadRange(lineNumber) {
+    return {
+        start: Math.max(1, lineNumber - DEFAULT_READ_RANGE_CONTEXT),
+        end: lineNumber + DEFAULT_READ_RANGE_CONTEXT,
+    };
+}
+function getPrimarySearchPattern(input) {
+    return input.query ?? input.queries?.[0] ?? '';
+}
+function getSearchCommandPattern(input) {
+    if (!input.queries)
+        return input.query ?? '';
+    return input.queries.map(escapeExtendedRegex).join('|');
+}
+function getSearchCommandFixedStrings(input) {
+    return input.queries ? false : (input.fixedStrings ?? true);
+}
+function escapeExtendedRegex(pattern) {
+    return pattern.replace(/[\\^$.*+?()[\]{}|]/g, '\\$&');
+}
+function buildSearchResult({ mode, query, queries, matchMode, counts, matches, offset, headLimit, nextOffset, hint, }) {
+    const slicedCounts = sliceResults(counts, offset, headLimit);
+    const totalMatchingLines = counts.reduce((total, count) => total + count.matchCount, 0);
+    const effectiveNextOffset = mode === 'content' ? nextOffset : slicedCounts.nextOffset;
+    return {
+        mode,
+        query,
+        queries,
+        matchMode,
+        totalMatchingFiles: counts.length,
+        totalMatchingLines,
+        files: slicedCounts.items,
+        matches,
+        truncated: slicedCounts.truncated || effectiveNextOffset !== undefined,
+        appliedLimit: (mode === 'content' && effectiveNextOffset !== undefined) || slicedCounts.truncated
+            ? headLimit
+            : undefined,
+        appliedOffset: offset > 0 ? offset : undefined,
+        nextOffset: effectiveNextOffset,
+        hint,
+    };
+}
+function sliceResults(items, offset, headLimit) {
+    const sliced = headLimit === 0 ? items.slice(offset) : items.slice(offset, offset + headLimit);
+    return {
+        items: sliced,
+        truncated: offset + sliced.length < items.length,
+        nextOffset: offset + sliced.length < items.length ? offset + sliced.length : undefined,
+    };
+}
+function buildSearchHint(mode, sliced, headLimit) {
+    if (sliced.nextOffset !== undefined) {
+        return `Additional ${mode === 'files_with_matches' ? 'files' : mode === 'count' ? 'counts' : 'matches'} omitted. Continue with offset=${sliced.nextOffset} and head_limit=${headLimit}, or ${mode === 'content' ? 'read one of the returned ranges' : 'switch to output_mode=content after choosing a file'}.`;
+    }
+    if (mode === 'content')
+        return 'Use read with the suggested line ranges for grounded citations.';
+    if (mode === 'count')
+        return 'Use output_mode=content after choosing a file or exact phrase.';
+    return 'Use read on a matching file or switch to output_mode=content for line anchors.';
+}
+function formatSearchFiles(counts, offset, headLimit) {
+    const sliced = sliceResults(counts, offset, headLimit);
+    const lines = sliced.items.map((file) => file.fileName);
+    if (sliced.truncated)
+        lines.push(buildSearchHint('files_with_matches', sliced, headLimit));
+    return lines.length > 0 ? `${lines.join('\n')}\n` : '';
+}
+function formatSearchCounts(counts, offset, headLimit) {
+    const sliced = sliceResults(counts, offset, headLimit);
+    const lines = sliced.items.map((file) => `${file.fileName}: ${file.matchCount}`);
+    if (sliced.truncated)
+        lines.push(buildSearchHint('count', sliced, headLimit));
+    return lines.length > 0 ? `${lines.join('\n')}\n` : '';
+}
+function formatSearchMatches(matches, sliced, headLimit) {
+    const lines = matches.map((match) => `${match.fileName}:${match.lineNumber}:${match.text} (read ${match.readRange.start}-${match.readRange.end})`);
+    if (sliced.truncated)
+        lines.push(buildSearchHint('content', sliced, headLimit));
+    return lines.length > 0 ? `${lines.join('\n')}\n` : '';
+}
+function parseGrepLine(line) {
+    const match = /^(?<filePath>.*)(?<separator>[:-])(?<lineNumber>\d+)(?<contentSeparator>[:-])/.exec(line);
+    if (!match?.groups)
+        return undefined;
+    return {
+        filePath: normaliseGrepPath(match.groups.filePath),
+        isMatch: match.groups.separator === ':' && match.groups.contentSeparator === ':',
+        lineNumber: Number(match.groups.lineNumber),
+        contentStartIndex: match[0].length,
+    };
+}
+function normaliseGrepPath(filePath) {
+    return filePath.startsWith('./') ? filePath.slice(2) : filePath;
+}
+//# sourceMappingURL=search.operation.js.map

package/dist/modules/agents/tools/knowledge/search.operation.js.map

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

package/dist/modules/agents/tools/knowledge/tool.d.ts

@@ -0,0 +1,8 @@
+import type { AgentKnowledgeCommandService } from '../../agent-knowledge-command.service';
+import type { AgentKnowledgeService } from '../../agent-knowledge.service';
+export declare function createSearchKnowledgeTool({ agentId, projectId, knowledgeService, commandService, }: {
+    agentId: string;
+    projectId: string;
+    knowledgeService: AgentKnowledgeService;
+    commandService: AgentKnowledgeCommandService;
+}): import("@n8n/agents").BuiltTool;

package/dist/modules/agents/tools/knowledge/tool.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSearchKnowledgeTool = createSearchKnowledgeTool;
+const tool_1 = require("@n8n/agents/tool");
+const node_crypto_1 = require("node:crypto");
+const csv_operation_1 = require("./csv.operation");
+const file_references_1 = require("./file-references");
+const read_operation_1 = require("./read.operation");
+const search_operation_1 = require("./search.operation");
+const schemas_1 = require("./schemas");
+function createSearchKnowledgeTool({ agentId, projectId, knowledgeService, commandService, }) {
+    return new tool_1.Tool('search_knowledge')
+        .description('List, read, search, and query files uploaded to this agent knowledge base. ' +
+        'Use this when the user asks about uploaded documents or facts likely contained in them.')
+        .systemInstruction('Use search_knowledge to inspect uploaded knowledge files. Do not claim a file says something ' +
+        'unless you found it via list, search, read, or a CSV operation. Search defaults to output_mode=files_with_matches. ' +
+        'Use output_mode=count for counts and output_mode=content only after narrowing to a file or exact phrase. ' +
+        'For conceptual multi-term lookup, use queries with match_mode instead of writing regex by hand. ' +
+        'Use read for grounded citations. Cite only file names and line ranges from read results. ' +
+        'Never mention uploaded file ids, relative paths, binary ids, or storage ids to users. ' +
+        'For unfamiliar CSVs, call csv_profile first. Use csv_query for rows, csv_distinct for possible values, and csv_aggregate for counts or numeric calculations. ' +
+        'Do not answer from the first CSV row when rowCount is high or truncated; refine filters using ambiguity hints.')
+        .input(schemas_1.searchKnowledgeInputSchema)
+        .output(schemas_1.searchKnowledgeOutputSchema)
+        .handler(async (input) => {
+        let parsedInput;
+        try {
+            parsedInput = (0, schemas_1.parseSearchKnowledgeInput)(input);
+        }
+        catch (error) {
+            return {
+                operation: (0, schemas_1.getSearchKnowledgeOperation)(input),
+                files: [],
+                error: toToolErrorMessage(error),
+            };
+        }
+        if (parsedInput.operation === 'list') {
+            try {
+                return {
+                    operation: 'list',
+                    files: await knowledgeService.listWorkspaceFiles(agentId, projectId),
+                };
+            }
+            catch (error) {
+                return {
+                    operation: 'list',
+                    files: [],
+                    error: toToolErrorMessage(error),
+                };
+            }
+        }
+        let files = [];
+        try {
+            const fileReferences = (0, file_references_1.getRequiredFileReferences)(parsedInput);
+            files = await knowledgeService.resolveWorkspaceFiles(agentId, projectId, fileReferences);
+            const cacheKey = buildWorkspaceCacheKey(projectId, agentId, files);
+            return await commandService.withCachedWorkspace(cacheKey, async (workspaceRoot) => {
+                await knowledgeService.materializeWorkspace(agentId, projectId, workspaceRoot, {
+                    fileReferences,
+                });
+            }, async (workspaceRoot) => await handleKnowledgeOperation(parsedInput, workspaceRoot, files, commandService));
+        }
+        catch (error) {
+            return {
+                operation: parsedInput.operation,
+                files,
+                error: toToolErrorMessage(error),
+            };
+        }
+    })
+        .build();
+}
+function buildWorkspaceCacheKey(projectId, agentId, files) {
+    const signature = files
+        .map((file) => `${file.relativePath}:${file.fileSizeBytes}`)
+        .sort()
+        .join('|');
+    return `${projectId}:${agentId}:${(0, node_crypto_1.createHash)('sha1').update(signature).digest('hex')}`;
+}
+function toToolErrorMessage(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return message.replace(/(^|[\s'"(])\/(?:[^\s'"()]+\/)*[^\s'"()]+/g, '$1[path]');
+}
+async function handleKnowledgeOperation(input, workspaceRoot, files, commandService) {
+    switch (input.operation) {
+        case 'list':
+            return {
+                operation: 'list',
+                files,
+            };
+        case 'search':
+            return await (0, search_operation_1.runSearchOperation)(input, workspaceRoot, files, commandService);
+        case 'read':
+            return await (0, read_operation_1.runReadOperation)(input, workspaceRoot, files, commandService);
+        case 'csv_query':
+            return {
+                operation: 'csv_query',
+                files,
+                csv: await (0, csv_operation_1.queryCsv)(workspaceRoot, files, input),
+            };
+        case 'csv_profile':
+            return {
+                operation: 'csv_profile',
+                files,
+                csvProfile: await (0, csv_operation_1.profileCsv)(workspaceRoot, files, input),
+            };
+        case 'csv_distinct':
+            return {
+                operation: 'csv_distinct',
+                files,
+                csvDistinct: await (0, csv_operation_1.distinctCsv)(workspaceRoot, files, input),
+            };
+        case 'csv_aggregate':
+            return {
+                operation: 'csv_aggregate',
+                files,
+                csvAggregate: await (0, csv_operation_1.aggregateCsv)(workspaceRoot, files, input),
+            };
+    }
+}
+//# sourceMappingURL=tool.js.map

package/dist/modules/agents/tools/knowledge/tool.js.map

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

package/dist/modules/agents/utils/agent-memory-scope.d.ts

@@ -1,3 +1,3 @@
 export declare function draftChatMemoryResourceId(userId: string): string;
-export declare function scheduledRunMemoryResourceId(executionUserId: string): string;
 export declare function integrationMemoryResourceId(integrationType: string, threadId: string): string;
+export declare function taskRunMemoryResourceId(taskId: string): string;

package/dist/modules/agents/utils/agent-memory-scope.js

@@ -1,15 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.draftChatMemoryResourceId = draftChatMemoryResourceId;
-exports.scheduledRunMemoryResourceId = scheduledRunMemoryResourceId;
 exports.integrationMemoryResourceId = integrationMemoryResourceId;
+exports.taskRunMemoryResourceId = taskRunMemoryResourceId;
 function draftChatMemoryResourceId(userId) {
     return `draft-chat:${userId}`;
 }
-function scheduledRunMemoryResourceId(executionUserId) {
-    return `schedule:${executionUserId}`;
-}
 function integrationMemoryResourceId(integrationType, threadId) {
     return `integration:${integrationType}:${threadId}`;
 }
+function taskRunMemoryResourceId(taskId) {
+    return `task:${taskId}`;
+}
 //# sourceMappingURL=agent-memory-scope.js.map

package/dist/modules/agents/utils/agent-memory-scope.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-memory-scope.js","sourceRoot":"","sources":["../../../../src/modules/agents/utils/agent-memory-scope.ts"],"names":[],"mappings":";;AAAA,8DAEC;AAED,oEAEC;AAED,kEAEC;AAVD,SAAgB,yBAAyB,CAAC,MAAc;IACvD,OAAO,cAAc,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED,SAAgB,4BAA4B,CAAC,eAAuB;IACnE,OAAO,YAAY,eAAe,EAAE,CAAC;AACtC,CAAC;AAED,SAAgB,2BAA2B,CAAC,eAAuB,EAAE,QAAgB;IACpF,OAAO,eAAe,eAAe,IAAI,QAAQ,EAAE,CAAC;AACrD,CAAC"}
+{"version":3,"file":"agent-memory-scope.js","sourceRoot":"","sources":["../../../../src/modules/agents/utils/agent-memory-scope.ts"],"names":[],"mappings":";;AAAA,8DAEC;AAED,kEAEC;AAED,0DAEC;AAVD,SAAgB,yBAAyB,CAAC,MAAc;IACvD,OAAO,cAAc,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED,SAAgB,2BAA2B,CAAC,eAAuB,EAAE,QAAgB;IACpF,OAAO,eAAe,eAAe,IAAI,QAAQ,EAAE,CAAC;AACrD,CAAC;AAED,SAAgB,uBAAuB,CAAC,MAAc;IACrD,OAAO,QAAQ,MAAM,EAAE,CAAC;AACzB,CAAC"}

package/dist/modules/agents/utils/agent-resource-id.d.ts

@@ -1,3 +1,3 @@
-type AgentResourceIdPrefix = 'skill' | 'tool';
+type AgentResourceIdPrefix = 'skill' | 'task' | 'tool';
 export declare function generateAgentResourceId(prefix: AgentResourceIdPrefix, existingIds?: Iterable<string>): string;
 export {};

package/dist/modules/chat-hub/chat-hub.module.d.ts

@@ -3,8 +3,8 @@ export declare class ChatHubModule implements ModuleInterface {
     init(): Promise<void>;
     settings(): Promise<{
         enabled: boolean;
-        providers: Record<"openai" | "anthropic" | "google" | "groq" | "cohere" | "azureOpenAi" | "azureEntraId" | "ollama" | "awsBedrock" | "vercelAiGateway" | "xAiGrok" | "openRouter" | "deepSeek" | "mistralCloud" | "nvidia", {
-            provider: "anthropic" | "openai" | "google" | "azureOpenAi" | "azureEntraId" | "ollama" | "awsBedrock" | "vercelAiGateway" | "xAiGrok" | "groq" | "openRouter" | "deepSeek" | "cohere" | "mistralCloud" | "nvidia";
+        providers: Record<"anthropic" | "openai" | "google" | "groq" | "cohere" | "azureOpenAi" | "azureEntraId" | "ollama" | "awsBedrock" | "vercelAiGateway" | "xAiGrok" | "openRouter" | "deepSeek" | "mistralCloud" | "nvidia", {
+            provider: "anthropic" | "openai" | "google" | "groq" | "cohere" | "ollama" | "azureOpenAi" | "azureEntraId" | "awsBedrock" | "vercelAiGateway" | "xAiGrok" | "openRouter" | "deepSeek" | "mistralCloud" | "nvidia";
             credentialId: string | null;
             updatedAt: string | null;
             allowedModels: {

package/dist/modules/chat-hub/chat-hub.settings.controller.d.ts

@@ -8,8 +8,8 @@ export declare class ChatHubSettingsController {
     private readonly moduleRegistry;
     constructor(settings: ChatHubSettingsService, logger: Logger, moduleRegistry: ModuleRegistry);
     getSettings(_req: AuthenticatedRequest, _res: Response): Promise<{
-        providers: Record<"openai" | "anthropic" | "google" | "groq" | "cohere" | "azureOpenAi" | "azureEntraId" | "ollama" | "awsBedrock" | "vercelAiGateway" | "xAiGrok" | "openRouter" | "deepSeek" | "mistralCloud" | "nvidia", {
-            provider: "anthropic" | "openai" | "google" | "azureOpenAi" | "azureEntraId" | "ollama" | "awsBedrock" | "vercelAiGateway" | "xAiGrok" | "groq" | "openRouter" | "deepSeek" | "cohere" | "mistralCloud" | "nvidia";
+        providers: Record<"anthropic" | "openai" | "google" | "groq" | "cohere" | "azureOpenAi" | "azureEntraId" | "ollama" | "awsBedrock" | "vercelAiGateway" | "xAiGrok" | "openRouter" | "deepSeek" | "mistralCloud" | "nvidia", {
+            provider: "anthropic" | "openai" | "google" | "groq" | "cohere" | "ollama" | "azureOpenAi" | "azureEntraId" | "awsBedrock" | "vercelAiGateway" | "xAiGrok" | "openRouter" | "deepSeek" | "mistralCloud" | "nvidia";
             credentialId: string | null;
             updatedAt: string | null;
             allowedModels: {
@@ -25,7 +25,7 @@ export declare class ChatHubSettingsController {
     }>;
     getProviderSettings(_req: AuthenticatedRequest, _res: Response, provider: ChatHubLLMProvider): Promise<{
         settings: {
-            provider: "anthropic" | "openai" | "google" | "azureOpenAi" | "azureEntraId" | "ollama" | "awsBedrock" | "vercelAiGateway" | "xAiGrok" | "groq" | "openRouter" | "deepSeek" | "cohere" | "mistralCloud" | "nvidia";
+            provider: "anthropic" | "openai" | "google" | "groq" | "cohere" | "ollama" | "azureOpenAi" | "azureEntraId" | "awsBedrock" | "vercelAiGateway" | "xAiGrok" | "openRouter" | "deepSeek" | "mistralCloud" | "nvidia";
             credentialId: string | null;
             updatedAt: string | null;
             allowedModels: {
@@ -40,7 +40,7 @@ export declare class ChatHubSettingsController {
         };
     }>;
     updateSettings(_req: AuthenticatedRequest, _res: Response, body: UpdateChatSettingsRequest): Promise<{
-        provider: "anthropic" | "openai" | "google" | "azureOpenAi" | "azureEntraId" | "ollama" | "awsBedrock" | "vercelAiGateway" | "xAiGrok" | "groq" | "openRouter" | "deepSeek" | "cohere" | "mistralCloud" | "nvidia";
+        provider: "anthropic" | "openai" | "google" | "groq" | "cohere" | "ollama" | "azureOpenAi" | "azureEntraId" | "awsBedrock" | "vercelAiGateway" | "xAiGrok" | "openRouter" | "deepSeek" | "mistralCloud" | "nvidia";
         credentialId: string | null;
         updatedAt: string | null;
         allowedModels: {

package/dist/modules/chat-hub/chat-hub.types.d.ts

@@ -82,12 +82,12 @@ export declare const chatTriggerParamsShape: z.ZodObject<{
         responseMode: z.ZodOptional<z.ZodEnum<["streaming", "lastNode", "responseNode", "responseNodes"]>>;
         autoSaveHighlightedData: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        responseMode?: "lastNode" | "responseNode" | "streaming" | "responseNodes" | undefined;
+        responseMode?: "responseNode" | "lastNode" | "streaming" | "responseNodes" | undefined;
         allowFileUploads?: boolean | undefined;
         allowedFilesMimeTypes?: string | undefined;
         autoSaveHighlightedData?: boolean | undefined;
     }, {
-        responseMode?: "lastNode" | "responseNode" | "streaming" | "responseNodes" | undefined;
+        responseMode?: "responseNode" | "lastNode" | "streaming" | "responseNodes" | undefined;
         allowFileUploads?: boolean | undefined;
         allowedFilesMimeTypes?: string | undefined;
         autoSaveHighlightedData?: boolean | undefined;
@@ -95,7 +95,7 @@ export declare const chatTriggerParamsShape: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     availableInChat: boolean;
     options?: {
-        responseMode?: "lastNode" | "responseNode" | "streaming" | "responseNodes" | undefined;
+        responseMode?: "responseNode" | "lastNode" | "streaming" | "responseNodes" | undefined;
         allowFileUploads?: boolean | undefined;
         allowedFilesMimeTypes?: string | undefined;
         autoSaveHighlightedData?: boolean | undefined;
@@ -111,13 +111,13 @@ export declare const chatTriggerParamsShape: z.ZodObject<{
     agentIcon?: import("n8n-workflow").IconOrEmoji | undefined;
 }, {
     options?: {
-        responseMode?: "lastNode" | "responseNode" | "streaming" | "responseNodes" | undefined;
+        responseMode?: "responseNode" | "lastNode" | "streaming" | "responseNodes" | undefined;
         allowFileUploads?: boolean | undefined;
         allowedFilesMimeTypes?: string | undefined;
         autoSaveHighlightedData?: boolean | undefined;
     } | undefined;
-    agentName?: string | undefined;
     availableInChat?: boolean | undefined;
+    agentName?: string | undefined;
     suggestedPrompts?: {
         prompts?: {
             text: string;

package/dist/modules/chat-hub/dto/chat-models-request.dto.d.ts

@@ -1,5 +1,5 @@
 declare const ChatModelsRequestDto_base: import("@n8n/api-types").ZodClass<{
-    credentials: Partial<Record<"n8n" | "openai" | "anthropic" | "google" | "groq" | "cohere" | "azureOpenAi" | "azureEntraId" | "ollama" | "awsBedrock" | "vercelAiGateway" | "xAiGrok" | "openRouter" | "deepSeek" | "mistralCloud" | "nvidia" | "custom-agent", string | null>>;
+    credentials: Partial<Record<"n8n" | "anthropic" | "openai" | "google" | "groq" | "cohere" | "azureOpenAi" | "azureEntraId" | "ollama" | "awsBedrock" | "vercelAiGateway" | "xAiGrok" | "openRouter" | "deepSeek" | "mistralCloud" | "nvidia" | "custom-agent", string | null>>;
 }, {
     credentials: import("zod").ZodRecord<import("zod").ZodEnum<["openai", "anthropic", "google", "azureOpenAi", "azureEntraId", "ollama", "awsBedrock", "vercelAiGateway", "xAiGrok", "groq", "openRouter", "deepSeek", "cohere", "mistralCloud", "nvidia", "n8n", "custom-agent"]>, import("zod").ZodNullable<import("zod").ZodString>>;
 }>;

package/dist/modules/dynamic-credentials.ee/constants.d.ts

@@ -1,3 +1,3 @@
-export declare const SYSTEM_RESOLVER_ID = "system-n8n";
+export { SYSTEM_RESOLVER_ID } from '@n8n/api-types';
 export declare const SYSTEM_RESOLVER_NAME = "n8n private credentials";
 export declare const SYSTEM_RESOLVER_TYPE = "credential-resolver.n8n-1.0";