n8n 2.45.6 → 2.46.1

package/dist/modules/agents/agent-knowledge-snapshot.service.js

@@ -0,0 +1,84 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentKnowledgeSnapshotService = void 0;
+const di_1 = require("@n8n/di");
+const agent_file_repository_1 = require("./repositories/agent-file.repository");
+const agent_repository_1 = require("./repositories/agent.repository");
+const PAGE_SIZE = 500;
+let AgentKnowledgeSnapshotService = class AgentKnowledgeSnapshotService {
+    constructor(agentRepository, agentFileRepository) {
+        this.agentRepository = agentRepository;
+        this.agentFileRepository = agentFileRepository;
+    }
+    async collect(signal) {
+        const snapshot = emptySnapshot();
+        for await (const page of this.publishedAgentPages(signal)) {
+            const agentIds = page.map((agent) => agent.agentId);
+            const totalsByAgentId = await this.agentFileRepository.getKnowledgeTotalsByAgentIds(agentIds);
+            for (const agent of page) {
+                const fileTotals = totalsByAgentId.get(agent.agentId);
+                addAgentDataToSnapshot(snapshot, agent, fileTotals);
+            }
+        }
+        return snapshot;
+    }
+    async *publishedAgentPages(signal) {
+        let afterId = null;
+        let page;
+        do {
+            page = await this.agentRepository.findPublishedVectorStoreProvidersPage(afterId, PAGE_SIZE);
+            if (page.length > 0) {
+                yield page;
+                afterId = page[page.length - 1].agentId;
+            }
+        } while (page.length === PAGE_SIZE && !signal?.aborted);
+    }
+};
+exports.AgentKnowledgeSnapshotService = AgentKnowledgeSnapshotService;
+exports.AgentKnowledgeSnapshotService = AgentKnowledgeSnapshotService = __decorate([
+    (0, di_1.Service)(),
+    __metadata("design:paramtypes", [agent_repository_1.AgentRepository, agent_file_repository_1.AgentFileRepository])
+], AgentKnowledgeSnapshotService);
+function emptySnapshot() {
+    return {
+        published_agent_count: 0,
+        published_with_files_count: 0,
+        published_with_vector_stores_count: 0,
+        published_with_both_count: 0,
+        knowledge_file_count: 0,
+        knowledge_total_bytes: 0,
+        vector_store_count: 0,
+        vector_store_providers: {},
+    };
+}
+function addAgentDataToSnapshot(snapshot, { vectorStoreProviders }, fileTotals) {
+    const hasFiles = fileTotals !== undefined && fileTotals.fileCount > 0;
+    const hasVectorStores = vectorStoreProviders.length > 0;
+    snapshot.published_agent_count++;
+    if (hasFiles) {
+        snapshot.published_with_files_count++;
+        snapshot.knowledge_file_count += fileTotals.fileCount;
+        snapshot.knowledge_total_bytes += fileTotals.totalBytes;
+    }
+    if (hasVectorStores) {
+        snapshot.published_with_vector_stores_count++;
+        snapshot.vector_store_count += vectorStoreProviders.length;
+    }
+    if (hasFiles && hasVectorStores) {
+        snapshot.published_with_both_count++;
+    }
+    for (const provider of vectorStoreProviders) {
+        snapshot.vector_store_providers[provider] =
+            (snapshot.vector_store_providers[provider] ?? 0) + 1;
+    }
+}
+//# sourceMappingURL=agent-knowledge-snapshot.service.js.map

package/dist/modules/agents/agent-knowledge-snapshot.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-knowledge-snapshot.service.js","sourceRoot":"","sources":["../../../src/modules/agents/agent-knowledge-snapshot.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,gCAAkC;AAElC,gFAG8C;AAC9C,sEAAmG;AAEnG,MAAM,SAAS,GAAG,GAAG,CAAC;AAef,IAAM,6BAA6B,GAAnC,MAAM,6BAA6B;IACzC,YACkB,eAAgC,EAChC,mBAAwC;+BADxC,eAAe;mCACf,mBAAmB;IAClC,CAAC;IAGJ,KAAK,CAAC,OAAO,CAAC,MAAoB;QACjC,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;QAEjC,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACpD,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,4BAA4B,CAAC,QAAQ,CAAC,CAAC;YAE9F,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;gBAC1B,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACtD,sBAAsB,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;YACrD,CAAC;QACF,CAAC;QAED,OAAO,QAAQ,CAAC;IACjB,CAAC;IAGO,KAAK,CAAC,CAAC,mBAAmB,CACjC,MAAoB;QAEpB,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,IAAI,IAAkC,CAAC;QAEvC,GAAG,CAAC;YACH,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,qCAAqC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAE5F,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,IAAI,CAAC;gBACX,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;YACzC,CAAC;QACF,CAAC,QAAQ,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE;IACzD,CAAC;CACD,CAAA;;wCAvCY,6BAA6B;IADzC,IAAA,YAAO,GAAE;qCAG0B,kCAAe,EACX,2CAAmB;GAH9C,6BAA6B,CAuCzC;AAED,SAAS,aAAa;IACrB,OAAO;QACN,qBAAqB,EAAE,CAAC;QACxB,0BAA0B,EAAE,CAAC;QAC7B,kCAAkC,EAAE,CAAC;QACrC,yBAAyB,EAAE,CAAC;QAC5B,oBAAoB,EAAE,CAAC;QACvB,qBAAqB,EAAE,CAAC;QACxB,kBAAkB,EAAE,CAAC;QACrB,sBAAsB,EAAE,EAAE;KAC1B,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAC9B,QAAgC,EAChC,EAAE,oBAAoB,EAA8B,EACpD,UAA4C;IAE5C,MAAM,QAAQ,GAAG,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,SAAS,GAAG,CAAC,CAAC;IACtE,MAAM,eAAe,GAAG,oBAAoB,CAAC,MAAM,GAAG,CAAC,CAAC;IAExD,QAAQ,CAAC,qBAAqB,EAAE,CAAC;IAEjC,IAAI,QAAQ,EAAE,CAAC;QACd,QAAQ,CAAC,0BAA0B,EAAE,CAAC;QACtC,QAAQ,CAAC,oBAAoB,IAAI,UAAU,CAAC,SAAS,CAAC;QACtD,QAAQ,CAAC,qBAAqB,IAAI,UAAU,CAAC,UAAU,CAAC;IACzD,CAAC;IAED,IAAI,eAAe,EAAE,CAAC;QACrB,QAAQ,CAAC,kCAAkC,EAAE,CAAC;QAC9C,QAAQ,CAAC,kBAAkB,IAAI,oBAAoB,CAAC,MAAM,CAAC;IAC5D,CAAC;IAED,IAAI,QAAQ,IAAI,eAAe,EAAE,CAAC;QACjC,QAAQ,CAAC,yBAAyB,EAAE,CAAC;IACtC,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,oBAAoB,EAAE,CAAC;QAC7C,QAAQ,CAAC,sBAAsB,CAAC,QAAQ,CAAC;YACxC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC;AACF,CAAC"}

package/dist/modules/agents/agent-knowledge-snapshot.task.d.ts

@@ -0,0 +1,13 @@
+import { SystemTask } from '@n8n/decorators';
+import type { SystemTaskSchedule } from '@n8n/decorators';
+import { Telemetry } from '../../telemetry';
+import { AgentKnowledgeSnapshotService } from './agent-knowledge-snapshot.service';
+export declare class AgentKnowledgeSnapshotTask implements SystemTask {
+    private readonly snapshotService;
+    private readonly telemetry;
+    readonly name = "agent-knowledge-snapshot";
+    readonly schedule: SystemTaskSchedule;
+    readonly target: import("@n8n/decorators").ClusterTarget;
+    constructor(snapshotService: AgentKnowledgeSnapshotService, telemetry: Telemetry);
+    run(signal: AbortSignal): Promise<void>;
+}

package/dist/modules/agents/agent-knowledge-snapshot.task.js

@@ -0,0 +1,48 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentKnowledgeSnapshotTask = void 0;
+const constants_1 = require("@n8n/constants");
+const decorators_1 = require("@n8n/decorators");
+const telemetry_1 = require("@n8n/telemetry");
+const telemetry_2 = require("../../telemetry");
+const agent_knowledge_snapshot_service_1 = require("./agent-knowledge-snapshot.service");
+let AgentKnowledgeSnapshotTask = class AgentKnowledgeSnapshotTask {
+    constructor(snapshotService, telemetry) {
+        this.snapshotService = snapshotService;
+        this.telemetry = telemetry;
+        this.name = 'agent-knowledge-snapshot';
+        this.schedule = (0, decorators_1.intervalFromSeconds)(constants_1.Time.days.toSeconds);
+        this.target = (0, decorators_1.clusterTarget)({
+            scheduler: {
+                retryOnFailure: false,
+                missedAfterSeconds: constants_1.Time.hours.toSeconds,
+                catchUp: true,
+            },
+        });
+    }
+    async run(signal) {
+        const snapshot = await this.snapshotService.collect(signal);
+        if (signal.aborted) {
+            return;
+        }
+        if (snapshot.published_agent_count === 0) {
+            return;
+        }
+        this.telemetry.track(telemetry_1.TELEMETRY_EVENT.AGENTS.AGENT_KNOWLEDGE_SNAPSHOT, snapshot);
+    }
+};
+exports.AgentKnowledgeSnapshotTask = AgentKnowledgeSnapshotTask;
+exports.AgentKnowledgeSnapshotTask = AgentKnowledgeSnapshotTask = __decorate([
+    (0, decorators_1.SystemTask)(),
+    __metadata("design:paramtypes", [agent_knowledge_snapshot_service_1.AgentKnowledgeSnapshotService, telemetry_2.Telemetry])
+], AgentKnowledgeSnapshotTask);
+//# sourceMappingURL=agent-knowledge-snapshot.task.js.map

package/dist/modules/agents/agent-knowledge-snapshot.task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-knowledge-snapshot.task.js","sourceRoot":"","sources":["../../../src/modules/agents/agent-knowledge-snapshot.task.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,8CAAsC;AACtC,gDAAiF;AAEjF,8CAAiD;AAEjD,2CAAwC;AAExC,yFAAmF;AAQ5E,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;IAkBtC,YACkB,eAA8C,EAC9C,SAAoB;QADpB,oBAAe,GAAf,eAAe,CAA+B;QAC9C,cAAS,GAAT,SAAS,CAAW;QAnB7B,SAAI,GAAG,0BAA0B,CAAC;QAGlC,aAAQ,GAAuB,IAAA,gCAAmB,EAAC,gBAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAGxE,WAAM,GAAG,IAAA,0BAAa,EAAC;YAC/B,SAAS,EAAE;gBAEV,cAAc,EAAE,KAAK;gBAErB,kBAAkB,EAAE,gBAAI,CAAC,KAAK,CAAC,SAAS;gBAExC,OAAO,EAAE,IAAI;aACb;SACD,CAAC,CAAC;IAKA,CAAC;IAEJ,KAAK,CAAC,GAAG,CAAC,MAAmB;QAC5B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAG5D,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;QACR,CAAC;QAGD,IAAI,QAAQ,CAAC,qBAAqB,KAAK,CAAC,EAAE,CAAC;YAC1C,OAAO;QACR,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,2BAAe,CAAC,MAAM,CAAC,wBAAwB,EAAE,QAAQ,CAAC,CAAC;IACjF,CAAC;CACD,CAAA;;qCAtCY,0BAA0B;IADtC,IAAA,uBAAU,GAAE;qCAoBuB,gEAA6B,EACnC,qBAAS;GApB1B,0BAA0B,CAsCtC"}

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

@@ -10,7 +10,7 @@ exports.storageFileNameForOriginalFileName = storageFileNameForOriginalFileName;
 exports.toAgentFileDto = toAgentFileDto;
 const sandbox_1 = require("@n8n/agents/sandbox");
 const node_path_1 = __importDefault(require("node:path"));
-const errors_1 = require("@n8n/errors");
+const agent_knowledge_upload_error_1 = require("./agent-knowledge-upload.error");
 function getAgentKnowledgePaths(provider) {
     const home = node_path_1.default.dirname((0, sandbox_1.getPromptWorkspaceRoot)(provider));
     const mirrorDir = `${home}/knowledge-mirror`;
@@ -47,7 +47,7 @@ function sanitizeStorageFileName(originalName) {
     const basename = node_path_1.default.basename(originalName);
     const sanitized = Array.from(basename, sanitizePathCharacter).join('');
     if (!sanitized || sanitized === '.' || sanitized === '..') {
-        throw new errors_1.BadRequestError(`Invalid knowledge file name "${originalName}"`);
+        throw new agent_knowledge_upload_error_1.AgentKnowledgeUploadError(`Invalid knowledge file name "${originalName}"`, 'invalid_file_name');
     }
     return sanitized;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"agent-knowledge-storage.js","sourceRoot":"","sources":["../../../src/modules/agents/agent-knowledge-storage.ts"],"names":[],"mappings":";;;;;;;;;;AACA,iDAAmF;AACnF,0DAA6B;AAE7B,wCAA8C;AAU9C,gCAAuC,QAAyB;IAC/D,MAAM,IAAI,GAAG,mBAAI,CAAC,OAAO,CAAC,IAAA,gCAAsB,EAAC,QAAQ,CAAC,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,GAAG,IAAI,mBAAmB,CAAC;IAC7C,OAAO;QACN,QAAQ,EAAE,GAAG,SAAS,QAAQ;QAC9B,QAAQ,EAAE,GAAG,SAAS,WAAW;QACjC,UAAU,EAAE,GAAG,SAAS,WAAW;KACnC,CAAC;AACH,CAAC;AAED,6BAAoC,KAAa;IAChD,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;QAC/B,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,SAAS,qBAAqB,CAAC,SAAiB;IAC/C,IAAI,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;QAC7E,OAAO,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,oCAA2C,OAAe,EAAE,KAAa;IACxE,IACC,CAAC,OAAO;QACR,OAAO,KAAK,GAAG;QACf,OAAO,KAAK,IAAI;QAChB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QACrB,mBAAmB,CAAC,OAAO,CAAC,EAC3B,CAAC;QACF,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,8BAA8B,CAAC,CAAC;IACjE,CAAC;AACF,CAAC;AAED,SAAS,uBAAuB,CAAC,YAAoB;IACpD,MAAM,QAAQ,GAAG,mBAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAGvE,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QAC3D,MAAM,IAAI,wBAAe,CAAC,gCAAgC,YAAY,GAAG,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,4CAAmD,gBAAwB;IAC1E,MAAM,aAAa,GAAG,uBAAuB,CAAC,gBAAgB,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,mBAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5D,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,mBAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,mBAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;QAC3E,OAAO,GAAG,QAAQ,MAAM,CAAC;IAC1B,CAAC;IACD,OAAO,aAAa,CAAC;AACtB,CAAC;AAED,wBAA+B,IAAe;IAC7C,OAAO;QACN,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;KACvC,CAAC;AACH,CAAC"}
+{"version":3,"file":"agent-knowledge-storage.js","sourceRoot":"","sources":["../../../src/modules/agents/agent-knowledge-storage.ts"],"names":[],"mappings":";;;;;;;;;;AACA,iDAAmF;AACnF,0DAA6B;AAE7B,iFAA2E;AAS3E,gCAAuC,QAAyB;IAC/D,MAAM,IAAI,GAAG,mBAAI,CAAC,OAAO,CAAC,IAAA,gCAAsB,EAAC,QAAQ,CAAC,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,GAAG,IAAI,mBAAmB,CAAC;IAC7C,OAAO;QACN,QAAQ,EAAE,GAAG,SAAS,QAAQ;QAC9B,QAAQ,EAAE,GAAG,SAAS,WAAW;QACjC,UAAU,EAAE,GAAG,SAAS,WAAW;KACnC,CAAC;AACH,CAAC;AAED,6BAAoC,KAAa;IAChD,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;QAC/B,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,SAAS,qBAAqB,CAAC,SAAiB;IAC/C,IAAI,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;QAC7E,OAAO,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,oCAA2C,OAAe,EAAE,KAAa;IACxE,IACC,CAAC,OAAO;QACR,OAAO,KAAK,GAAG;QACf,OAAO,KAAK,IAAI;QAChB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QACrB,mBAAmB,CAAC,OAAO,CAAC,EAC3B,CAAC;QACF,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,8BAA8B,CAAC,CAAC;IACjE,CAAC;AACF,CAAC;AAED,SAAS,uBAAuB,CAAC,YAAoB;IACpD,MAAM,QAAQ,GAAG,mBAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAGvE,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QAC3D,MAAM,IAAI,wDAAyB,CAClC,gCAAgC,YAAY,GAAG,EAC/C,mBAAmB,CACnB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,4CAAmD,gBAAwB;IAC1E,MAAM,aAAa,GAAG,uBAAuB,CAAC,gBAAgB,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,mBAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5D,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,mBAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,mBAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;QAC3E,OAAO,GAAG,QAAQ,MAAM,CAAC;IAC1B,CAAC;IACD,OAAO,aAAa,CAAC;AACtB,CAAC;AAED,wBAA+B,IAAe;IAC7C,OAAO;QACN,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;KACvC,CAAC;AACH,CAAC"}

package/dist/modules/agents/agent-knowledge-telemetry.d.ts

@@ -0,0 +1,3 @@
+import type { AgentJsonVectorStoreConfig } from '@n8n/api-types';
+export declare function createKnowledgeTelemetryHmac(instanceSecret: string): import("crypto").Hmac;
+export declare function buildVectorStoreFingerprints(stores: AgentJsonVectorStoreConfig[], instanceSecret: string): string[];

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

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createKnowledgeTelemetryHmac = createKnowledgeTelemetryHmac;
+exports.buildVectorStoreFingerprints = buildVectorStoreFingerprints;
+const node_crypto_1 = require("node:crypto");
+const KNOWLEDGE_TELEMETRY_KEY_LABEL = 'agent-knowledge-telemetry';
+function createKnowledgeTelemetryHmac(instanceSecret) {
+    const key = (0, node_crypto_1.createHmac)('sha256', instanceSecret).update(KNOWLEDGE_TELEMETRY_KEY_LABEL).digest();
+    return (0, node_crypto_1.createHmac)('sha256', key);
+}
+function vectorStoreIdentity(store) {
+    switch (store.provider) {
+        case 'pinecone':
+            return store.namespace ? [store.indexName, store.namespace] : [store.indexName];
+        case 'qdrant':
+            return [store.collectionName];
+        case 'supabase':
+        case 'postgres':
+            return [store.tableName];
+    }
+}
+function buildVectorStoreFingerprints(stores, instanceSecret) {
+    const fingerprints = stores.map((store) => createKnowledgeTelemetryHmac(instanceSecret)
+        .update(JSON.stringify([store.provider, ...vectorStoreIdentity(store)]))
+        .digest('hex'));
+    return [...new Set(fingerprints)].sort();
+}
+//# sourceMappingURL=agent-knowledge-telemetry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-knowledge-telemetry.js","sourceRoot":"","sources":["../../../src/modules/agents/agent-knowledge-telemetry.ts"],"names":[],"mappings":";;;;AACA,6CAAyC;AAEzC,MAAM,6BAA6B,GAAG,2BAA2B,CAAC;AAMlE,sCAA6C,cAAsB;IAClE,MAAM,GAAG,GAAG,IAAA,wBAAU,EAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,MAAM,CAAC,6BAA6B,CAAC,CAAC,MAAM,EAAE,CAAC;IAChG,OAAO,IAAA,wBAAU,EAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC;AAGD,SAAS,mBAAmB,CAAC,KAAiC;IAC7D,QAAQ,KAAK,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,UAAU;YACd,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACjF,KAAK,QAAQ;YACZ,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC/B,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU;YACd,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;AACF,CAAC;AAED,sCACC,MAAoC,EACpC,cAAsB;IAEtB,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACzC,4BAA4B,CAAC,cAAc,CAAC;SAC1C,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACvE,MAAM,CAAC,KAAK,CAAC,CACf,CAAC;IACF,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC"}

package/dist/modules/agents/agent-knowledge-upload.error.d.ts

@@ -0,0 +1,11 @@
+import { BadRequestError } from '@n8n/errors';
+import type { InferTelemetryProps, TELEMETRY_EVENT } from '@n8n/telemetry';
+type KnowledgeUploadFailure = Extract<InferTelemetryProps<typeof TELEMETRY_EVENT.AGENTS.USER_FAILED_AGENT_KNOWLEDGE_UPLOAD>, {
+    stage: 'server';
+}>;
+export type AgentKnowledgeUploadFailureReason = Exclude<KnowledgeUploadFailure['reason'], 'unknown'>;
+export declare class AgentKnowledgeUploadError extends BadRequestError {
+    readonly reason: AgentKnowledgeUploadFailureReason;
+    constructor(message: string, reason: AgentKnowledgeUploadFailureReason);
+}
+export {};

package/dist/modules/agents/agent-knowledge-upload.error.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentKnowledgeUploadError = void 0;
+const errors_1 = require("@n8n/errors");
+class AgentKnowledgeUploadError extends errors_1.BadRequestError {
+    constructor(message, reason) {
+        super(message);
+        this.reason = reason;
+    }
+}
+exports.AgentKnowledgeUploadError = AgentKnowledgeUploadError;
+//# sourceMappingURL=agent-knowledge-upload.error.js.map

package/dist/modules/agents/agent-knowledge-upload.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-knowledge-upload.error.js","sourceRoot":"","sources":["../../../src/modules/agents/agent-knowledge-upload.error.ts"],"names":[],"mappings":";;;AAAA,wCAA8C;AAkB9C,+BAAuC,SAAQ,wBAAe;IAC7D,YACC,OAAe,EACN,MAAyC;QAElD,KAAK,CAAC,OAAO,CAAC,CAAC;sBAFN,MAAM;IAGhB,CAAC;CACD"}

package/dist/modules/agents/agent-knowledge-usage-tracker.d.ts

@@ -0,0 +1,33 @@
+import type { AgentRunTelemetryType } from '../../interfaces';
+import { Telemetry } from '../../telemetry';
+export type KnowledgeToolCall = 'file_find' | 'file_search' | 'file_read' | 'vector_store_search';
+export type KnowledgeToolCallResult = {
+    failed: false;
+    contentChars: number;
+} | {
+    failed: true;
+};
+export type FinishKnowledgeToolCall = (result: KnowledgeToolCallResult) => void;
+export interface KnowledgeRunUsage {
+    file_find_count: number;
+    file_search_count: number;
+    file_read_count: number;
+    vector_store_search_count: number;
+    file_content_chars: number;
+    vector_store_content_chars: number;
+    file_failed_count: number;
+    vector_store_failed_count: number;
+}
+export declare class AgentKnowledgeUsageTracker {
+    private readonly telemetry;
+    private readonly runs;
+    constructor(telemetry: Telemetry);
+    sendRunUsage(runId: string, run: {
+        agentId: string;
+        runType: AgentRunTelemetryType;
+        userId?: string;
+    }): void;
+    startToolCall(runId: string | undefined, call: KnowledgeToolCall): FinishKnowledgeToolCall;
+    takeRunUsage(runId: string): KnowledgeRunUsage | undefined;
+    private removeStaleRuns;
+}

package/dist/modules/agents/agent-knowledge-usage-tracker.js

@@ -0,0 +1,107 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentKnowledgeUsageTracker = void 0;
+const constants_1 = require("@n8n/constants");
+const di_1 = require("@n8n/di");
+const telemetry_1 = require("@n8n/telemetry");
+const telemetry_2 = require("../../telemetry");
+const usageKeyByCall = {
+    file_find: 'file_find_count',
+    file_search: 'file_search_count',
+    file_read: 'file_read_count',
+    vector_store_search: 'vector_store_search_count',
+};
+const contentKeyByCall = {
+    file_find: 'file_content_chars',
+    file_search: 'file_content_chars',
+    file_read: 'file_content_chars',
+    vector_store_search: 'vector_store_content_chars',
+};
+const failedKeyByCall = {
+    file_find: 'file_failed_count',
+    file_search: 'file_failed_count',
+    file_read: 'file_failed_count',
+    vector_store_search: 'vector_store_failed_count',
+};
+const STALE_RUN_MS = constants_1.Time.days.toMilliseconds;
+let AgentKnowledgeUsageTracker = class AgentKnowledgeUsageTracker {
+    constructor(telemetry) {
+        this.telemetry = telemetry;
+        this.runs = new Map();
+    }
+    sendRunUsage(runId, run) {
+        const usage = this.takeRunUsage(runId);
+        if (!usage) {
+            return;
+        }
+        this.telemetry.track(telemetry_1.TELEMETRY_EVENT.AGENTS.AGENT_RUN_USED_KNOWLEDGE, {
+            agent_id: run.agentId,
+            run_id: runId,
+            run_type: run.runType,
+            ...(run.userId ? { user_id: run.userId } : {}),
+            ...usage,
+        });
+    }
+    startToolCall(runId, call) {
+        if (!runId) {
+            return () => { };
+        }
+        const now = Date.now();
+        this.removeStaleRuns(now);
+        const run = this.runs.get(runId) ?? { usage: emptyUsage(), lastCallAt: now };
+        run.usage[usageKeyByCall[call]]++;
+        run.lastCallAt = now;
+        this.runs.set(runId, run);
+        return (result) => {
+            if (this.runs.get(runId) !== run) {
+                return;
+            }
+            if (result.failed) {
+                run.usage[failedKeyByCall[call]]++;
+            }
+            else {
+                run.usage[contentKeyByCall[call]] += result.contentChars;
+            }
+            run.lastCallAt = Date.now();
+        };
+    }
+    takeRunUsage(runId) {
+        const run = this.runs.get(runId);
+        this.runs.delete(runId);
+        return run?.usage;
+    }
+    removeStaleRuns(now) {
+        for (const [runId, run] of this.runs) {
+            if (now - run.lastCallAt > STALE_RUN_MS) {
+                this.runs.delete(runId);
+            }
+        }
+    }
+};
+exports.AgentKnowledgeUsageTracker = AgentKnowledgeUsageTracker;
+exports.AgentKnowledgeUsageTracker = AgentKnowledgeUsageTracker = __decorate([
+    (0, di_1.Service)(),
+    __metadata("design:paramtypes", [telemetry_2.Telemetry])
+], AgentKnowledgeUsageTracker);
+function emptyUsage() {
+    return {
+        file_find_count: 0,
+        file_search_count: 0,
+        file_read_count: 0,
+        vector_store_search_count: 0,
+        file_content_chars: 0,
+        vector_store_content_chars: 0,
+        file_failed_count: 0,
+        vector_store_failed_count: 0,
+    };
+}
+//# sourceMappingURL=agent-knowledge-usage-tracker.js.map

package/dist/modules/agents/agent-knowledge-usage-tracker.js.map

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

package/dist/modules/agents/agent-knowledge.controller.d.ts

@@ -1,13 +1,15 @@
 import type { AuthenticatedRequest } from '@n8n/db';
 import type { Response } from 'express';
+import { KnowledgeAvailabilityService } from '../../modules/knowledge/knowledge-availability.service';
+import { Telemetry } from '../../telemetry';
 import { AgentKnowledgeService } from './agent-knowledge.service';
 import { AgentRuntimeCacheService } from './agent-runtime-cache.service';
-import { AgentSandboxRuntimeService } from './agent-sandbox-runtime.service';
 export declare class AgentKnowledgeController {
     private readonly agentKnowledgeService;
-    private readonly agentSandboxRuntimeService;
+    private readonly knowledgeAvailabilityService;
     private readonly runtimeCacheService;
-    constructor(agentKnowledgeService: AgentKnowledgeService, agentSandboxRuntimeService: AgentSandboxRuntimeService, runtimeCacheService: AgentRuntimeCacheService);
+    private readonly telemetry;
+    constructor(agentKnowledgeService: AgentKnowledgeService, knowledgeAvailabilityService: KnowledgeAvailabilityService, runtimeCacheService: AgentRuntimeCacheService, telemetry: Telemetry);
     private assertKnowledgeBaseEnabled;
     listFiles(_req: AuthenticatedRequest<{
         projectId: string;
@@ -18,9 +20,11 @@ export declare class AgentKnowledgeController {
         files?: Express.Multer.File[];
         fileUploadError?: Error;
     }, _res: Response, projectId: string, agentId: string): Promise<import("@n8n/api-types").AgentFileDto[]>;
-    deleteFile(_req: AuthenticatedRequest<{
+    deleteFile(req: AuthenticatedRequest<{
         projectId: string;
     }>, _res: Response, projectId: string, agentId: string, fileId: string): Promise<{
         success: boolean;
     }>;
+    private trackUploadedFiles;
+    private trackUploadFailed;
 }

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

@@ -18,21 +18,26 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentKnowledgeController = void 0;
 const di_1 = require("@n8n/di");
 const decorators_1 = require("@n8n/decorators");
+const telemetry_1 = require("@n8n/telemetry");
 const multer_1 = __importDefault(require("multer"));
 const errors_1 = require("@n8n/errors");
+const knowledge_availability_service_1 = require("../../modules/knowledge/knowledge-availability.service");
+const telemetry_2 = require("../../telemetry");
+const agent_knowledge_upload_error_1 = require("./agent-knowledge-upload.error");
 const agent_knowledge_service_1 = require("./agent-knowledge.service");
 const agent_runtime_cache_service_1 = require("./agent-runtime-cache.service");
-const agent_sandbox_runtime_service_1 = require("./agent-sandbox-runtime.service");
 const agent_upload_middleware_1 = require("./agent-upload.middleware");
 const agentUploadMiddleware = di_1.Container.get(agent_upload_middleware_1.AgentUploadMiddleware);
+const KNOWLEDGE_FILES_FIELD = 'files';
 let AgentKnowledgeController = class AgentKnowledgeController {
-    constructor(agentKnowledgeService, agentSandboxRuntimeService, runtimeCacheService) {
+    constructor(agentKnowledgeService, knowledgeAvailabilityService, runtimeCacheService, telemetry) {
         this.agentKnowledgeService = agentKnowledgeService;
-        this.agentSandboxRuntimeService = agentSandboxRuntimeService;
+        this.knowledgeAvailabilityService = knowledgeAvailabilityService;
         this.runtimeCacheService = runtimeCacheService;
+        this.telemetry = telemetry;
     }
     assertKnowledgeBaseEnabled() {
-        if (!this.agentSandboxRuntimeService.isEnabled()) {
+        if (!this.knowledgeAvailabilityService.isFileKnowledgeEnabled()) {
             throw new errors_1.NotFoundError('Agent knowledge base is not enabled');
         }
     }
@@ -47,7 +52,11 @@ let AgentKnowledgeController = class AgentKnowledgeController {
             if (req.fileUploadError) {
                 const error = req.fileUploadError;
                 if (error instanceof multer_1.default.MulterError) {
-                    throw new errors_1.BadRequestError(`File upload error: ${(0, agent_upload_middleware_1.describeMulterError)(error)}`);
+                    const message = `File upload error: ${(0, agent_upload_middleware_1.describeMulterError)(error)}`;
+                    const reason = (0, agent_upload_middleware_1.multerFailureReason)(error, KNOWLEDGE_FILES_FIELD);
+                    throw reason
+                        ? new agent_knowledge_upload_error_1.AgentKnowledgeUploadError(message, reason)
+                        : new errors_1.BadRequestError(message);
                 }
                 throw error;
             }
@@ -56,19 +65,58 @@ let AgentKnowledgeController = class AgentKnowledgeController {
             }
             const uploadedFiles = await this.agentKnowledgeService.uploadFiles(agentId, projectId, files);
             this.runtimeCacheService.clearRuntimes(agentId);
-            return uploadedFiles;
+            this.trackUploadedFiles(req.user.id, projectId, agentId, uploadedFiles);
+            return uploadedFiles.map(({ file }) => file);
         }
         catch (error) {
             await (0, agent_upload_middleware_1.cleanupUploadedTempFiles)(files);
+            this.trackUploadFailed(req, projectId, agentId, files.length, error);
             throw error;
         }
     }
-    async deleteFile(_req, _res, projectId, agentId, fileId) {
+    async deleteFile(req, _res, projectId, agentId, fileId) {
         this.assertKnowledgeBaseEnabled();
-        await this.agentKnowledgeService.deleteFile(agentId, projectId, fileId);
+        const deleted = await this.agentKnowledgeService.deleteFile(agentId, projectId, fileId);
         this.runtimeCacheService.clearRuntimes(agentId);
+        if (deleted) {
+            this.telemetry.track(telemetry_1.TELEMETRY_EVENT.AGENTS.USER_REMOVED_AGENT_KNOWLEDGE, {
+                agent_id: agentId,
+                project_id: projectId,
+                user_id: req.user.id,
+            });
+        }
         return { success: true };
     }
+    trackUploadedFiles(userId, projectId, agentId, uploadedFiles) {
+        const files = uploadedFiles.map(({ file, contentHash }) => ({
+            ...(contentHash === undefined ? {} : { content_hash: contentHash }),
+            mime_type: file.mimeType,
+            size_bytes: file.fileSizeBytes,
+        }));
+        const totalBytes = files.reduce((sum, file) => sum + file.size_bytes, 0);
+        this.telemetry.track(telemetry_1.TELEMETRY_EVENT.AGENTS.USER_UPLOADED_AGENT_KNOWLEDGE_FILES, {
+            agent_id: agentId,
+            project_id: projectId,
+            user_id: userId,
+            file_count: files.length,
+            total_bytes: totalBytes,
+            files,
+        });
+    }
+    trackUploadFailed(req, projectId, agentId, fileCount, error) {
+        if (error instanceof errors_1.NotFoundError) {
+            return;
+        }
+        const reason = error instanceof agent_knowledge_upload_error_1.AgentKnowledgeUploadError ? error.reason : 'unknown';
+        this.telemetry.track(telemetry_1.TELEMETRY_EVENT.AGENTS.USER_FAILED_AGENT_KNOWLEDGE_UPLOAD, {
+            stage: 'server',
+            agent_id: agentId,
+            project_id: projectId,
+            user_id: req.user.id,
+            file_count: fileCount,
+            reason,
+        });
+    }
 };
 exports.AgentKnowledgeController = AgentKnowledgeController;
 __decorate([
@@ -82,7 +130,7 @@ __decorate([
 ], AgentKnowledgeController.prototype, "listFiles", null);
 __decorate([
     (0, decorators_1.Post)('/:agentId/files', {
-        middlewares: [agentUploadMiddleware.array('files')],
+        middlewares: [agentUploadMiddleware.array(KNOWLEDGE_FILES_FIELD)],
     }),
     (0, decorators_1.ProjectScope)('agent:update'),
     __param(2, (0, decorators_1.Param)('projectId')),
@@ -103,6 +151,6 @@ __decorate([
 ], AgentKnowledgeController.prototype, "deleteFile", null);
 exports.AgentKnowledgeController = AgentKnowledgeController = __decorate([
     (0, decorators_1.RestController)('/projects/:projectId/agents/v2'),
-    __metadata("design:paramtypes", [agent_knowledge_service_1.AgentKnowledgeService, agent_sandbox_runtime_service_1.AgentSandboxRuntimeService, agent_runtime_cache_service_1.AgentRuntimeCacheService])
+    __metadata("design:paramtypes", [agent_knowledge_service_1.AgentKnowledgeService, knowledge_availability_service_1.KnowledgeAvailabilityService, agent_runtime_cache_service_1.AgentRuntimeCacheService, telemetry_2.Telemetry])
 ], AgentKnowledgeController);
 //# sourceMappingURL=agent-knowledge.controller.js.map

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

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

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

@@ -1,22 +1,33 @@
 import { type AgentFileDto } from '@n8n/api-types';
 import { Logger } from '@n8n/backend-common';
+import { GlobalConfig } from '@n8n/config';
+import { InstanceSettings } from 'n8n-core';
+import { KnowledgeAvailabilityService } from '../../modules/knowledge/knowledge-availability.service';
 import { AgentKnowledgeFileStore } from './agent-knowledge-file-store';
 import { AgentKnowledgeMirrorService } from './agent-knowledge-mirror.service';
 import { AgentSandboxRuntimeService } from './agent-sandbox-runtime.service';
 import { AgentFileRepository } from './repositories/agent-file.repository';
 import { AgentRepository } from './repositories/agent.repository';
+export interface UploadedKnowledgeFile {
+    file: AgentFileDto;
+    contentHash?: string;
+}
 export declare class AgentKnowledgeService {
     private readonly agentRepository;
     private readonly agentFileRepository;
     private readonly agentSandboxRuntimeService;
     private readonly agentKnowledgeMirrorService;
     private readonly agentKnowledgeFileStore;
+    private readonly instanceSettings;
     private readonly logger;
-    constructor(agentRepository: AgentRepository, agentFileRepository: AgentFileRepository, agentSandboxRuntimeService: AgentSandboxRuntimeService, agentKnowledgeMirrorService: AgentKnowledgeMirrorService, agentKnowledgeFileStore: AgentKnowledgeFileStore, logger: Logger);
-    uploadFiles(agentId: string, projectId: string, files: Express.Multer.File[]): Promise<AgentFileDto[]>;
+    private readonly knowledgeAvailabilityService;
+    private readonly globalConfig;
+    constructor(agentRepository: AgentRepository, agentFileRepository: AgentFileRepository, agentSandboxRuntimeService: AgentSandboxRuntimeService, agentKnowledgeMirrorService: AgentKnowledgeMirrorService, agentKnowledgeFileStore: AgentKnowledgeFileStore, instanceSettings: InstanceSettings, logger: Logger, knowledgeAvailabilityService: KnowledgeAvailabilityService, globalConfig: GlobalConfig);
+    uploadFiles(agentId: string, projectId: string, files: Express.Multer.File[]): Promise<UploadedKnowledgeFile[]>;
+    private hashUploadedFile;
     listFiles(agentId: string, projectId: string): Promise<AgentFileDto[]>;
     warmKnowledgeSandbox(agentId: string, projectId: string): Promise<void>;
-    deleteFile(agentId: string, projectId: string, fileId: string): Promise<void>;
+    deleteFile(agentId: string, projectId: string, fileId: string): Promise<boolean>;
     deleteAllFilesForAgent(_projectId: string, agentId: string): Promise<void>;
     destroyKnowledgeSandbox(projectId: string, agentId: string): Promise<void>;
     private storeAgentFile;