@n8n/instance-ai 1.0.0

package/dist/workspace/builder-sandbox-factory.js

@@ -0,0 +1,199 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuilderSandboxFactory = void 0;
+const sdk_1 = require("@daytonaio/sdk");
+const workspace_1 = require("@mastra/core/workspace");
+const daytona_1 = require("@mastra/daytona");
+const strict_1 = __importDefault(require("node:assert/strict"));
+const daytona_filesystem_1 = require("./daytona-filesystem");
+const n8n_sandbox_filesystem_1 = require("./n8n-sandbox-filesystem");
+const n8n_sandbox_image_manager_1 = require("./n8n-sandbox-image-manager");
+const n8n_sandbox_sandbox_1 = require("./n8n-sandbox-sandbox");
+const sandbox_fs_1 = require("./sandbox-fs");
+const sandbox_setup_1 = require("./sandbox-setup");
+async function cleanupTrackedSandboxProcesses(workspace) {
+    const processManager = workspace.sandbox?.processes;
+    if (!processManager)
+        return;
+    let processes;
+    try {
+        processes = await processManager.list();
+    }
+    catch {
+        return;
+    }
+    for (const process of processes) {
+        try {
+            if (process.running) {
+                await processManager.kill(process.pid);
+            }
+            else {
+                await processManager.get(process.pid);
+            }
+        }
+        catch {
+        }
+    }
+}
+class BuilderSandboxFactory {
+    config;
+    imageManager;
+    daytona = null;
+    n8nSandboxImageManager = null;
+    constructor(config, imageManager) {
+        this.config = config;
+        this.imageManager = imageManager;
+    }
+    async create(builderId, context) {
+        if (this.config.provider === 'local') {
+            return await this.createLocal(builderId, context);
+        }
+        if (this.config.provider === 'n8n-sandbox') {
+            return await this.createN8nSandbox(builderId, context);
+        }
+        return await this.createDaytona(builderId, context);
+    }
+    async getDaytona() {
+        const config = this.assertIsDaytona();
+        if (config.getAuthToken) {
+            const apiKey = await config.getAuthToken();
+            return new sdk_1.Daytona({ apiKey, apiUrl: config.daytonaApiUrl });
+        }
+        this.daytona ??= new sdk_1.Daytona({
+            apiKey: config.daytonaApiKey,
+            apiUrl: config.daytonaApiUrl,
+        });
+        return this.daytona;
+    }
+    getN8nSandboxImageManager() {
+        this.n8nSandboxImageManager ??= new n8n_sandbox_image_manager_1.N8nSandboxImageManager();
+        return this.n8nSandboxImageManager;
+    }
+    catalogCache = null;
+    async getNodeCatalog(context) {
+        if (this.catalogCache)
+            return this.catalogCache;
+        const nodeTypes = await context.nodeService.listSearchable();
+        this.catalogCache = nodeTypes.map(sandbox_setup_1.formatNodeCatalogLine).join('\n');
+        return this.catalogCache;
+    }
+    async createDaytona(builderId, context) {
+        const config = this.assertIsDaytona();
+        (0, strict_1.default)(this.imageManager, 'Daytona snapshot manager required');
+        const image = this.imageManager.ensureImage();
+        const createSandboxFn = async () => {
+            const daytona = await this.getDaytona();
+            return await daytona.create({
+                image,
+                language: 'typescript',
+                ephemeral: true,
+                labels: { 'n8n-builder': builderId },
+            }, { timeout: 300 });
+        };
+        const [sandbox, catalog] = await Promise.all([createSandboxFn(), this.getNodeCatalog(context)]);
+        const deleteSandbox = async () => {
+            try {
+                const d = await this.getDaytona();
+                await d.delete(sandbox);
+            }
+            catch {
+            }
+        };
+        try {
+            const apiKey = config.getAuthToken ? await config.getAuthToken() : config.daytonaApiKey;
+            const daytonaSandbox = new daytona_1.DaytonaSandbox({
+                id: sandbox.id,
+                apiKey,
+                apiUrl: config.daytonaApiUrl,
+                language: 'typescript',
+                timeout: config.timeout ?? 300_000,
+            });
+            const workspace = new workspace_1.Workspace({
+                sandbox: daytonaSandbox,
+                filesystem: new daytona_filesystem_1.DaytonaFilesystem(daytonaSandbox),
+            });
+            await workspace.init();
+            const root = await (0, sandbox_setup_1.getWorkspaceRoot)(workspace);
+            if (workspace.filesystem) {
+                await workspace.filesystem.writeFile(`${root}/node-types/index.txt`, catalog);
+            }
+            else {
+                await (0, sandbox_fs_1.writeFileViaSandbox)(workspace, `${root}/node-types/index.txt`, catalog);
+            }
+            return {
+                workspace,
+                cleanup: async () => {
+                    await cleanupTrackedSandboxProcesses(workspace);
+                    await deleteSandbox();
+                },
+            };
+        }
+        catch (error) {
+            await deleteSandbox();
+            throw error;
+        }
+    }
+    async createN8nSandbox(_builderId, context) {
+        const config = this.assertIsN8nSandbox();
+        const dockerfile = this.getN8nSandboxImageManager().getDockerfile();
+        const catalog = await this.getNodeCatalog(context);
+        const sandbox = new n8n_sandbox_sandbox_1.N8nSandboxServiceSandbox({
+            apiKey: config.apiKey,
+            serviceUrl: config.serviceUrl,
+            timeout: config.timeout ?? 300_000,
+            dockerfile,
+        });
+        const workspace = new workspace_1.Workspace({
+            sandbox,
+            filesystem: new n8n_sandbox_filesystem_1.N8nSandboxFilesystem(sandbox),
+        });
+        await workspace.init();
+        const root = await (0, sandbox_setup_1.getWorkspaceRoot)(workspace);
+        if (workspace.filesystem) {
+            await workspace.filesystem.writeFile(`${root}/node-types/index.txt`, catalog);
+        }
+        else {
+            await (0, sandbox_fs_1.writeFileViaSandbox)(workspace, `${root}/node-types/index.txt`, catalog);
+        }
+        return {
+            workspace,
+            cleanup: async () => {
+                await cleanupTrackedSandboxProcesses(workspace);
+                try {
+                    await sandbox.destroy();
+                }
+                catch {
+                }
+            },
+        };
+    }
+    assertIsDaytona() {
+        (0, strict_1.default)(this.config.enabled && this.config.provider === 'daytona', 'Daytona sandbox config required');
+        return this.config;
+    }
+    assertIsN8nSandbox() {
+        (0, strict_1.default)(this.config.enabled && this.config.provider === 'n8n-sandbox', 'n8n sandbox config required');
+        return this.config;
+    }
+    async createLocal(builderId, context) {
+        const dir = `./workspace-builders/${builderId}`;
+        const sandbox = new workspace_1.LocalSandbox({ workingDirectory: dir });
+        const workspace = new workspace_1.Workspace({
+            sandbox,
+            filesystem: new workspace_1.LocalFilesystem({ basePath: dir }),
+        });
+        await workspace.init();
+        await (0, sandbox_setup_1.setupSandboxWorkspace)(workspace, context);
+        return {
+            workspace,
+            cleanup: async () => {
+                await cleanupTrackedSandboxProcesses(workspace);
+            },
+        };
+    }
+}
+exports.BuilderSandboxFactory = BuilderSandboxFactory;
+//# sourceMappingURL=builder-sandbox-factory.js.map

package/dist/workspace/builder-sandbox-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-sandbox-factory.js","sourceRoot":"","sources":["../../src/workspace/builder-sandbox-factory.ts"],"names":[],"mappings":"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"}

package/dist/workspace/create-workspace.d.ts

@@ -0,0 +1,33 @@
+import { Workspace, LocalSandbox } from '@mastra/core/workspace';
+import { DaytonaSandbox } from '@mastra/daytona';
+import { N8nSandboxServiceSandbox } from './n8n-sandbox-sandbox';
+export type SandboxProvider = 'daytona' | 'local' | 'n8n-sandbox';
+interface SandboxConfigBase {
+    provider: SandboxProvider;
+    timeout?: number;
+}
+interface DisabledSandboxConfig extends SandboxConfigBase {
+    enabled: false;
+}
+interface DaytonaSandboxConfig extends SandboxConfigBase {
+    enabled: true;
+    provider: 'daytona';
+    daytonaApiUrl?: string;
+    daytonaApiKey?: string;
+    image?: string;
+    getAuthToken?: () => Promise<string>;
+}
+interface LocalSandboxConfig extends SandboxConfigBase {
+    enabled: true;
+    provider: 'local';
+}
+interface N8nSandboxConfig extends SandboxConfigBase {
+    enabled: true;
+    provider: 'n8n-sandbox';
+    serviceUrl?: string;
+    apiKey?: string;
+}
+export type SandboxConfig = DisabledSandboxConfig | DaytonaSandboxConfig | LocalSandboxConfig | N8nSandboxConfig;
+export declare function createSandbox(config: SandboxConfig): DaytonaSandbox | LocalSandbox | N8nSandboxServiceSandbox | undefined;
+export declare function createWorkspace(sandbox: DaytonaSandbox | LocalSandbox | N8nSandboxServiceSandbox | undefined): Workspace | undefined;
+export {};

package/dist/workspace/create-workspace.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSandbox = createSandbox;
+exports.createWorkspace = createWorkspace;
+const workspace_1 = require("@mastra/core/workspace");
+const daytona_1 = require("@mastra/daytona");
+const daytona_filesystem_1 = require("./daytona-filesystem");
+const n8n_sandbox_filesystem_1 = require("./n8n-sandbox-filesystem");
+const n8n_sandbox_sandbox_1 = require("./n8n-sandbox-sandbox");
+function createSandbox(config) {
+    if (!config.enabled)
+        return undefined;
+    if (config.provider === 'daytona') {
+        return new daytona_1.DaytonaSandbox({
+            apiKey: config.daytonaApiKey,
+            apiUrl: config.daytonaApiUrl,
+            ...(config.image ? { image: config.image } : {}),
+            language: 'typescript',
+            timeout: config.timeout ?? 300_000,
+        });
+    }
+    if (config.provider === 'n8n-sandbox') {
+        return new n8n_sandbox_sandbox_1.N8nSandboxServiceSandbox({
+            apiKey: config.apiKey,
+            serviceUrl: config.serviceUrl,
+            timeout: config.timeout ?? 300_000,
+        });
+    }
+    if (process.env.NODE_ENV === 'production') {
+        throw new Error('LocalSandbox (provider: "local") is not allowed in production. Use "daytona" provider for isolated sandbox execution.');
+    }
+    return new workspace_1.LocalSandbox({
+        workingDirectory: './workspace',
+    });
+}
+function createWorkspace(sandbox) {
+    if (!sandbox)
+        return undefined;
+    if (sandbox instanceof workspace_1.LocalSandbox) {
+        return new workspace_1.Workspace({
+            sandbox,
+            filesystem: new workspace_1.LocalFilesystem({ basePath: './workspace' }),
+        });
+    }
+    if (sandbox instanceof n8n_sandbox_sandbox_1.N8nSandboxServiceSandbox) {
+        return new workspace_1.Workspace({
+            sandbox,
+            filesystem: new n8n_sandbox_filesystem_1.N8nSandboxFilesystem(sandbox),
+        });
+    }
+    return new workspace_1.Workspace({
+        sandbox,
+        filesystem: new daytona_filesystem_1.DaytonaFilesystem(sandbox),
+    });
+}
+//# sourceMappingURL=create-workspace.js.map

package/dist/workspace/create-workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-workspace.js","sourceRoot":"","sources":["../../src/workspace/create-workspace.ts"],"names":[],"mappings":";;AAqDA,sCAkCC;AAMD,0CAuBC;AApHD,sDAAkF;AAClF,6CAAiD;AAEjD,6DAAyD;AACzD,qEAAgE;AAChE,+DAAiE;AAgDjE,SAAgB,aAAa,CAC5B,MAAqB;IAErB,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAEtC,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,IAAI,wBAAc,CAAC;YACzB,MAAM,EAAE,MAAM,CAAC,aAAa;YAC5B,MAAM,EAAE,MAAM,CAAC,aAAa;YAC5B,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,QAAQ,EAAE,YAAY;YACtB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO;SAClC,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;QACvC,OAAO,IAAI,8CAAwB,CAAC;YACnC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO;SAClC,CAAC,CAAC;IACJ,CAAC;IAID,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACd,uHAAuH,CACvH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,wBAAY,CAAC;QACvB,gBAAgB,EAAE,aAAa;KAC/B,CAAC,CAAC;AACJ,CAAC;AAMD,SAAgB,eAAe,CAC9B,OAA6E;IAE7E,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAE/B,IAAI,OAAO,YAAY,wBAAY,EAAE,CAAC;QACrC,OAAO,IAAI,qBAAS,CAAC;YACpB,OAAO;YACP,UAAU,EAAE,IAAI,2BAAe,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;SAC5D,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,YAAY,8CAAwB,EAAE,CAAC;QACjD,OAAO,IAAI,qBAAS,CAAC;YACpB,OAAO;YACP,UAAU,EAAE,IAAI,6CAAoB,CAAC,OAAO,CAAC;SAC7C,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,qBAAS,CAAC;QACpB,OAAO;QACP,UAAU,EAAE,IAAI,sCAAiB,CAAC,OAAO,CAAC;KAC1C,CAAC,CAAC;AACJ,CAAC"}

package/dist/workspace/daytona-filesystem.d.ts

@@ -0,0 +1,25 @@
+import { MastraFilesystem } from '@mastra/core/workspace';
+import type { FileContent, FileStat, FileEntry, ReadOptions, WriteOptions, ListOptions, RemoveOptions, CopyOptions, ProviderStatus } from '@mastra/core/workspace';
+import type { DaytonaSandbox } from '@mastra/daytona';
+export declare class DaytonaFilesystem extends MastraFilesystem {
+    private readonly sandbox;
+    readonly id: string;
+    readonly name = "DaytonaFilesystem";
+    readonly provider = "daytona";
+    status: ProviderStatus;
+    constructor(sandbox: DaytonaSandbox);
+    private get fs();
+    readFile(path: string, options?: ReadOptions): Promise<string | Buffer>;
+    writeFile(path: string, content: FileContent, options?: WriteOptions): Promise<void>;
+    appendFile(path: string, content: FileContent): Promise<void>;
+    deleteFile(path: string, options?: RemoveOptions): Promise<void>;
+    copyFile(src: string, dest: string, _options?: CopyOptions): Promise<void>;
+    moveFile(src: string, dest: string, _options?: CopyOptions): Promise<void>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    rmdir(path: string, options?: RemoveOptions): Promise<void>;
+    readdir(path: string, _options?: ListOptions): Promise<FileEntry[]>;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<FileStat>;
+}

package/dist/workspace/daytona-filesystem.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DaytonaFilesystem = void 0;
+const workspace_1 = require("@mastra/core/workspace");
+class DaytonaFilesystem extends workspace_1.MastraFilesystem {
+    sandbox;
+    id;
+    name = 'DaytonaFilesystem';
+    provider = 'daytona';
+    status = 'pending';
+    constructor(sandbox) {
+        super({ name: 'DaytonaFilesystem' });
+        this.sandbox = sandbox;
+        this.id = `daytona-fs-${sandbox.id}`;
+    }
+    get fs() {
+        return this.sandbox.instance.fs;
+    }
+    async readFile(path, options) {
+        await this.ensureReady();
+        const buffer = await this.fs.downloadFile(path);
+        if (options?.encoding) {
+            return buffer.toString(options.encoding);
+        }
+        return buffer;
+    }
+    async writeFile(path, content, options) {
+        await this.ensureReady();
+        if (options?.recursive) {
+            const dir = path.substring(0, path.lastIndexOf('/'));
+            if (dir) {
+                await this.fs.createFolder(dir, '755');
+            }
+        }
+        const buffer = typeof content === 'string' ? Buffer.from(content, 'utf-8') : Buffer.from(content);
+        await this.fs.uploadFile(buffer, path);
+    }
+    async appendFile(path, content) {
+        await this.ensureReady();
+        let existing;
+        try {
+            existing = await this.fs.downloadFile(path);
+        }
+        catch {
+            existing = Buffer.alloc(0);
+        }
+        const append = typeof content === 'string' ? Buffer.from(content, 'utf-8') : Buffer.from(content);
+        await this.fs.uploadFile(Buffer.concat([existing, append]), path);
+    }
+    async deleteFile(path, options) {
+        await this.ensureReady();
+        await this.fs.deleteFile(path, options?.recursive);
+    }
+    async copyFile(src, dest, _options) {
+        await this.ensureReady();
+        const content = await this.fs.downloadFile(src);
+        await this.fs.uploadFile(content, dest);
+    }
+    async moveFile(src, dest, _options) {
+        await this.ensureReady();
+        await this.fs.moveFiles(src, dest);
+    }
+    async mkdir(path, options) {
+        await this.ensureReady();
+        if (options?.recursive) {
+            await this.fs.createFolder(path, '755');
+        }
+        else {
+            await this.fs.createFolder(path, '755');
+        }
+    }
+    async rmdir(path, options) {
+        await this.ensureReady();
+        await this.fs.deleteFile(path, options?.recursive ?? false);
+    }
+    async readdir(path, _options) {
+        await this.ensureReady();
+        const files = await this.fs.listFiles(path);
+        return files.map((f) => ({
+            name: f.name ?? '',
+            type: f.isDir ? 'directory' : 'file',
+            size: f.size,
+        }));
+    }
+    async exists(path) {
+        await this.ensureReady();
+        try {
+            await this.fs.getFileDetails(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async stat(path) {
+        await this.ensureReady();
+        const info = await this.fs.getFileDetails(path);
+        return {
+            name: info.name ?? path.split('/').pop() ?? '',
+            path,
+            type: info.isDir ? 'directory' : 'file',
+            size: info.size ?? 0,
+            createdAt: new Date(info.modTime ?? 0),
+            modifiedAt: new Date(info.modTime ?? 0),
+        };
+    }
+}
+exports.DaytonaFilesystem = DaytonaFilesystem;
+//# sourceMappingURL=daytona-filesystem.js.map

package/dist/workspace/daytona-filesystem.js.map

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

package/dist/workspace/n8n-sandbox-client.d.ts

@@ -0,0 +1,105 @@
+import type { FileContent } from '@mastra/core/workspace';
+export interface N8nSandboxServiceErrorPayload {
+    error: string;
+    code: number;
+}
+export declare class N8nSandboxServiceError extends Error {
+    readonly status: number;
+    readonly code?: number | undefined;
+    constructor(message: string, status: number, code?: number | undefined);
+}
+export interface N8nSandboxRecord {
+    id: string;
+    status: string;
+    provider: string;
+    imageId: string;
+    createdAt: number;
+    lastActiveAt: number;
+}
+export interface N8nSandboxFileEntry {
+    name: string;
+    size: number;
+    isDir: boolean;
+    type: 'file' | 'directory';
+    modTime: string;
+}
+export interface N8nSandboxFileStat {
+    name: string;
+    path: string;
+    type: 'file' | 'directory';
+    size: number;
+    createdAt: string;
+    modifiedAt: string;
+}
+export interface N8nSandboxExecResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    executionTimeMs: number;
+    timedOut: boolean;
+    killed: boolean;
+    success: boolean;
+}
+export interface N8nSandboxClientOptions {
+    apiKey?: string;
+    baseUrl?: string;
+}
+export declare class DockerfileStepsBuilder {
+    private readonly steps;
+    run(command: string | string[]): this;
+    build(): string[];
+}
+interface CreateSandboxOptions {
+    dockerfile?: DockerfileStepsBuilder;
+}
+interface N8nSandboxExecRequest {
+    command: string;
+    env?: Record<string, string | undefined>;
+    workdir?: string;
+    timeoutMs?: number;
+    abortSignal?: AbortSignal;
+    onStdout?: (data: string) => void;
+    onStderr?: (data: string) => void;
+}
+export declare class N8nSandboxClient {
+    private readonly options;
+    private readonly baseUrl;
+    constructor(options: N8nSandboxClientOptions);
+    createSandbox(options?: CreateSandboxOptions): Promise<N8nSandboxRecord>;
+    getSandbox(id: string): Promise<N8nSandboxRecord>;
+    deleteSandbox(id: string): Promise<void>;
+    deleteImage(id: string): Promise<void>;
+    exec(id: string, request: N8nSandboxExecRequest): Promise<N8nSandboxExecResult>;
+    readFile(id: string, path: string): Promise<Buffer>;
+    writeFile(id: string, path: string, content: FileContent, overwrite?: boolean): Promise<void>;
+    appendFile(id: string, path: string, content: FileContent): Promise<void>;
+    deleteFile(id: string, path: string, options?: {
+        recursive?: boolean;
+        force?: boolean;
+    }): Promise<void>;
+    copyFile(id: string, request: {
+        src: string;
+        dest: string;
+        recursive?: boolean;
+        overwrite?: boolean;
+    }): Promise<void>;
+    moveFile(id: string, request: {
+        src: string;
+        dest: string;
+        overwrite?: boolean;
+    }): Promise<void>;
+    mkdir(id: string, path: string, recursive?: boolean): Promise<void>;
+    listFiles(id: string, request?: {
+        path?: string;
+        recursive?: boolean;
+        extension?: string;
+    }): Promise<N8nSandboxFileEntry[]>;
+    stat(id: string, path: string): Promise<N8nSandboxFileStat>;
+    private readExecResult;
+    private requireExecExitMeta;
+    private expectSuccess;
+    private requestJson;
+    private request;
+    private toError;
+}
+export {};