n8n 2.27.2 → 2.28.0

package/dist/modules/agents/agent-knowledge-retrieval.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readKnowledgeInputSchema = exports.globKnowledgeFilesInputSchema = exports.searchKnowledgeInputSchema = exports.MAX_READ_RANGES = exports.MAX_SEARCH_CONTEXT_LINES = exports.MAX_OPERATION_OUTPUT_CHARS = exports.MAX_READ_LINE_CHARS = exports.MAX_SEARCH_LINE_CHARS = exports.DEFAULT_GLOB_FILES_LIMIT = exports.DEFAULT_SEARCH_TEXT_LIMIT = void 0;
+exports.parseSearchKnowledgeRequest = parseSearchKnowledgeRequest;
+exports.parseGlobKnowledgeFilesRequest = parseGlobKnowledgeFilesRequest;
+exports.parseReadKnowledgeRequest = parseReadKnowledgeRequest;
+exports.assertValidKnowledgeFilePath = assertValidKnowledgeFilePath;
+exports.truncateKnowledgeText = truncateKnowledgeText;
+const bad_request_error_1 = require("../../errors/response-errors/bad-request.error");
+const zod_1 = require("zod");
+const agent_knowledge_storage_1 = require("./agent-knowledge-storage");
+const MAX_SEARCH_PATTERN_LENGTH = 500;
+const MAX_GLOB_PATTERN_LENGTH = 255;
+const MAX_FILE_PATH_LENGTH = 512;
+const MAX_SEARCH_TEXT_LIMIT = 100;
+const MAX_GLOB_FILES_LIMIT = 100;
+const MAX_FILE_ID_LENGTH = 64;
+const MAX_SEARCH_PATHS = 20;
+exports.DEFAULT_SEARCH_TEXT_LIMIT = 20;
+exports.DEFAULT_GLOB_FILES_LIMIT = 20;
+exports.MAX_SEARCH_LINE_CHARS = 500;
+exports.MAX_READ_LINE_CHARS = 2_000;
+exports.MAX_OPERATION_OUTPUT_CHARS = 20_000;
+exports.MAX_SEARCH_CONTEXT_LINES = 10;
+exports.MAX_READ_RANGES = 10;
+const filePathSchema = zod_1.z.string().trim().min(1).max(MAX_FILE_PATH_LENGTH);
+const searchPathValueSchema = filePathSchema.refine((path) => path !== '*', {
+    message: 'Use exact knowledge file paths returned by find_file',
+});
+const searchPathSchema = zod_1.z.preprocess((value) => (typeof value === 'string' ? [value] : value), zod_1.z.array(searchPathValueSchema).min(1).max(MAX_SEARCH_PATHS));
+const fileIdSchema = zod_1.z.string().trim().min(1).max(MAX_FILE_ID_LENGTH);
+const searchPatternSchema = zod_1.z.string().trim().min(1).max(MAX_SEARCH_PATTERN_LENGTH);
+const globPatternSchema = zod_1.z.string().trim().min(1).max(MAX_GLOB_PATTERN_LENGTH);
+const searchOutputModeSchema = zod_1.z.enum(['content', 'files_with_matches', 'count']);
+const searchContextFlagSchema = zod_1.z.number().int().min(0).max(exports.MAX_SEARCH_CONTEXT_LINES);
+const broadExtensionGlobPattern = /^(?:\*\*\/)?\*\.[A-Za-z0-9][A-Za-z0-9.-]*$/;
+exports.searchKnowledgeInputSchema = zod_1.z
+    .object({
+    pattern: searchPatternSchema.describe('Ripgrep regex pattern to search for in uploaded knowledge file contents. This is line-based regex search, not semantic search. Simple words and phrases usually work as-is; escape punctuation-heavy literals when needed.'),
+    path: searchPathSchema.describe('Required uploaded knowledge file path or paths to search within. Pass one exact file value or an array of exact file values copied from previous knowledge tool results. Global search is not supported.'),
+    output_mode: searchOutputModeSchema
+        .optional()
+        .describe('Optional output mode. Defaults to content. Use files_with_matches to identify matching uploaded files without snippets, or count to compare match frequency by file.'),
+    head_limit: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_SEARCH_TEXT_LIMIT)
+        .optional()
+        .describe('Optional maximum number of results to return. Use a small value such as 5-20, then narrow the pattern if results have hasMore or truncated.'),
+    '-C': searchContextFlagSchema
+        .optional()
+        .describe('Optional symmetric context lines around each content match, equivalent to ripgrep -C. Use 0 or omit for no surrounding context.'),
+    '-i': zod_1.z
+        .boolean()
+        .optional()
+        .describe('Optional case-insensitive search flag. Defaults to true for uploaded knowledge search; set false only when capitalization matters.'),
+})
+    .strict();
+exports.globKnowledgeFilesInputSchema = zod_1.z
+    .object({
+    pattern: globPatternSchema.describe('Specific simple filename pattern matched against uploaded knowledge file names, not file contents. Supports * and ? wildcards and is case-insensitive by default. Use when the user gives title or filename clues, e.g. *query*configuration* or *semantic*competition*. Do not use catch-all, extension-only, absolute, or placeholder patterns.'),
+    limit: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_GLOB_FILES_LIMIT)
+        .optional()
+        .describe('Optional maximum number of candidate files to return. Use a small value such as 5-20 and make the pattern more specific if hasMore is true.'),
+    caseSensitive: zod_1.z
+        .boolean()
+        .optional()
+        .describe('Optional. Defaults to false for case-insensitive filename matching. Set true only when filename capitalization is part of the exact evidence you need.'),
+})
+    .strict()
+    .superRefine((input, ctx) => {
+    const segments = input.pattern.split('/');
+    if (input.pattern.startsWith('/') ||
+        input.pattern.includes('\\') ||
+        (0, agent_knowledge_storage_1.hasControlCharacter)(input.pattern) ||
+        segments.some((segment) => segment === '.' || segment === '..' || segment.length === 0)) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['pattern'],
+            message: 'Invalid knowledge file pattern',
+        });
+    }
+    if (input.pattern === '*' || broadExtensionGlobPattern.test(input.pattern)) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['pattern'],
+            message: 'Use a narrower filename pattern than catch-all or extension-only patterns',
+        });
+    }
+});
+exports.readKnowledgeInputSchema = zod_1.z
+    .object({
+    file: filePathSchema
+        .optional()
+        .describe('Uploaded knowledge file path to read. Use only an exact `file` value copied from a previous knowledge tool result. Required unless `fileId` is provided.'),
+    fileId: fileIdSchema
+        .optional()
+        .describe('Uploaded knowledge file ID to read. Use only an exact `fileId` copied from a previous knowledge tool result. Required unless `file` is provided.'),
+    ranges: zod_1.z
+        .array(zod_1.z
+        .object({
+        startLine: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .describe('First 1-based line number to read, usually near a search_text match. Keep ranges narrow enough for citation-ready evidence.'),
+        endLine: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .describe('Last 1-based line number to read. Must be greater than or equal to startLine. Prefer short ranges around the evidence.'),
+    })
+        .strict())
+        .min(1)
+        .max(exports.MAX_READ_RANGES)
+        .optional()
+        .describe('Optional line ranges to read from the selected file. Prefer bounded ranges from search_text matches; omit only when full-file context is genuinely needed and output truncation is acceptable.'),
+})
+    .strict()
+    .superRefine((input, ctx) => {
+    if (!input.file && !input.fileId) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: 'Provide file or fileId',
+        });
+    }
+    for (const [index, range] of (input.ranges ?? []).entries()) {
+        if (range.endLine < range.startLine) {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                path: ['ranges', index, 'endLine'],
+                message: 'endLine must be greater than or equal to startLine',
+            });
+        }
+    }
+});
+function parseSearchKnowledgeRequest(input) {
+    return exports.searchKnowledgeInputSchema.parse(input);
+}
+function parseGlobKnowledgeFilesRequest(input) {
+    return exports.globKnowledgeFilesInputSchema.parse(input);
+}
+function parseReadKnowledgeRequest(input) {
+    return exports.readKnowledgeInputSchema.parse(input);
+}
+function assertValidKnowledgeFilePath(filePath) {
+    const trimmed = filePath.trim();
+    if (!trimmed ||
+        trimmed.length > MAX_FILE_PATH_LENGTH ||
+        trimmed.startsWith('/') ||
+        trimmed.includes('\\') ||
+        (0, agent_knowledge_storage_1.hasControlCharacter)(trimmed)) {
+        throw new bad_request_error_1.BadRequestError('Invalid knowledge file path');
+    }
+    const segments = trimmed.split('/');
+    if (segments.some((segment) => segment === '.' || segment === '..' || segment.length === 0)) {
+        throw new bad_request_error_1.BadRequestError('Invalid knowledge file path');
+    }
+    return trimmed;
+}
+function truncateKnowledgeText(text, maxLength) {
+    if (text.length <= maxLength) {
+        return { text, truncated: false };
+    }
+    return { text: text.slice(0, maxLength), truncated: true };
+}
+//# sourceMappingURL=agent-knowledge-retrieval.js.map

package/dist/modules/agents/agent-knowledge-retrieval.js.map

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

package/dist/modules/agents/agent-knowledge-sandbox.service.d.ts

@@ -0,0 +1,40 @@
+import { Logger } from '@n8n/backend-common';
+import { AgentsConfig } from '@n8n/config';
+import { InstanceSettings } from 'n8n-core';
+import { AiService } from '../../services/ai.service';
+import { type AgentKnowledgeFilesystem } from './agent-knowledge-storage';
+import { type GlobKnowledgeFilesRequest, type GlobKnowledgeFilesResult, type ReadKnowledgeRequest, type ReadKnowledgeResult, type SearchKnowledgeRequest, type SearchKnowledgeResult } from './agent-knowledge-retrieval';
+import { AgentFileRepository } from './repositories/agent-file.repository';
+import { AgentRepository } from './repositories/agent.repository';
+export declare const AGENT_KNOWLEDGE_SANDBOX_NAME_PREFIX = "agents-knowledgebase";
+export declare class AgentKnowledgeSandboxService {
+    private readonly agentsConfig;
+    private readonly logger;
+    private readonly aiService;
+    private readonly instanceSettings;
+    private readonly agentFileRepository;
+    private readonly agentRepository;
+    private readonly pendingSandboxAcquisitions;
+    constructor(agentsConfig: AgentsConfig, logger: Logger, aiService: AiService, instanceSettings: InstanceSettings, agentFileRepository: AgentFileRepository, agentRepository: AgentRepository);
+    withKnowledgeFilesystem<T>(projectId: string, agentId: string, userId: string, operation: (filesystem: AgentKnowledgeFilesystem) => Promise<T>): Promise<T>;
+    warmSandbox(projectId: string, agentId: string, userId: string): Promise<void>;
+    searchKnowledge(projectId: string, agentId: string, userId: string, request: SearchKnowledgeRequest): Promise<SearchKnowledgeResult>;
+    globKnowledgeFiles(projectId: string, agentId: string, _userId: string, request: GlobKnowledgeFilesRequest): Promise<GlobKnowledgeFilesResult>;
+    readKnowledge(projectId: string, agentId: string, userId: string, request: ReadKnowledgeRequest): Promise<ReadKnowledgeResult>;
+    private executeKnowledgeOperation;
+    private loadKnowledgeReferenceLookup;
+    private loadKnowledgeFileReferences;
+    private resolveRequiredFile;
+    private resolveOptionalFile;
+    private createFilesystemAdapter;
+    private acquireSandbox;
+    private acquireSandboxFresh;
+    private resolveDaytonaConnection;
+    private buildVolumeMount;
+    private resolveSandboxByName;
+    private resolveReusableSandbox;
+    private assertKnowledgeAccess;
+    private assertKnowledgeConfiguration;
+    private assertValidPathSegments;
+    private assertKnowledgeBaseEnabled;
+}