@n8n/instance-ai 1.10.1 → 1.11.0

package/dist/workspace/snapshot-manager.js

@@ -1,21 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SnapshotManager = void 0;
-const posix_1 = require("node:path/posix");
-const lazy_daytona_1 = require("./lazy-daytona");
+const sandbox_1 = require("@n8n/agents/sandbox");
+const materialize_knowledge_base_1 = require("../knowledge-base/materialize-knowledge-base");
+const builder_templates_service_1 = require("./builder-templates-service");
 const sandbox_setup_1 = require("./sandbox-setup");
+const snapshot_image_context_1 = require("./snapshot-image-context");
 const materialize_runtime_skills_1 = require("../skills/materialize-runtime-skills");
 const runtime_skills_1 = require("../skills/runtime-skills");
-const DAYTONA_WORKSPACE_ROOT = '/home/daytona/workspace';
-const EMPTY_RUNTIME_SKILLS_HASH = '000000000000';
-function b64(s) {
-    return Buffer.from(s, 'utf-8').toString('base64');
-}
-function shellQuote(value) {
-    return `'${value.replaceAll("'", "'\"'\"'")}'`;
-}
+const DAYTONA_WORKSPACE_BAKE_ROOT = '/tmp/n8n-workspace-bake';
+const SNAPSHOT_WORKSPACE_LAYOUT_DIRS = ['src', 'chunks', 'node-types'];
 function isAlreadyExistsError(error) {
-    const { DaytonaError } = (0, lazy_daytona_1.loadDaytona)();
+    const { DaytonaError } = (0, sandbox_1.loadDaytona)();
     if (!(error instanceof DaytonaError))
         return false;
     if (error.statusCode === 409)
@@ -26,18 +22,18 @@ class SnapshotManager {
     baseImage;
     logger;
     n8nVersion;
-    errorReporter;
     runtimeSkillSource;
+    templatesService;
     cachedImage = null;
-    snapshotPromise = null;
-    snapshotSuffixPromise = null;
     runtimeSkillBundlePromise = null;
-    constructor(baseImage, logger, n8nVersion, errorReporter, runtimeSkillSource) {
+    knowledgeBaseBundlePromise = null;
+    stagingDir = null;
+    constructor(baseImage, logger, n8nVersion, runtimeSkillSource, templatesService) {
         this.baseImage = baseImage;
         this.logger = logger;
         this.n8nVersion = n8nVersion;
-        this.errorReporter = errorReporter;
         this.runtimeSkillSource = runtimeSkillSource;
+        this.templatesService = templatesService;
     }
     async ensureImage() {
         this.cachedImage ??= this.prepareImage();
@@ -46,29 +42,38 @@ class SnapshotManager {
     async prepareImage() {
         const base = this.baseImage ?? 'daytonaio/sandbox:0.5.0';
         const runtimeSkillBundle = await this.runtimeSkillBundle();
-        const runtimeSkillCommands = runtimeSkillBundle === undefined
-            ? []
-            : [...runtimeSkillBundle.files].map(([filePath, content]) => {
-                return `mkdir -p ${shellQuote((0, posix_1.dirname)(filePath))} && echo '${b64(content)}' | base64 -d > ${shellQuote(filePath)}`;
-            });
-        const { Image } = (0, lazy_daytona_1.loadDaytona)();
-        let image = Image.base(base)
-            .runCommands(`mkdir -p ${DAYTONA_WORKSPACE_ROOT}/src ${DAYTONA_WORKSPACE_ROOT}/chunks ${DAYTONA_WORKSPACE_ROOT}/node-types`)
-            .runCommands(`echo '${b64(sandbox_setup_1.PACKAGE_JSON)}' | base64 -d > ${DAYTONA_WORKSPACE_ROOT}/package.json`, `echo '${b64(sandbox_setup_1.TSCONFIG_JSON)}' | base64 -d > ${DAYTONA_WORKSPACE_ROOT}/tsconfig.json`, `echo '${b64(sandbox_setup_1.BUILD_MJS)}' | base64 -d > ${DAYTONA_WORKSPACE_ROOT}/build.mjs`);
-        if (runtimeSkillCommands.length > 0) {
-            image = image.runCommands(...runtimeSkillCommands);
-        }
-        image = image.runCommands(`cd ${DAYTONA_WORKSPACE_ROOT} && npm install --ignore-scripts`);
+        const knowledgeBaseBundle = await this.knowledgeBaseBundle();
+        const cacheKey = this.n8nVersion ?? `${runtimeSkillBundle?.skillsHash}-${knowledgeBaseBundle.contentHash}`;
+        const workspaceFiles = new Map([
+            ...(runtimeSkillBundle?.files ?? []),
+            ...(knowledgeBaseBundle?.files ?? []),
+        ]);
+        workspaceFiles.set(`${sandbox_1.DAYTONA_WORKSPACE_ROOT}/package.json`, sandbox_setup_1.PACKAGE_JSON);
+        workspaceFiles.set(`${sandbox_1.DAYTONA_WORKSPACE_ROOT}/tsconfig.json`, sandbox_setup_1.TSCONFIG_JSON);
+        workspaceFiles.set(`${sandbox_1.DAYTONA_WORKSPACE_ROOT}/build.mjs`, sandbox_setup_1.BUILD_MJS);
+        const { stagingDir } = await (0, snapshot_image_context_1.stageWorkspaceFilesForImage)(workspaceFiles, sandbox_1.DAYTONA_WORKSPACE_ROOT, cacheKey);
+        this.stagingDir = stagingDir;
+        const { Image } = (0, sandbox_1.loadDaytona)();
+        const layoutDirs = SNAPSHOT_WORKSPACE_LAYOUT_DIRS.map((dir) => `${sandbox_1.DAYTONA_WORKSPACE_ROOT}/${dir}`).join(' ');
+        const image = Image.base(base)
+            .addLocalDir(stagingDir, DAYTONA_WORKSPACE_BAKE_ROOT)
+            .runCommands(`cp -a ${DAYTONA_WORKSPACE_BAKE_ROOT}/. ${sandbox_1.DAYTONA_WORKSPACE_ROOT}/ && mkdir -p ${layoutDirs} && cd ${sandbox_1.DAYTONA_WORKSPACE_ROOT} && npm install --ignore-scripts`);
         this.logger.info('Builder image descriptor prepared', {
             base,
             dockerfileLength: image.dockerfile.length,
             runtimeSkillsHash: runtimeSkillBundle?.skillsHash,
             runtimeSkillFiles: runtimeSkillBundle?.files.size ?? 0,
+            knowledgeBaseHash: knowledgeBaseBundle.contentHash,
+            knowledgeBaseFiles: knowledgeBaseBundle.files.size,
+            stagingDir,
         });
         return image;
     }
     async createSnapshot(daytona, options) {
-        const name = await this.snapshotName();
+        const name = this.snapshotName();
+        if (!name) {
+            throw new Error('SnapshotManager: n8nVersion is required to derive a snapshot name');
+        }
         try {
             await daytona.snapshot.create({ name, image: await this.ensureImage() }, options);
             this.logger.info('Created versioned Daytona snapshot', { name });
@@ -82,57 +87,42 @@ class SnapshotManager {
             throw error;
         }
     }
-    async ensureSnapshot(daytona, mode) {
+    snapshotName() {
         if (!this.n8nVersion)
             return null;
-        const name = await this.snapshotName();
-        if (mode === 'proxy')
-            return name;
-        if (!daytona) {
-            throw new Error('SnapshotManager: Daytona client is required to create a snapshot');
-        }
-        this.snapshotPromise ??= this.createSnapshot(daytona).catch((error) => {
-            this.errorReporter?.error(error, {
-                tags: { component: 'snapshot-manager', operation: 'create-snapshot' },
-                extra: { snapshotName: name },
-            });
-            this.logger.warn('Failed to create versioned snapshot; using declarative image', {
-                name,
-                error: error instanceof Error ? error.message : String(error),
-            });
-            return null;
-        });
-        const result = await this.snapshotPromise;
-        if (result === null)
-            this.snapshotPromise = null;
-        return result;
-    }
-    async snapshotSuffix() {
-        this.snapshotSuffixPromise ??= (async () => {
-            const runtimeSkillBundle = await this.runtimeSkillBundle();
-            return runtimeSkillBundle?.skillsHash ?? EMPTY_RUNTIME_SKILLS_HASH;
-        })();
-        return await this.snapshotSuffixPromise;
+        return `n8n/instance-ai:${this.n8nVersion}`;
     }
     async runtimeSkillBundle() {
         this.runtimeSkillBundlePromise ??= (0, materialize_runtime_skills_1.buildRuntimeSkillWorkspaceBundle)({
             source: this.runtimeSkillSource ?? (0, runtime_skills_1.loadInstanceAiRuntimeSkillSource)(),
-            root: DAYTONA_WORKSPACE_ROOT,
+            root: sandbox_1.DAYTONA_WORKSPACE_ROOT,
             logger: this.logger,
         });
         return await this.runtimeSkillBundlePromise;
     }
-    async snapshotName() {
-        if (!this.n8nVersion) {
-            throw new Error('SnapshotManager: n8nVersion is required to derive a snapshot name');
-        }
-        return `n8n/instance-ai:${this.n8nVersion}-${await this.snapshotSuffix()}`;
+    async knowledgeBaseBundle() {
+        this.knowledgeBaseBundlePromise ??= this.buildKnowledgeBaseBundle();
+        return await this.knowledgeBaseBundlePromise;
+    }
+    async buildKnowledgeBaseBundle() {
+        const templatesService = this.templatesService ??
+            new builder_templates_service_1.BuilderTemplatesService((0, builder_templates_service_1.builderTemplatesOptionsFromEnv)({ logger: this.logger }));
+        const templatesBundle = await templatesService.getBundle();
+        return await (0, materialize_knowledge_base_1.buildKnowledgeBaseWorkspaceBundle)({
+            root: sandbox_1.DAYTONA_WORKSPACE_ROOT,
+            templatesArchive: templatesBundle.archive,
+            logger: this.logger,
+        });
     }
     invalidate() {
+        const stagingDir = this.stagingDir;
         this.cachedImage = null;
-        this.snapshotPromise = null;
-        this.snapshotSuffixPromise = null;
         this.runtimeSkillBundlePromise = null;
+        this.knowledgeBaseBundlePromise = null;
+        this.stagingDir = null;
+        if (stagingDir) {
+            void (0, snapshot_image_context_1.disposeSnapshotImageContext)(stagingDir);
+        }
     }
 }
 exports.SnapshotManager = SnapshotManager;

package/dist/workspace/snapshot-manager.js.map

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

package/dist/workspace/template-telemetry.js

@@ -9,9 +9,9 @@ exports.createTypedToolObserver = createTypedToolObserver;
 const utils_1 = require("@n8n/utils");
 const MAX_QUERY_LENGTH = 200;
 const MAX_USER_REQUEST_LENGTH = 120;
-const SEARCH_PATTERN = /\bgrep\b[^|]*\bexamples\/index\.txt\b/;
+const SEARCH_PATTERN = /\bgrep\b[^|]*\bknowledge-base\/templates\/index\.json\b/;
 const READ_COMMAND_HEADS = ['cat', 'head', 'tail', 'sed', 'less', 'more'];
-const READ_FILE_PATTERN = /\bexamples\/([a-zA-Z0-9._-]+\.ts)\b/;
+const READ_FILE_PATTERN = /\bknowledge-base\/templates\/([a-zA-Z0-9._-]+\.ts)\b/;
 function createTemplateTelemetrySession(opts) {
     const baseProps = {
         thread_id: opts.threadId,
@@ -128,7 +128,7 @@ function getTemplateTelemetrySession(workspace) {
 }
 const TYPED_READ_TOOL = 'workspace_read_file';
 const TYPED_GREP_TOOL = 'workspace_grep';
-const EXAMPLES_PATH_PATTERN = /(?:^|\/)examples(?:$|\/)/;
+const TEMPLATES_PATH_PATTERN = /(?:^|\/)knowledge-base\/templates(?:$|\/)/;
 function createTypedToolObserver(session) {
     const pending = new Map();
     return (event) => {
@@ -171,7 +171,7 @@ function matchTypedTemplateCall(toolName, args) {
     }
     if (toolName === TYPED_GREP_TOOL) {
         const path = typeof args.path === 'string' ? args.path : '';
-        if (!EXAMPLES_PATH_PATTERN.test(path))
+        if (!TEMPLATES_PATH_PATTERN.test(path))
             return undefined;
         const pattern = typeof args.pattern === 'string' ? args.pattern : '';
         return { kind: 'search', query: pattern };

package/dist/workspace/template-telemetry.js.map

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

package/dist/workspace/workspace-file-content.d.ts

@@ -0,0 +1,2 @@
+export declare function withTrailingNewline(content: string): string;
+export declare function stringifyWorkspaceJson(value: unknown): string;

package/dist/workspace/workspace-file-content.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withTrailingNewline = withTrailingNewline;
+exports.stringifyWorkspaceJson = stringifyWorkspaceJson;
+function withTrailingNewline(content) {
+    return content.endsWith('\n') ? content : `${content}\n`;
+}
+function stringifyWorkspaceJson(value) {
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+//# sourceMappingURL=workspace-file-content.js.map

package/dist/workspace/workspace-file-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-file-content.js","sourceRoot":"","sources":["../../src/workspace/workspace-file-content.ts"],"names":[],"mappings":";;AACA,kDAEC;AAGD,wDAEC;AAPD,SAAgB,mBAAmB,CAAC,OAAe;IAClD,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC;AAC1D,CAAC;AAGD,SAAgB,sBAAsB,CAAC,KAAc;IACpD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { Logger } from '../logger';
+import { type SandboxWorkspace } from './sandbox-fs';
+export interface WorkspaceFileTarget {
+    filesystem?: {
+        readFile?: (path: string, options?: {
+            encoding?: 'utf-8';
+        }) => Promise<string | Buffer>;
+        writeFile: (path: string, content: string | Buffer, options?: {
+            recursive?: boolean;
+        }) => Promise<void>;
+    };
+    sandbox?: SandboxWorkspace['sandbox'];
+}
+export interface WorkspaceFileOptions {
+    logger?: Logger;
+    resourceLabel?: string;
+}
+export declare function readWorkspaceFile(workspace: WorkspaceFileTarget, filePath: string, options?: WorkspaceFileOptions): Promise<string | null>;
+export declare function writeWorkspaceFile(workspace: WorkspaceFileTarget, filePath: string, content: string, options?: WorkspaceFileOptions): Promise<void>;
+export declare function writeWorkspaceFileMap(workspace: WorkspaceFileTarget, files: Map<string, string>, options?: WorkspaceFileOptions): Promise<void>;

package/dist/workspace/workspace-files.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readWorkspaceFile = readWorkspaceFile;
+exports.writeWorkspaceFile = writeWorkspaceFile;
+exports.writeWorkspaceFileMap = writeWorkspaceFileMap;
+const error_formatting_1 = require("../error-formatting");
+const sandbox_fs_1 = require("./sandbox-fs");
+function resourceLabel(options) {
+    return options?.resourceLabel ?? 'Workspace file';
+}
+function decodeWorkspaceFileContent(content) {
+    return Buffer.isBuffer(content) ? content.toString('utf-8') : content;
+}
+async function readWorkspaceFile(workspace, filePath, options) {
+    const filesystem = workspace.filesystem;
+    if (filesystem?.readFile) {
+        try {
+            return decodeWorkspaceFileContent(await filesystem.readFile(filePath, { encoding: 'utf-8' }));
+        }
+        catch (error) {
+            options?.logger?.debug(`${resourceLabel(options)} filesystem read missed`, {
+                path: filePath,
+                error: (0, error_formatting_1.formatErrorForLog)(error),
+            });
+            return null;
+        }
+    }
+    if (!workspace.sandbox)
+        return null;
+    try {
+        return await (0, sandbox_fs_1.readFileViaSandbox)(workspace, filePath);
+    }
+    catch (error) {
+        options?.logger?.debug(`${resourceLabel(options)} command read missed`, {
+            path: filePath,
+            error: (0, error_formatting_1.formatErrorForLog)(error),
+        });
+        return null;
+    }
+}
+async function writeWorkspaceFile(workspace, filePath, content, options) {
+    const label = resourceLabel(options);
+    if (workspace.filesystem) {
+        try {
+            await workspace.filesystem.writeFile(filePath, content, { recursive: true });
+            return;
+        }
+        catch (error) {
+            try {
+                await (0, sandbox_fs_1.writeFileViaSandbox)(workspace, filePath, content);
+                options?.logger?.warn(`${label} filesystem write failed; used command fallback`, {
+                    path: filePath,
+                    error: (0, error_formatting_1.formatErrorForLog)(error),
+                });
+                return;
+            }
+            catch (fallbackError) {
+                throw new Error(`Failed to write ${label.toLowerCase()} "${filePath}": ${(0, error_formatting_1.formatErrorForLog)(error)}; command fallback failed: ${(0, error_formatting_1.formatErrorForLog)(fallbackError)}`);
+            }
+        }
+    }
+    try {
+        await (0, sandbox_fs_1.writeFileViaSandbox)(workspace, filePath, content);
+    }
+    catch (error) {
+        throw new Error(`Failed to write ${label.toLowerCase()} "${filePath}": ${(0, error_formatting_1.formatErrorForLog)(error)}`);
+    }
+}
+async function writeWorkspaceFileMap(workspace, files, options) {
+    await Promise.all(Array.from(files, async ([filePath, content]) => {
+        await writeWorkspaceFile(workspace, filePath, content, options);
+    }));
+}
+//# sourceMappingURL=workspace-files.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-files.js","sourceRoot":"","sources":["../../src/workspace/workspace-files.ts"],"names":[],"mappings":";;AAkCA,8CA6BC;AAMD,gDAmCC;AAED,sDAUC;AApHD,0DAAwD;AAExD,6CAA8F;AAoB9F,SAAS,aAAa,CAAC,OAA8B;IACpD,OAAO,OAAO,EAAE,aAAa,IAAI,gBAAgB,CAAC;AACnD,CAAC;AAED,SAAS,0BAA0B,CAAC,OAAwB;IAC3D,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACvE,CAAC;AAMM,KAAK,UAAU,iBAAiB,CACtC,SAA8B,EAC9B,QAAgB,EAChB,OAA8B;IAE9B,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC;IACxC,IAAI,UAAU,EAAE,QAAQ,EAAE,CAAC;QAC1B,IAAI,CAAC;YACJ,OAAO,0BAA0B,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAC/F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,yBAAyB,EAAE;gBAC1E,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,IAAA,oCAAiB,EAAC,KAAK,CAAC;aAC/B,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAEpC,IAAI,CAAC;QACJ,OAAO,MAAM,IAAA,+BAAkB,EAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,sBAAsB,EAAE;YACvE,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,IAAA,oCAAiB,EAAC,KAAK,CAAC;SAC/B,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAMM,KAAK,UAAU,kBAAkB,CACvC,SAA8B,EAC9B,QAAgB,EAChB,OAAe,EACf,OAA8B;IAE9B,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAErC,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;QAC1B,IAAI,CAAC;YACJ,MAAM,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7E,OAAO;QACR,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC;gBACJ,MAAM,IAAA,gCAAmB,EAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACxD,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,KAAK,iDAAiD,EAAE;oBAChF,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,IAAA,oCAAiB,EAAC,KAAK,CAAC;iBAC/B,CAAC,CAAC;gBACH,OAAO;YACR,CAAC;YAAC,OAAO,aAAa,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CACd,mBAAmB,KAAK,CAAC,WAAW,EAAE,KAAK,QAAQ,MAAM,IAAA,oCAAiB,EAAC,KAAK,CAAC,8BAA8B,IAAA,oCAAiB,EAAC,aAAa,CAAC,EAAE,CACjJ,CAAC;YACH,CAAC;QACF,CAAC;IACF,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,IAAA,gCAAmB,EAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACd,mBAAmB,KAAK,CAAC,WAAW,EAAE,KAAK,QAAQ,MAAM,IAAA,oCAAiB,EAAC,KAAK,CAAC,EAAE,CACnF,CAAC;IACH,CAAC;AACF,CAAC;AAEM,KAAK,UAAU,qBAAqB,CAC1C,SAA8B,EAC9B,KAA0B,EAC1B,OAA8B;IAE9B,MAAM,OAAO,CAAC,GAAG,CAChB,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE;QAC/C,MAAM,kBAAkB,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC,CAAC,CACF,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,12 @@
+export declare const WORKSPACE_MANIFEST_FILE = ".manifest.json";
+export interface VersionedWorkspaceManifest<THashField extends string = string> {
+    schemaVersion: number;
+    hashField: THashField;
+    hash: string;
+}
+interface ParseVersionedWorkspaceManifestOptions<THashField extends string> {
+    schemaVersion: number;
+    hashField: THashField;
+}
+export declare function parseVersionedWorkspaceManifest<const THashField extends string>(raw: string, options: ParseVersionedWorkspaceManifestOptions<THashField>): VersionedWorkspaceManifest<THashField> | null;
+export {};

package/dist/workspace/workspace-manifest.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORKSPACE_MANIFEST_FILE = void 0;
+exports.parseVersionedWorkspaceManifest = parseVersionedWorkspaceManifest;
+const stream_helpers_1 = require("../utils/stream-helpers");
+exports.WORKSPACE_MANIFEST_FILE = '.manifest.json';
+function parseVersionedWorkspaceManifest(raw, options) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!(0, stream_helpers_1.isRecord)(parsed))
+        return null;
+    if (parsed.schemaVersion !== options.schemaVersion)
+        return null;
+    const hash = parsed[options.hashField];
+    if (typeof hash !== 'string' || hash.length === 0)
+        return null;
+    return {
+        schemaVersion: options.schemaVersion,
+        hashField: options.hashField,
+        hash,
+    };
+}
+//# sourceMappingURL=workspace-manifest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-manifest.js","sourceRoot":"","sources":["../../src/workspace/workspace-manifest.ts"],"names":[],"mappings":";;;AAgBA,0EAsBC;AAtCD,4DAAmD;AAEtC,QAAA,uBAAuB,GAAG,gBAAgB,CAAC;AAcxD,SAAgB,+BAA+B,CAC9C,GAAW,EACX,OAA2D;IAE3D,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACJ,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI,CAAC,IAAA,yBAAQ,EAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,MAAM,CAAC,aAAa,KAAK,OAAO,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC;IAEhE,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE/D,OAAO;QACN,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI;KACJ,CAAC;AACH,CAAC"}

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@n8n/instance-ai",
-  "version": "1.10.1",
+  "version": "1.11.0",
   "main": "dist/index.js",
   "module": "src/index.ts",
   "types": "dist/index.d.ts",
   "files": [
     "dist/**/*",
     "skills/**/*",
-    "LICENSE_EE.md",
-    "LICENSE.md"
+    "LICENSE.md",
+    "LICENSE_EE.md"
   ],
   "exports": {
     ".": {
@@ -34,8 +34,8 @@
     "@daytonaio/sdk": "0.175.0",
     "@joplin/turndown-plugin-gfm": "^1.0.12",
     "@mozilla/readability": "^0.6.0",
-    "@n8n/sandbox-client": "0.0.4",
     "@opentelemetry/api": "^1.9.0",
+    "@thednp/dommatrix": "^2.0.12",
     "csv-parse": "6.2.1",
     "fast-glob": "3.2.12",
     "flatted": "3.4.2",
@@ -51,23 +51,27 @@
     "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.2/xlsx-0.20.2.tgz",
     "zod": "3.25.67",
     "zod-from-json-schema-v3": "npm:zod-from-json-schema@^0.0.5",
-    "@n8n/agents": "0.10.1",
-    "@n8n/api-types": "1.25.1",
-    "@n8n/mcp-browser": "0.8.0",
-    "@n8n/utils": "1.33.0",
-    "n8n-workflow": "2.25.1",
-    "@n8n/workflow-sdk": "0.18.1"
+    "@n8n/agents": "0.11.0",
+    "@n8n/utils": "1.34.0",
+    "@n8n/mcp-browser": "0.9.0",
+    "@n8n/workflow-sdk": "0.19.0",
+    "@n8n/api-types": "1.26.0",
+    "n8n-workflow": "2.26.0"
   },
   "devDependencies": {
-    "@ai-sdk/anthropic": "3.0.58",
+    "@ai-sdk/anthropic": "^3.0.81",
     "@langchain/anthropic": "1.3.27",
     "@langchain/core": "1.1.41",
     "@types/luxon": "3.2.0",
     "@types/psl": "1.1.3",
     "@types/turndown": "^5.0.5",
+    "@vitest/coverage-v8": "4.1.1",
     "tsx": "^4.19.3",
-    "@n8n/ai-workflow-builder": "1.25.1",
-    "@n8n/typescript-config": "1.4.0"
+    "vitest": "^4.1.1",
+    "vitest-mock-extended": "^3.1.0",
+    "@n8n/ai-workflow-builder": "1.26.0",
+    "@n8n/typescript-config": "1.5.0",
+    "@n8n/vitest-config": "1.14.0"
   },
   "license": "SEE LICENSE IN LICENSE.md",
   "homepage": "https://n8n.io",
@@ -83,10 +87,12 @@
     "clean": "rimraf dist .turbo",
     "typecheck": "tsc --noEmit",
     "build": "tsc -p ./tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+    "build:unchecked": "tsc -p ./tsconfig.build.json --noCheck && tsc-alias -p tsconfig.build.json",
     "format": "biome format --write src",
     "format:check": "biome ci src",
-    "test": "jest",
-    "test:unit": "jest",
+    "test": "vitest run",
+    "test:unit": "vitest run",
+    "test:dev": "vitest --silent=false",
     "lint": "eslint . --quiet",
     "lint:fix": "eslint . --fix",
     "eval:instance-ai": "tsx evaluations/cli/index.ts",

package/skills/data-table-manager/SKILL.md

@@ -2,10 +2,10 @@
 name: data-table-manager
 description: >-
   Designs and manages n8n Data Tables directly with the data-tables and
-  parse-file tools. Use when the user asks to create, inspect, import, seed,
-  query, update, clean up, rename columns in, or delete data tables and rows,
-  especially from CSV/XLSX/JSON attachments, and before planning workflows that
-  create or write to Data Tables.
+  parse-file tools. Use when the user asks to list, show, create, inspect,
+  import, seed, query, update, clean up, rename columns in, or delete data
+  tables and rows, especially from CSV/XLSX/JSON attachments, and before
+  building or planning workflows that create or write to Data Tables.
 recommended_tools:
   - data-tables
   - parse-file
@@ -21,7 +21,7 @@ sub-agent, or create a background plan for data-table-only work.
 
 Also load this skill before planning or building a workflow whose trigger,
 processing steps, or outputs create, inspect, or write Data Table records, then
-pass the relevant schema/row-handling guidance to the planner or builder.
+pass the relevant schema/row-handling guidance to the planning skill or builder.
 
 n8n Data Tables are flat, workflow-friendly stores. Design them so future
 workflow expressions can read predictable field names and so updates/deletes
@@ -40,7 +40,7 @@ can target rows with narrow filters.
 4. Inspect schema before writes, deletes, column changes, imports into an
    existing table, and workflow-facing summaries.
 5. Execute the smallest direct tool sequence. Prefer read -> decide -> write;
-   never use plan/create-tasks/delegate for standalone table work.
+   never use create-tasks or delegate for standalone table work.
 6. Close with facts: table name, table ID when available, project if relevant,
    columns changed, row counts inserted/updated/deleted, skipped rows, and any
    approval or permission blocker.

package/skills/debugging-executions/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: debugging-executions
+description: >-
+  Debug failed or wrong-output workflow executions using executions tools. Load
+  when the user reports execution failures, unexpected node output, or empty
+  parameter values after a successful run.
+recommended_tools:
+  - executions
+  - workflows
+---
+
+# Debugging Executions
+
+Use this skill when debugging workflow execution failures or successful runs
+with wrong or empty values.
+
+## Testing event-triggered workflows
+
+Use `executions(action="run")` with `inputData` matching the trigger's output
+shape — do not rebuild the workflow with a Manual Trigger. For trigger
+`inputData` shapes, read `knowledge-base/reference/trigger-input-data-shapes.md`
+when a sandbox workspace is available.
+
+## Failed execution
+
+`executions(action="debug")` already includes `failedNode.resolvedParameters` —
+start there. That bundle has `parameters` (raw, with expressions intact),
+`resolved` (substituted), `failedExpressions` (those that threw), and
+`emptyResolutions` (those that resolved to `null`/`undefined`/`""` silently).
+The offending expression is usually visible without a follow-up call. Entries in
+either list tagged with `reason: "unreconstructable-context"` are NOT real bugs —
+they reference variables we don't reconstruct in replay (`$vars`, `$secrets`,
+`$response`, `$request`, `$pageCount`, `$ai`). The value existed at execution
+time; we just don't have it here.
+
+## Successful execution with wrong or empty value
+
+When `debug` doesn't apply because nothing errored, call
+`executions(action="get-resolved-node-parameters", executionId, nodeName)` on the
+node whose output looks off — **do this unprompted**, don't ask the user for
+permission first. It's a cheap read-only inspection and the only reliable way to
+confirm whether an empty value came from an expression silently resolving to
+nullish. Check `emptyResolutions` first; most "this parameter is empty" cases are
+expressions resolving to `null`/`undefined`/`""`, not thrown errors.