n8n 2.15.1 → 2.17.0

package/dist/modules/instance-ai/event-bus/in-process-event-bus.js

@@ -0,0 +1,98 @@
+"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.InProcessEventBus = void 0;
+const di_1 = require("@n8n/di");
+const node_events_1 = require("node:events");
+const MAX_EVENTS_PER_THREAD = 500;
+const MAX_BYTES_PER_THREAD = 2 * 1024 * 1024;
+let InProcessEventBus = class InProcessEventBus {
+    constructor() {
+        this.emitter = new node_events_1.EventEmitter();
+        this.store = new Map();
+        this.sizeBytes = new Map();
+        this.nextId = new Map();
+        this.emitter.setMaxListeners(0);
+    }
+    publish(threadId, event) {
+        const events = this.getOrCreateStore(threadId);
+        const id = (this.nextId.get(threadId) ?? 0) + 1;
+        this.nextId.set(threadId, id);
+        const stored = { id, event };
+        const eventSize = JSON.stringify(event).length;
+        events.push(stored);
+        this.sizeBytes.set(threadId, (this.sizeBytes.get(threadId) ?? 0) + eventSize);
+        this.evictIfNeeded(threadId, events);
+        this.emitter.emit(threadId, stored);
+    }
+    subscribe(threadId, handler) {
+        this.emitter.on(threadId, handler);
+        return () => this.emitter.off(threadId, handler);
+    }
+    getEventsAfter(threadId, afterId) {
+        const events = this.store.get(threadId);
+        if (!events)
+            return [];
+        return events.filter((e) => e.id > afterId);
+    }
+    getEventsForRun(threadId, runId) {
+        const events = this.store.get(threadId);
+        if (!events)
+            return [];
+        return events.filter((e) => e.event.runId === runId).map((e) => e.event);
+    }
+    getEventsForRuns(threadId, runIds) {
+        const events = this.store.get(threadId);
+        if (!events || runIds.length === 0)
+            return [];
+        const runIdSet = new Set(runIds);
+        return events.filter((e) => runIdSet.has(e.event.runId)).map((e) => e.event);
+    }
+    getNextEventId(threadId) {
+        return (this.nextId.get(threadId) ?? 0) + 1;
+    }
+    clearThread(threadId) {
+        this.store.delete(threadId);
+        this.sizeBytes.delete(threadId);
+        this.nextId.delete(threadId);
+        this.emitter.removeAllListeners(threadId);
+    }
+    clear() {
+        this.store.clear();
+        this.sizeBytes.clear();
+        this.nextId.clear();
+        this.emitter.removeAllListeners();
+    }
+    evictIfNeeded(threadId, events) {
+        let totalSize = this.sizeBytes.get(threadId) ?? 0;
+        while (events.length > MAX_EVENTS_PER_THREAD || totalSize > MAX_BYTES_PER_THREAD) {
+            const evicted = events.shift();
+            if (!evicted)
+                break;
+            totalSize -= JSON.stringify(evicted.event).length;
+        }
+        this.sizeBytes.set(threadId, Math.max(0, totalSize));
+    }
+    getOrCreateStore(threadId) {
+        let events = this.store.get(threadId);
+        if (!events) {
+            events = [];
+            this.store.set(threadId, events);
+        }
+        return events;
+    }
+};
+exports.InProcessEventBus = InProcessEventBus;
+exports.InProcessEventBus = InProcessEventBus = __decorate([
+    (0, di_1.Service)(),
+    __metadata("design:paramtypes", [])
+], InProcessEventBus);
+//# sourceMappingURL=in-process-event-bus.js.map

package/dist/modules/instance-ai/event-bus/in-process-event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process-event-bus.js","sourceRoot":"","sources":["../../../../src/modules/instance-ai/event-bus/in-process-event-bus.ts"],"names":[],"mappings":"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"}

package/dist/modules/instance-ai/filesystem/index.d.ts

@@ -0,0 +1,3 @@
+export { LocalGateway } from './local-gateway';
+export type { LocalGatewayEvent } from './local-gateway';
+export { LocalGatewayRegistry } from './local-gateway-registry';

package/dist/modules/instance-ai/filesystem/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalGatewayRegistry = exports.LocalGateway = void 0;
+var local_gateway_1 = require("./local-gateway");
+Object.defineProperty(exports, "LocalGateway", { enumerable: true, get: function () { return local_gateway_1.LocalGateway; } });
+var local_gateway_registry_1 = require("./local-gateway-registry");
+Object.defineProperty(exports, "LocalGatewayRegistry", { enumerable: true, get: function () { return local_gateway_registry_1.LocalGatewayRegistry; } });
+//# sourceMappingURL=index.js.map

package/dist/modules/instance-ai/filesystem/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/instance-ai/filesystem/index.ts"],"names":[],"mappings":";;;AAAA,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AAErB,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA"}

package/dist/modules/instance-ai/filesystem/local-gateway-registry.d.ts

@@ -0,0 +1,29 @@
+import type { InstanceAiGatewayCapabilities, McpToolCallResult, ToolCategory } from '@n8n/api-types';
+import { LocalGateway } from './local-gateway';
+export declare class LocalGatewayRegistry {
+    private readonly userGateways;
+    private readonly apiKeyToUserId;
+    private generateUniqueKey;
+    private getOrCreate;
+    getUserIdForApiKey(key: string): string | undefined;
+    generatePairingToken(userId: string): string;
+    getPairingToken(userId: string): string | null;
+    consumePairingToken(userId: string, token: string): string | null;
+    getActiveSessionKey(userId: string): string | null;
+    clearActiveSessionKey(userId: string): void;
+    getGateway(userId: string): LocalGateway;
+    findGateway(userId: string): LocalGateway | undefined;
+    initGateway(userId: string, data: InstanceAiGatewayCapabilities): void;
+    resolveGatewayRequest(userId: string, requestId: string, result?: McpToolCallResult, error?: string): boolean;
+    disconnectGateway(userId: string): void;
+    getGatewayStatus(userId: string): {
+        connected: boolean;
+        connectedAt: string | null;
+        directory: string | null;
+        hostIdentifier: string | null;
+        toolCategories: ToolCategory[];
+    };
+    startDisconnectTimer(userId: string, onDisconnect: () => void): void;
+    clearDisconnectTimer(userId: string): void;
+    disconnectAll(): void;
+}

package/dist/modules/instance-ai/filesystem/local-gateway-registry.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalGatewayRegistry = void 0;
+const nanoid_1 = require("nanoid");
+const local_gateway_1 = require("./local-gateway");
+const INITIAL_GRACE_MS = 10_000;
+const MAX_GRACE_MS = 120_000;
+const PAIRING_TOKEN_TTL_MS = 5 * 60 * 1000;
+class LocalGatewayRegistry {
+    constructor() {
+        this.userGateways = new Map();
+        this.apiKeyToUserId = new Map();
+    }
+    generateUniqueKey(prefix) {
+        let key;
+        do {
+            key = `${prefix}_${(0, nanoid_1.nanoid)(32)}`;
+        } while (this.apiKeyToUserId.has(key));
+        return key;
+    }
+    getOrCreate(userId) {
+        if (!this.userGateways.has(userId)) {
+            this.userGateways.set(userId, {
+                gateway: new local_gateway_1.LocalGateway(),
+                pairingToken: null,
+                activeSessionKey: null,
+                disconnectTimer: null,
+                reconnectCount: 0,
+            });
+        }
+        return this.userGateways.get(userId);
+    }
+    getUserIdForApiKey(key) {
+        return this.apiKeyToUserId.get(key);
+    }
+    generatePairingToken(userId) {
+        const state = this.getOrCreate(userId);
+        if (state.activeSessionKey)
+            return state.activeSessionKey;
+        const existing = this.getPairingToken(userId);
+        if (existing)
+            return existing;
+        const token = this.generateUniqueKey('gw');
+        state.pairingToken = { token, createdAt: Date.now() };
+        this.apiKeyToUserId.set(token, userId);
+        return token;
+    }
+    getPairingToken(userId) {
+        const state = this.userGateways.get(userId);
+        if (!state?.pairingToken)
+            return null;
+        if (Date.now() - state.pairingToken.createdAt > PAIRING_TOKEN_TTL_MS) {
+            this.apiKeyToUserId.delete(state.pairingToken.token);
+            state.pairingToken = null;
+            return null;
+        }
+        return state.pairingToken.token;
+    }
+    consumePairingToken(userId, token) {
+        const state = this.userGateways.get(userId);
+        const valid = this.getPairingToken(userId);
+        if (!state || !valid || valid !== token)
+            return null;
+        this.apiKeyToUserId.delete(token);
+        state.pairingToken = null;
+        const sessionKey = this.generateUniqueKey('sess');
+        state.activeSessionKey = sessionKey;
+        this.apiKeyToUserId.set(sessionKey, userId);
+        return sessionKey;
+    }
+    getActiveSessionKey(userId) {
+        return this.userGateways.get(userId)?.activeSessionKey ?? null;
+    }
+    clearActiveSessionKey(userId) {
+        const state = this.userGateways.get(userId);
+        if (!state?.activeSessionKey)
+            return;
+        this.apiKeyToUserId.delete(state.activeSessionKey);
+        state.activeSessionKey = null;
+    }
+    getGateway(userId) {
+        return this.getOrCreate(userId).gateway;
+    }
+    findGateway(userId) {
+        return this.userGateways.get(userId)?.gateway;
+    }
+    initGateway(userId, data) {
+        const state = this.getOrCreate(userId);
+        this.clearDisconnectTimer(userId);
+        state.reconnectCount = 0;
+        state.gateway.init(data);
+    }
+    resolveGatewayRequest(userId, requestId, result, error) {
+        return this.userGateways.get(userId)?.gateway.resolveRequest(requestId, result, error) ?? false;
+    }
+    disconnectGateway(userId) {
+        this.userGateways.get(userId)?.gateway.disconnect();
+    }
+    getGatewayStatus(userId) {
+        return (this.userGateways.get(userId)?.gateway.getStatus() ?? {
+            connected: false,
+            connectedAt: null,
+            directory: null,
+            hostIdentifier: null,
+            toolCategories: [],
+        });
+    }
+    startDisconnectTimer(userId, onDisconnect) {
+        const state = this.getOrCreate(userId);
+        this.clearDisconnectTimer(userId);
+        const graceMs = Math.min(INITIAL_GRACE_MS * Math.pow(2, state.reconnectCount), MAX_GRACE_MS);
+        state.reconnectCount++;
+        state.disconnectTimer = setTimeout(() => {
+            state.disconnectTimer = null;
+            this.disconnectGateway(userId);
+            onDisconnect();
+        }, graceMs);
+    }
+    clearDisconnectTimer(userId) {
+        const state = this.userGateways.get(userId);
+        if (!state?.disconnectTimer)
+            return;
+        clearTimeout(state.disconnectTimer);
+        state.disconnectTimer = null;
+    }
+    disconnectAll() {
+        for (const state of this.userGateways.values()) {
+            if (state.disconnectTimer)
+                clearTimeout(state.disconnectTimer);
+            state.gateway.disconnect();
+        }
+        this.userGateways.clear();
+        this.apiKeyToUserId.clear();
+    }
+}
+exports.LocalGatewayRegistry = LocalGatewayRegistry;
+//# sourceMappingURL=local-gateway-registry.js.map

package/dist/modules/instance-ai/filesystem/local-gateway-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-gateway-registry.js","sourceRoot":"","sources":["../../../../src/modules/instance-ai/filesystem/local-gateway-registry.ts"],"names":[],"mappings":"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"}

package/dist/modules/instance-ai/filesystem/local-gateway.d.ts

@@ -0,0 +1,35 @@
+import type { McpToolCallRequest, McpToolCallResult, McpTool, InstanceAiGatewayCapabilities, ToolCategory } from '@n8n/api-types';
+export interface LocalGatewayEvent {
+    type: 'filesystem-request';
+    payload: {
+        requestId: string;
+        toolCall: McpToolCallRequest;
+    };
+}
+export declare class LocalGateway {
+    private readonly pendingRequests;
+    private readonly emitter;
+    private _connected;
+    private _connectedAt;
+    private _rootPath;
+    private _hostIdentifier;
+    private _toolCategories;
+    private _availableTools;
+    get isConnected(): boolean;
+    get connectedAt(): string | null;
+    get rootPath(): string | null;
+    getAvailableTools(): McpTool[];
+    getToolsByCategory(category: string): McpTool[];
+    onRequest(listener: (event: LocalGatewayEvent) => void): () => void;
+    init(data: InstanceAiGatewayCapabilities): void;
+    resolveRequest(requestId: string, result?: McpToolCallResult, error?: string): boolean;
+    disconnect(): void;
+    getStatus(): {
+        connected: boolean;
+        connectedAt: string | null;
+        directory: string | null;
+        hostIdentifier: string | null;
+        toolCategories: ToolCategory[];
+    };
+    callTool(toolCall: McpToolCallRequest): Promise<McpToolCallResult>;
+}

package/dist/modules/instance-ai/filesystem/local-gateway.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalGateway = void 0;
+const node_events_1 = require("node:events");
+const nanoid_1 = require("nanoid");
+const REQUEST_TIMEOUT_MS = 60_000;
+class LocalGateway {
+    constructor() {
+        this.pendingRequests = new Map();
+        this.emitter = new node_events_1.EventEmitter();
+        this._connected = false;
+        this._connectedAt = null;
+        this._rootPath = null;
+        this._hostIdentifier = null;
+        this._toolCategories = [];
+        this._availableTools = [];
+    }
+    get isConnected() {
+        return this._connected;
+    }
+    get connectedAt() {
+        return this._connectedAt;
+    }
+    get rootPath() {
+        return this._rootPath;
+    }
+    getAvailableTools() {
+        return this._availableTools;
+    }
+    getToolsByCategory(category) {
+        return this._availableTools.filter((t) => t.annotations?.category === category);
+    }
+    onRequest(listener) {
+        this.emitter.on('filesystem-request', listener);
+        return () => this.emitter.off('filesystem-request', listener);
+    }
+    init(data) {
+        this._rootPath = data.rootPath;
+        this._hostIdentifier = data.hostIdentifier ?? null;
+        this._toolCategories = data.toolCategories ?? [];
+        this._availableTools = data.tools;
+        this._connected = true;
+        this._connectedAt = new Date().toISOString();
+    }
+    resolveRequest(requestId, result, error) {
+        const pending = this.pendingRequests.get(requestId);
+        if (!pending)
+            return false;
+        clearTimeout(pending.timer);
+        this.pendingRequests.delete(requestId);
+        if (error) {
+            pending.reject(new Error(error));
+            return true;
+        }
+        pending.resolve(result ?? { content: [] });
+        return true;
+    }
+    disconnect() {
+        this._connected = false;
+        this._connectedAt = null;
+        this._rootPath = null;
+        this._hostIdentifier = null;
+        this._toolCategories = [];
+        this._availableTools = [];
+        for (const [id, pending] of this.pendingRequests) {
+            clearTimeout(pending.timer);
+            pending.reject(new Error('Local gateway disconnected'));
+            this.pendingRequests.delete(id);
+        }
+    }
+    getStatus() {
+        return {
+            connected: this._connected,
+            connectedAt: this._connectedAt,
+            directory: this._rootPath,
+            hostIdentifier: this._hostIdentifier,
+            toolCategories: this._toolCategories,
+        };
+    }
+    async callTool(toolCall) {
+        if (!this._connected) {
+            throw new Error('Local gateway is not connected');
+        }
+        const requestId = `gw_${(0, nanoid_1.nanoid)()}`;
+        return await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pendingRequests.delete(requestId);
+                reject(new Error(`Local gateway request timed out after ${REQUEST_TIMEOUT_MS}ms`));
+            }, REQUEST_TIMEOUT_MS);
+            this.pendingRequests.set(requestId, { resolve, reject, timer, toolCall });
+            this.emitter.emit('filesystem-request', {
+                type: 'filesystem-request',
+                payload: { requestId, toolCall },
+            });
+        });
+    }
+}
+exports.LocalGateway = LocalGateway;
+//# sourceMappingURL=local-gateway.js.map

package/dist/modules/instance-ai/filesystem/local-gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-gateway.js","sourceRoot":"","sources":["../../../../src/modules/instance-ai/filesystem/local-gateway.ts"],"names":[],"mappings":"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"}

package/dist/modules/instance-ai/instance-ai-memory.service.d.ts

@@ -0,0 +1,40 @@
+import type { InstanceAiEnsureThreadResponse, InstanceAiRichMessagesResponse, InstanceAiThreadInfo, InstanceAiThreadListResponse, InstanceAiThreadMessagesResponse } from '@n8n/api-types';
+import { Logger } from '@n8n/backend-common';
+import { GlobalConfig } from '@n8n/config';
+import { type AgentTreeSnapshot } from '@n8n/instance-ai';
+import { DbSnapshotStorage } from './storage/db-snapshot-storage';
+import { TypeORMCompositeStore } from './storage/typeorm-composite-store';
+export declare class InstanceAiMemoryService {
+    private readonly logger;
+    private readonly compositeStore;
+    private readonly dbSnapshotStorage;
+    private readonly instanceAiConfig;
+    constructor(logger: Logger, globalConfig: GlobalConfig, compositeStore: TypeORMCompositeStore, dbSnapshotStorage: DbSnapshotStorage);
+    listThreads(userId: string, page?: number, perPage?: number): Promise<InstanceAiThreadListResponse>;
+    ensureThread(userId: string, threadId: string): Promise<InstanceAiEnsureThreadResponse>;
+    getThreadMessages(userId: string, threadId: string, options?: {
+        limit?: number;
+        page?: number;
+    }): Promise<InstanceAiThreadMessagesResponse>;
+    getRichMessages(userId: string, threadId: string, options?: {
+        limit?: number;
+        page?: number;
+        excludeRunIds?: string[];
+    }): Promise<Omit<InstanceAiRichMessagesResponse, 'nextEventId'>>;
+    getLatestRunSnapshot(threadId: string, options?: {
+        messageGroupId?: string;
+        runId?: string;
+    }): Promise<AgentTreeSnapshot | undefined>;
+    validateThreadOwnership(userId: string, threadId: string): Promise<boolean>;
+    checkThreadOwnership(userId: string, threadId: string): Promise<'owned' | 'not_found' | 'other_user'>;
+    deleteThread(threadId: string): Promise<void>;
+    renameThread(threadId: string, title: string): Promise<InstanceAiThreadInfo>;
+    updateThread(threadId: string, updates: {
+        title?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<InstanceAiThreadInfo>;
+    getThreadMetadata(userId: string, threadId: string): Promise<Record<string, unknown> | undefined>;
+    cleanupExpiredThreads(onThreadDeleted?: (threadId: string) => Promise<void>): Promise<number>;
+    private createMemoryInstance;
+    private toThreadInfo;
+}