@n8n/instance-ai 1.7.1 → 1.8.0

package/dist/workspace/local-sandbox.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalSandbox = void 0;
+const agents_1 = require("@n8n/agents");
+const node_child_process_1 = require("node:child_process");
+const node_crypto_1 = require("node:crypto");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+function shellEscape(value) {
+    return /^[A-Za-z0-9_./:=@+-]+$/.test(value) ? value : `'${value.replace(/'/g, "'\\''")}'`;
+}
+function toShellCommand(command, args = []) {
+    if (args.length === 0)
+        return command;
+    return [command, ...args.map((arg) => shellEscape(arg))].join(' ');
+}
+class LocalSandbox extends agents_1.BaseSandbox {
+    id;
+    name = 'LocalSandbox';
+    provider = 'local';
+    status = 'pending';
+    workingDirectory;
+    env;
+    timeout;
+    instructions;
+    createdAt = new Date();
+    constructor(options = {}) {
+        super();
+        this.id = options.id ?? `local-sandbox-${(0, node_crypto_1.randomUUID)()}`;
+        this.workingDirectory = (0, node_path_1.resolve)(options.workingDirectory ?? './workspace');
+        this.env = options.env;
+        this.timeout = options.timeout;
+        this.instructions = options.instructions;
+    }
+    async start() {
+        await (0, promises_1.mkdir)(this.workingDirectory, { recursive: true });
+    }
+    async stop() { }
+    async destroy() { }
+    async executeCommand(command, args = [], options) {
+        await this.ensureRunning();
+        return await this.runCommand(toShellCommand(command, args), options);
+    }
+    getInfo() {
+        return {
+            id: this.id,
+            name: this.name,
+            provider: this.provider,
+            status: this.status,
+            createdAt: this.createdAt,
+            metadata: {
+                workingDirectory: this.workingDirectory,
+            },
+        };
+    }
+    getInstructions() {
+        return (this.instructions ??
+            `Local sandbox executing host commands in ${this.workingDirectory}. This provider is for development only.`);
+    }
+    async runCommand(command, options) {
+        const startedAt = Date.now();
+        const cwd = options?.cwd ?? this.workingDirectory;
+        const env = {
+            PATH: process.env.PATH,
+            ...this.env,
+            ...options?.env,
+        };
+        return await new Promise((resolveResult, reject) => {
+            const child = (0, node_child_process_1.spawn)(command, {
+                shell: true,
+                cwd,
+                env,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            let stdout = '';
+            let stderr = '';
+            let timedOut = false;
+            let killed = false;
+            const timeoutMs = options?.timeout ?? this.timeout;
+            const timeoutHandle = timeoutMs === undefined
+                ? undefined
+                : setTimeout(() => {
+                    timedOut = true;
+                    killed = child.kill('SIGTERM');
+                }, timeoutMs);
+            const abort = () => {
+                killed = child.kill('SIGTERM');
+            };
+            options?.abortSignal?.addEventListener('abort', abort, { once: true });
+            child.stdout.on('data', (chunk) => {
+                const text = chunk.toString('utf-8');
+                stdout += text;
+                options?.onStdout?.(text);
+            });
+            child.stderr.on('data', (chunk) => {
+                const text = chunk.toString('utf-8');
+                stderr += text;
+                options?.onStderr?.(text);
+            });
+            child.on('error', reject);
+            child.on('close', (code) => {
+                if (timeoutHandle)
+                    clearTimeout(timeoutHandle);
+                options?.abortSignal?.removeEventListener('abort', abort);
+                const exitCode = code ?? (timedOut ? 124 : 1);
+                resolveResult({
+                    command,
+                    success: exitCode === 0 && !timedOut,
+                    exitCode,
+                    stdout,
+                    stderr,
+                    executionTimeMs: Date.now() - startedAt,
+                    timedOut,
+                    killed,
+                });
+            });
+        });
+    }
+}
+exports.LocalSandbox = LocalSandbox;
+//# sourceMappingURL=local-sandbox.js.map

package/dist/workspace/local-sandbox.js.map

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

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

@@ -1,7 +1,7 @@
-import type { CopyOptions, FileContent, FileEntry, FileStat, ListOptions, ProviderStatus, ReadOptions, RemoveOptions, WriteOptions } from '@mastra/core/workspace';
-import { MastraFilesystem } from '@mastra/core/workspace';
+import type { CopyOptions, FileContent, FileEntry, FileStat, ListOptions, ProviderStatus, ReadOptions, RemoveOptions, WriteOptions } from '@n8n/agents';
+import { BaseFilesystem } from '@n8n/agents';
 import type { N8nSandboxServiceSandbox } from './n8n-sandbox-sandbox';
-export declare class N8nSandboxFilesystem extends MastraFilesystem {
+export declare class N8nSandboxFilesystem extends BaseFilesystem {
     private readonly sandbox;
     readonly id: string;
     readonly name = "N8nSandboxFilesystem";

package/dist/workspace/n8n-sandbox-filesystem.js

@@ -1,21 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.N8nSandboxFilesystem = void 0;
-const workspace_1 = require("@mastra/core/workspace");
+const agents_1 = require("@n8n/agents");
 const sandbox_client_1 = require("@n8n/sandbox-client");
 const posix_1 = require("node:path/posix");
 function getParentDirectory(path) {
     const parent = (0, posix_1.dirname)(path);
     return parent === '.' || parent === '/' ? null : parent;
 }
-class N8nSandboxFilesystem extends workspace_1.MastraFilesystem {
+class N8nSandboxFilesystem extends agents_1.BaseFilesystem {
     sandbox;
     id;
     name = 'N8nSandboxFilesystem';
     provider = 'n8n-sandbox';
     status = 'pending';
     constructor(sandbox) {
-        super({ name: 'N8nSandboxFilesystem' });
+        super();
         this.sandbox = sandbox;
         this.id = `n8n-sandbox-fs-${sandbox.id}`;
     }

package/dist/workspace/n8n-sandbox-filesystem.js.map

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

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

@@ -1,26 +1,35 @@
-import { MastraSandbox } from '@mastra/core/workspace';
-import type { CommandResult, ExecuteCommandOptions, ProviderStatus, SandboxInfo } from '@mastra/core/workspace';
+import type { CommandResult, ExecuteCommandOptions, ProviderStatus, SandboxInfo } from '@n8n/agents';
+import { BaseSandbox } from '@n8n/agents';
 import { SandboxClient } from '@n8n/sandbox-client';
 export interface N8nSandboxServiceSandboxOptions {
     id?: string;
     apiKey?: string;
     serviceUrl?: string;
     timeout?: number;
+    env?: Record<string, string>;
 }
-export declare class N8nSandboxServiceSandbox extends MastraSandbox {
+export declare class N8nSandboxServiceSandbox extends BaseSandbox {
     private readonly options;
     readonly name = "N8nSandboxServiceSandbox";
     readonly provider = "n8n-sandbox";
     status: ProviderStatus;
     private readonly instanceId;
     private readonly client;
+    private readonly timeout;
+    private static readonly HOME_DIR;
+    private static readonly WORKSPACE_DIR;
     private sandboxId?;
+    private createdAt?;
     constructor(options: N8nSandboxServiceSandboxOptions);
     get id(): string;
     start(): Promise<void>;
     destroy(): Promise<void>;
+    stop(): Promise<void>;
     getInfo(): Promise<SandboxInfo>;
+    getInstructions(): string;
     executeCommand(command: string, args?: string[], options?: ExecuteCommandOptions): Promise<CommandResult>;
     getClient(): SandboxClient;
+    private tryGetExistingSandbox;
+    private compactEnv;
     private requireSandboxId;
 }

package/dist/workspace/n8n-sandbox-sandbox.js

@@ -4,7 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.N8nSandboxServiceSandbox = void 0;
-const workspace_1 = require("@mastra/core/workspace");
+const agents_1 = require("@n8n/agents");
 const sandbox_client_1 = require("@n8n/sandbox-client");
 const strict_1 = __importDefault(require("node:assert/strict"));
 const node_crypto_1 = require("node:crypto");
@@ -16,38 +16,56 @@ function toShellCommand(command, args = []) {
         return command;
     return [command, ...args.map((arg) => shellEscape(arg))].join(' ');
 }
-class N8nSandboxServiceSandbox extends workspace_1.MastraSandbox {
+class N8nSandboxServiceSandbox extends agents_1.BaseSandbox {
     options;
     name = 'N8nSandboxServiceSandbox';
     provider = 'n8n-sandbox';
     status = 'pending';
     instanceId = `n8n-sandbox-${(0, node_crypto_1.randomUUID)()}`;
     client;
+    timeout;
+    static HOME_DIR = '/home/user';
+    static WORKSPACE_DIR = `${N8nSandboxServiceSandbox.HOME_DIR}/workspace`;
     sandboxId;
+    createdAt;
     constructor(options) {
-        super({ name: 'N8nSandboxServiceSandbox' });
+        super();
         this.options = options;
         this.client = new sandbox_client_1.SandboxClient({
             apiKey: options.apiKey,
             baseUrl: options.serviceUrl,
         });
         this.sandboxId = options.id;
+        this.timeout = options.timeout ?? 300_000;
     }
     get id() {
         return this.sandboxId ?? this.instanceId;
     }
     async start() {
         if (this.sandboxId) {
-            await this.client.getSandbox(this.sandboxId);
-            return;
+            const existing = await this.tryGetExistingSandbox(this.sandboxId);
+            if (existing) {
+                this.createdAt = new Date(existing.createdAt * 1000);
+                return;
+            }
         }
         const sandbox = await this.client.createSandbox();
         this.sandboxId = sandbox.id;
+        this.createdAt = new Date();
     }
     async destroy() {
         if (!this.sandboxId)
             return;
-        await this.client.deleteSandbox(this.sandboxId);
+        try {
+            await this.client.deleteSandbox(this.sandboxId);
+        }
+        catch (error) {
+            if (error instanceof sandbox_client_1.SandboxServiceError && error.status === 404)
+                return;
+            throw error;
+        }
+    }
+    async stop() {
     }
     async getInfo() {
         await this.ensureRunning();
@@ -57,20 +75,28 @@ class N8nSandboxServiceSandbox extends workspace_1.MastraSandbox {
             name: this.name,
             provider: this.provider,
             status: this.status,
-            createdAt: new Date(sandbox.createdAt * 1000),
-            lastUsedAt: new Date(sandbox.lastActiveAt * 1000),
+            createdAt: this.createdAt ?? new Date(sandbox.createdAt * 1000),
             metadata: {
+                lastActiveAt: new Date(sandbox.lastActiveAt * 1000).toISOString(),
                 remoteStatus: sandbox.status,
+                workingDirectory: N8nSandboxServiceSandbox.WORKSPACE_DIR,
             },
         };
     }
+    getInstructions() {
+        return [
+            'Cloud sandbox with isolated execution (TypeScript runtime).',
+            `Default working directory: ${N8nSandboxServiceSandbox.WORKSPACE_DIR}.`,
+            `Command timeout: ${Math.ceil(this.timeout / 1000)}s.`,
+        ].join(' ');
+    }
     async executeCommand(command, args = [], options) {
         await this.ensureRunning();
         const result = await this.client.exec(this.requireSandboxId(), {
             command: toShellCommand(command, args),
-            env: options?.env,
+            env: this.compactEnv(options?.env),
             workdir: options?.cwd,
-            timeoutMs: options?.timeout ?? this.options.timeout,
+            timeoutMs: options?.timeout ?? this.timeout,
             abortSignal: options?.abortSignal,
             onStdout: options?.onStdout,
             onStderr: options?.onStderr,
@@ -90,6 +116,24 @@ class N8nSandboxServiceSandbox extends workspace_1.MastraSandbox {
     getClient() {
         return this.client;
     }
+    async tryGetExistingSandbox(sandboxId) {
+        try {
+            return await this.client.getSandbox(sandboxId);
+        }
+        catch (error) {
+            if (error instanceof sandbox_client_1.SandboxServiceError && error.status === 404)
+                return null;
+            throw error;
+        }
+    }
+    compactEnv(env) {
+        const merged = {
+            ...this.options.env,
+            ...env,
+        };
+        const entries = Object.entries(merged).filter((entry) => typeof entry[1] === 'string');
+        return entries.length > 0 ? Object.fromEntries(entries) : undefined;
+    }
     requireSandboxId() {
         (0, strict_1.default)(this.sandboxId, 'Sandbox has not been created yet');
         return this.sandboxId;

package/dist/workspace/n8n-sandbox-sandbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"n8n-sandbox-sandbox.js","sourceRoot":"","sources":["../../src/workspace/n8n-sandbox-sandbox.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"n8n-sandbox-sandbox.js","sourceRoot":"","sources":["../../src/workspace/n8n-sandbox-sandbox.ts"],"names":[],"mappings":";;;;;;AAMA,wCAA0C;AAC1C,wDAA6F;AAC7F,gEAAwC;AACxC,6CAAyC;AAUzC,SAAS,WAAW,CAAC,KAAa;IACjC,OAAO,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AAC1F,CAAC;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,OAAiB,EAAE;IAC3D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACtC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpE,CAAC;AAGD,MAAa,wBAAyB,SAAQ,oBAAW;IAqB3B;IApBpB,IAAI,GAAG,0BAA0B,CAAC;IAElC,QAAQ,GAAG,aAAa,CAAC;IAElC,MAAM,GAAmB,SAAS,CAAC;IAElB,UAAU,GAAG,eAAe,IAAA,wBAAU,GAAE,EAAE,CAAC;IAE3C,MAAM,CAAgB;IAEtB,OAAO,CAAS;IAEzB,MAAM,CAAU,QAAQ,GAAG,YAAY,CAAC;IAExC,MAAM,CAAU,aAAa,GAAG,GAAG,wBAAwB,CAAC,QAAQ,YAAY,CAAC;IAEjF,SAAS,CAAU;IAEnB,SAAS,CAAQ;IAEzB,YAA6B,OAAwC;QACpE,KAAK,EAAE,CAAC;QADoB,YAAO,GAAP,OAAO,CAAiC;QAEpE,IAAI,CAAC,MAAM,GAAG,IAAI,8BAAa,CAAC;YAC/B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,UAAU;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC;IAC3C,CAAC;IAED,IAAI,EAAE;QACL,OAAO,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC;IAC1C,CAAC;IAEQ,KAAK,CAAC,KAAK;QACnB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAClE,IAAI,QAAQ,EAAE,CAAC;gBACd,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;gBACrD,OAAO;YACR,CAAC;QACF,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAClD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;IAC7B,CAAC;IAEQ,KAAK,CAAC,OAAO;QACrB,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAC5B,IAAI,CAAC;YACJ,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,YAAY,oCAAmB,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO;YACzE,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;IAEQ,KAAK,CAAC,IAAI;IAGnB,CAAC;IAED,KAAK,CAAC,OAAO;QACZ,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACtE,OAAO;YACN,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;YAC/D,QAAQ,EAAE;gBACT,YAAY,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;gBACjE,YAAY,EAAE,OAAO,CAAC,MAAM;gBAC5B,gBAAgB,EAAE,wBAAwB,CAAC,aAAa;aACxD;SACD,CAAC;IACH,CAAC;IAEQ,eAAe;QACvB,OAAO;YACN,6DAA6D;YAC7D,8BAA8B,wBAAwB,CAAC,aAAa,GAAG;YACvE,oBAAoB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI;SACtD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAEQ,KAAK,CAAC,cAAc,CAC5B,OAAe,EACf,OAAiB,EAAE,EACnB,OAA+B;QAE/B,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE;YAC9D,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC;YACtC,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC;YAClC,OAAO,EAAE,OAAO,EAAE,GAAG;YACrB,SAAS,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,OAAO;YAC3C,WAAW,EAAE,OAAO,EAAE,WAAW;YACjC,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,QAAQ,EAAE,OAAO,EAAE,QAAQ;SAC3B,CAAC,CAAC;QAEH,OAAO;YACN,OAAO;YACP,IAAI;YACJ,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,MAAM,EAAE,MAAM,CAAC,MAAM;SACrB,CAAC;IACH,CAAC;IAED,SAAS;QACR,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAGO,KAAK,CAAC,qBAAqB,CAAC,SAAiB;QACpD,IAAI,CAAC;YACJ,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,YAAY,oCAAmB,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;YAC9E,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;IAGO,UAAU,CAAC,GAAkC;QACpD,MAAM,MAAM,GAAG;YACd,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG;YACnB,GAAG,GAAG;SACN,CAAC;QACF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAC5C,CAAC,KAAK,EAA6B,EAAE,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CAClE,CAAC;QACF,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrE,CAAC;IAEO,gBAAgB;QACvB,IAAA,gBAAM,EAAC,IAAI,CAAC,SAAS,EAAE,kCAAkC,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;;AAnJF,4DAoJC"}

package/dist/workspace/sandbox-fs.d.ts

@@ -1,9 +1,40 @@
-import type { Workspace } from '@mastra/core/workspace';
-export declare function runInSandbox(workspace: Workspace, command: string, cwd?: string): Promise<{
+interface SandboxCommandResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export interface SandboxWorkspace {
+    filesystem?: {
+        provider?: string;
+        basePath?: string;
+        init?: () => Promise<void>;
+        writeFile: (path: string, content: string | Buffer, options?: {
+            recursive?: boolean;
+        }) => Promise<void>;
+        mkdir: (path: string, options?: {
+            recursive?: boolean;
+        }) => Promise<void>;
+    };
+    sandbox?: {
+        provider?: string;
+        executeCommand?: (command: string, args?: string[], options?: {
+            cwd?: string;
+        }) => Promise<SandboxCommandResult>;
+        processes?: {
+            spawn: (command: string, options?: {
+                cwd?: string;
+            }) => Promise<{
+                wait: () => Promise<SandboxCommandResult>;
+            }>;
+        };
+    };
+}
+export declare function runInSandbox(workspace: SandboxWorkspace, command: string, cwd?: string): Promise<{
     exitCode: number;
     stdout: string;
     stderr: string;
 }>;
-export declare function writeFileViaSandbox(workspace: Workspace, filePath: string, content: string | Buffer): Promise<void>;
-export declare function readFileViaSandbox(workspace: Workspace, filePath: string): Promise<string | null>;
+export declare function writeFileViaSandbox(workspace: SandboxWorkspace, filePath: string, content: string | Buffer): Promise<void>;
+export declare function readFileViaSandbox(workspace: SandboxWorkspace, filePath: string): Promise<string | null>;
 export declare function escapeSingleQuotes(s: string): string;
+export {};

package/dist/workspace/sandbox-fs.js

@@ -54,7 +54,7 @@ async function writeFileViaSandbox(workspace, filePath, content) {
         const chunk = b64.slice(offset, offset + BASE64_WRITE_CHUNK_SIZE);
         await runWriteCommand(`printf '%s' '${chunk}' >> '${escapedTempPath}'`);
     }
-    await runWriteCommand(`base64 -d '${escapedTempPath}' > '${escapeSingleQuotes(filePath)}'; status=$?; rm -f '${escapedTempPath}'; exit $status`);
+    await runWriteCommand(`base64 -d '${escapedTempPath}' > '${escapeSingleQuotes(filePath)}'; rc=$?; rm -f '${escapedTempPath}'; exit $rc`);
 }
 async function readFileViaSandbox(workspace, filePath) {
     const result = await runInSandbox(workspace, `cat '${escapeSingleQuotes(filePath)}' 2>/dev/null`);

package/dist/workspace/sandbox-fs.js.map

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

package/dist/workspace/sandbox-setup.d.ts

@@ -1,13 +1,22 @@
-import type { Workspace } from '@mastra/core/workspace';
 import type { Logger } from '../logger';
 import type { InstanceAiContext, SearchableNodeDescription } from '../types';
+import type { BuilderTemplatesBundle } from './builder-templates-service';
+import { type SandboxWorkspace } from './sandbox-fs';
+type SandboxWorkspaceSetupStep = 'resolve-workspace-root' | 'read-initialization-marker' | 'list-node-types' | 'write-workspace-files' | 'write-curated-examples' | 'install-dependencies' | 'link-workspace-sdk' | 'write-initialization-marker';
+export declare class SandboxWorkspaceSetupError extends Error {
+    readonly step: SandboxWorkspaceSetupStep;
+    readonly originalError: unknown;
+    constructor(step: SandboxWorkspaceSetupStep, originalError: unknown);
+}
 export declare const WORKSPACE_DIR = "workspace";
 export declare const N8N_SANDBOX_HOME = "/home/user";
 export declare const N8N_SANDBOX_WORKSPACE_ROOT = "/home/user/workspace";
 export declare const PACKAGE_JSON: string;
+export declare function linkWorkspaceSdkIfEnabled(workspace: SandboxWorkspace, root: string, logger?: Logger): Promise<void>;
 export declare const BUILD_MJS = "const filePath = process.argv[2] || './src/workflow.ts';\ntry {\n  const mod = await import(filePath);\n  const wf = mod.default;\n  if (!wf || typeof wf.toJSON !== 'function') {\n    console.log(JSON.stringify({ success: false, errors: ['Default export is not a workflow. Make sure your file has: export default workflow(...)'] }));\n    process.exit(1);\n  }\n  const validation = wf.validate();\n  const json = wf.toJSON({ tidyUp: true });\n  const warnings = [...(validation.errors || []), ...(validation.warnings || [])];\n  // Use a replacer to preserve undefined values as null \u2014 newCredential() produces\n  // NewCredentialImpl which serializes to undefined in toJSON(). Without this,\n  // JSON.stringify drops the credential keys entirely and the server can't resolve them.\n  const replacer = (k, v) => v === undefined ? null : v;\n  console.log(JSON.stringify({ success: true, workflow: json, warnings }, replacer));\n} catch (e) {\n  console.log(JSON.stringify({ success: false, errors: [e instanceof Error ? e.message : String(e)] }));\n  process.exit(1);\n}\n";
 export declare const TSCONFIG_JSON: string;
 export declare function formatNodeCatalogLine(node: SearchableNodeDescription): string;
-export declare function getWorkspaceRoot(workspace: Workspace): Promise<string>;
-export declare function writeCuratedExamples(workspace: Workspace, logger?: Logger): Promise<void>;
-export declare function setupSandboxWorkspace(workspace: Workspace, context: InstanceAiContext): Promise<boolean>;
+export declare function getWorkspaceRoot(workspace: SandboxWorkspace): Promise<string>;
+export declare function writeCuratedExamples(workspace: SandboxWorkspace, bundle: BuilderTemplatesBundle | null, logger?: Logger): Promise<void>;
+export declare function setupSandboxWorkspace(workspace: SandboxWorkspace, context: InstanceAiContext): Promise<boolean>;
+export {};