@n8n/instance-ai 1.0.0

package/dist/utils/agent-tree.d.ts

@@ -0,0 +1,3 @@
+import type { InstanceAiAgentNode, InstanceAiEvent } from '@n8n/api-types';
+export declare function buildAgentTreeFromEvents(events: InstanceAiEvent[]): InstanceAiAgentNode;
+export declare function findAgentNodeInTree(tree: InstanceAiAgentNode, agentId: string): InstanceAiAgentNode | undefined;

package/dist/utils/agent-tree.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAgentTreeFromEvents = buildAgentTreeFromEvents;
+exports.findAgentNodeInTree = findAgentNodeInTree;
+const api_types_1 = require("@n8n/api-types");
+function buildAgentTreeFromEvents(events) {
+    let state = (0, api_types_1.createInitialState)();
+    for (const event of events) {
+        state = (0, api_types_1.reduceEvent)(state, event);
+    }
+    return (0, api_types_1.toAgentTree)(state);
+}
+function findAgentNodeInTree(tree, agentId) {
+    if (tree.agentId === agentId)
+        return tree;
+    for (const child of tree.children) {
+        const found = findAgentNodeInTree(child, agentId);
+        if (found)
+            return found;
+    }
+    return undefined;
+}
+//# sourceMappingURL=agent-tree.js.map

package/dist/utils/agent-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tree.js","sourceRoot":"","sources":["../../src/utils/agent-tree.ts"],"names":[],"mappings":";;AAGA,4DAMC;AAED,kDAUC;AArBD,8CAA8E;AAG9E,SAAgB,wBAAwB,CAAC,MAAyB;IACjE,IAAI,KAAK,GAAG,IAAA,8BAAkB,GAAE,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,KAAK,GAAG,IAAA,uBAAW,EAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,IAAA,uBAAW,EAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,SAAgB,mBAAmB,CAClC,IAAyB,EACzB,OAAe;IAEf,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAClD,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IACzB,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/dist/utils/format-timestamp.d.ts

@@ -0,0 +1 @@
+export declare function formatTimestamp(iso: string): string;

package/dist/utils/format-timestamp.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTimestamp = formatTimestamp;
+function formatTimestamp(iso) {
+    const date = new Date(iso);
+    const datePart = date.toLocaleDateString('en-US', {
+        month: 'short',
+        day: 'numeric',
+        ...(date.getFullYear() !== new Date().getFullYear() ? { year: 'numeric' } : {}),
+    });
+    const timePart = date.toLocaleTimeString('en-GB', {
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        hour12: false,
+    });
+    return `${datePart} ${timePart}`;
+}
+//# sourceMappingURL=format-timestamp.js.map

package/dist/utils/format-timestamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-timestamp.js","sourceRoot":"","sources":["../../src/utils/format-timestamp.ts"],"names":[],"mappings":";;AACA,0CAcC;AAdD,SAAgB,eAAe,CAAC,GAAW;IAC1C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE;QACjD,KAAK,EAAE,OAAO;QACd,GAAG,EAAE,SAAS;QACd,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/E,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE;QACjD,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;KACb,CAAC,CAAC;IACH,OAAO,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC;AAClC,CAAC"}

package/dist/utils/stream-helpers.d.ts

@@ -0,0 +1,15 @@
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export interface SuspensionInfo {
+    toolCallId: string;
+    requestId: string;
+    toolName?: string;
+}
+export declare function parseSuspension(chunk: unknown): SuspensionInfo | null;
+export interface Resumable {
+    resumeStream: (data: Record<string, unknown>, options: Record<string, unknown>) => Promise<{
+        runId?: string;
+        fullStream: AsyncIterable<unknown>;
+        text: Promise<string>;
+    }>;
+}
+export declare function asResumable(agent: unknown): Resumable;

package/dist/utils/stream-helpers.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRecord = isRecord;
+exports.parseSuspension = parseSuspension;
+exports.asResumable = asResumable;
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function parseSuspension(chunk) {
+    if (!isRecord(chunk) || chunk.type !== 'tool-call-suspended')
+        return null;
+    const sp = isRecord(chunk.payload) ? chunk.payload : {};
+    const suspPayload = isRecord(sp.suspendPayload) ? sp.suspendPayload : {};
+    const tcId = typeof sp.toolCallId === 'string' ? sp.toolCallId : '';
+    const reqId = typeof suspPayload.requestId === 'string' && suspPayload.requestId
+        ? suspPayload.requestId
+        : tcId;
+    const toolName = typeof sp.toolName === 'string' ? sp.toolName : undefined;
+    if (!reqId || !tcId)
+        return null;
+    return { toolCallId: tcId, requestId: reqId, toolName };
+}
+function asResumable(agent) {
+    return agent;
+}
+//# sourceMappingURL=stream-helpers.js.map

package/dist/utils/stream-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-helpers.js","sourceRoot":"","sources":["../../src/utils/stream-helpers.ts"],"names":[],"mappings":";;AAMA,4BAEC;AAaD,0CAcC;AAWD,kCAEC;AA1CD,SAAgB,QAAQ,CAAC,KAAc;IACtC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC;AAaD,SAAgB,eAAe,CAAC,KAAc;IAC7C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB;QAAE,OAAO,IAAI,CAAC;IAE1E,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,MAAM,WAAW,GAAG,QAAQ,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,MAAM,KAAK,GACV,OAAO,WAAW,CAAC,SAAS,KAAK,QAAQ,IAAI,WAAW,CAAC,SAAS;QACjE,CAAC,CAAC,WAAW,CAAC,SAAS;QACvB,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,QAAQ,GAAG,OAAO,EAAE,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAE3E,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACzD,CAAC;AAWD,SAAgB,WAAW,CAAC,KAAc;IACzC,OAAO,KAAkB,CAAC;AAC3B,CAAC"}

package/dist/workflow-builder/extract-code.d.ts

@@ -0,0 +1,5 @@
+export declare const SDK_IMPORT_STATEMENT = "import { workflow, node, trigger, sticky, placeholder, newCredential, ifElse, switchCase, merge, splitInBatches, nextBatch, languageModel, memory, tool, outputParser, embedding, embeddings, vectorStore, retriever, documentLoader, textSplitter, fromAi, expr } from '@n8n/workflow-sdk';";
+export declare function stripImportStatements(code: string): string;
+export declare function stripSdkImports(code: string): string;
+export declare function resolveLocalImports(code: string, basePath: string, readFile: (filePath: string) => Promise<string | null>): Promise<string>;
+export declare function extractWorkflowCode(response: string): string;

package/dist/workflow-builder/extract-code.js

@@ -0,0 +1,105 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SDK_IMPORT_STATEMENT = void 0;
+exports.stripImportStatements = stripImportStatements;
+exports.stripSdkImports = stripSdkImports;
+exports.resolveLocalImports = resolveLocalImports;
+exports.extractWorkflowCode = extractWorkflowCode;
+const path = __importStar(require("node:path"));
+exports.SDK_IMPORT_STATEMENT = "import { workflow, node, trigger, sticky, placeholder, newCredential, ifElse, switchCase, merge, splitInBatches, nextBatch, languageModel, memory, tool, outputParser, embedding, embeddings, vectorStore, retriever, documentLoader, textSplitter, fromAi, expr } from '@n8n/workflow-sdk';";
+const IMPORT_REGEX = /^\s*import\s+(?:[\s\S]*?from\s+)?['"]([^'"]+)['"];?\s*$/gm;
+function stripImportStatements(code) {
+    return code
+        .replace(IMPORT_REGEX, '')
+        .replace(/^\s*\n/, '')
+        .trim();
+}
+function stripSdkImports(code) {
+    const sdkImportRegex = /^\s*import\s+(?:[\s\S]*?from\s+)?['"]@n8n\/workflow-sdk['"];?\s*$/gm;
+    return code.replace(sdkImportRegex, '').trim();
+}
+const LOCAL_IMPORT_REGEX = /^\s*import\s+(?:[\s\S]*?from\s+)?['"](\.\.?\/[^'"]+)['"];?\s*$/gm;
+async function resolveLocalImports(code, basePath, readFile) {
+    const resolved = new Set();
+    const inlinedChunks = [];
+    async function resolveFile(fileCode, fileDir, depth) {
+        if (depth > 5)
+            return;
+        const imports = [];
+        let match;
+        const regex = new RegExp(LOCAL_IMPORT_REGEX.source, 'gm');
+        while ((match = regex.exec(fileCode)) !== null) {
+            imports.push({ fullMatch: match[0], specifier: match[1] });
+        }
+        for (const imp of imports) {
+            let resolvedPath = path.resolve(fileDir, imp.specifier);
+            if (!resolvedPath.endsWith('.ts')) {
+                resolvedPath += '.ts';
+            }
+            if (resolved.has(resolvedPath))
+                continue;
+            resolved.add(resolvedPath);
+            const content = await readFile(resolvedPath);
+            if (content === null)
+                continue;
+            await resolveFile(content, path.dirname(resolvedPath), depth + 1);
+            let cleaned = stripSdkImports(content);
+            cleaned = cleaned.replace(new RegExp(LOCAL_IMPORT_REGEX.source, 'gm'), '');
+            cleaned = cleaned.replace(/^export\s+default\s+/gm, '');
+            cleaned = cleaned.replace(/^export\s+/gm, '');
+            cleaned = cleaned.trim();
+            if (cleaned) {
+                inlinedChunks.push(cleaned);
+            }
+        }
+    }
+    await resolveFile(code, basePath, 0);
+    const mainCode = code.replace(new RegExp(LOCAL_IMPORT_REGEX.source, 'gm'), '');
+    if (inlinedChunks.length === 0) {
+        return mainCode;
+    }
+    return [...inlinedChunks, mainCode].join('\n\n');
+}
+function extractWorkflowCode(response) {
+    const codeBlockRegex = /```(?:typescript|ts|javascript|js)?\n([\s\S]*?)```/;
+    const match = response.match(codeBlockRegex);
+    if (match) {
+        const code = match[1].trim();
+        return stripImportStatements(code);
+    }
+    return stripImportStatements(response.trim());
+}
+//# sourceMappingURL=extract-code.js.map

package/dist/workflow-builder/extract-code.js.map

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

package/dist/workflow-builder/index.d.ts

@@ -0,0 +1,5 @@
+export { extractWorkflowCode, stripImportStatements, resolveLocalImports, SDK_IMPORT_STATEMENT, } from './extract-code';
+export { applyPatches } from './patch-code';
+export { parseAndValidate, partitionWarnings } from './parse-validate';
+export { EXPRESSION_REFERENCE, ADDITIONAL_FUNCTIONS, WORKFLOW_RULES, WORKFLOW_SDK_PATTERNS, } from './sdk-prompt-sections';
+export type { ValidationWarning, ParseAndValidateResult } from './types';

package/dist/workflow-builder/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORKFLOW_SDK_PATTERNS = exports.WORKFLOW_RULES = exports.ADDITIONAL_FUNCTIONS = exports.EXPRESSION_REFERENCE = exports.partitionWarnings = exports.parseAndValidate = exports.applyPatches = exports.SDK_IMPORT_STATEMENT = exports.resolveLocalImports = exports.stripImportStatements = exports.extractWorkflowCode = void 0;
+var extract_code_1 = require("./extract-code");
+Object.defineProperty(exports, "extractWorkflowCode", { enumerable: true, get: function () { return extract_code_1.extractWorkflowCode; } });
+Object.defineProperty(exports, "stripImportStatements", { enumerable: true, get: function () { return extract_code_1.stripImportStatements; } });
+Object.defineProperty(exports, "resolveLocalImports", { enumerable: true, get: function () { return extract_code_1.resolveLocalImports; } });
+Object.defineProperty(exports, "SDK_IMPORT_STATEMENT", { enumerable: true, get: function () { return extract_code_1.SDK_IMPORT_STATEMENT; } });
+var patch_code_1 = require("./patch-code");
+Object.defineProperty(exports, "applyPatches", { enumerable: true, get: function () { return patch_code_1.applyPatches; } });
+var parse_validate_1 = require("./parse-validate");
+Object.defineProperty(exports, "parseAndValidate", { enumerable: true, get: function () { return parse_validate_1.parseAndValidate; } });
+Object.defineProperty(exports, "partitionWarnings", { enumerable: true, get: function () { return parse_validate_1.partitionWarnings; } });
+var sdk_prompt_sections_1 = require("./sdk-prompt-sections");
+Object.defineProperty(exports, "EXPRESSION_REFERENCE", { enumerable: true, get: function () { return sdk_prompt_sections_1.EXPRESSION_REFERENCE; } });
+Object.defineProperty(exports, "ADDITIONAL_FUNCTIONS", { enumerable: true, get: function () { return sdk_prompt_sections_1.ADDITIONAL_FUNCTIONS; } });
+Object.defineProperty(exports, "WORKFLOW_RULES", { enumerable: true, get: function () { return sdk_prompt_sections_1.WORKFLOW_RULES; } });
+Object.defineProperty(exports, "WORKFLOW_SDK_PATTERNS", { enumerable: true, get: function () { return sdk_prompt_sections_1.WORKFLOW_SDK_PATTERNS; } });
+//# sourceMappingURL=index.js.map

package/dist/workflow-builder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflow-builder/index.ts"],"names":[],"mappings":";;;AAAA,+CAKwB;AAJvB,mHAAA,mBAAmB,OAAA;AACnB,qHAAA,qBAAqB,OAAA;AACrB,mHAAA,mBAAmB,OAAA;AACnB,oHAAA,oBAAoB,OAAA;AAErB,2CAA4C;AAAnC,0GAAA,YAAY,OAAA;AACrB,mDAAuE;AAA9D,kHAAA,gBAAgB,OAAA;AAAE,mHAAA,iBAAiB,OAAA;AAC5C,6DAK+B;AAJ9B,2HAAA,oBAAoB,OAAA;AACpB,2HAAA,oBAAoB,OAAA;AACpB,qHAAA,cAAc,OAAA;AACd,4HAAA,qBAAqB,OAAA"}

package/dist/workflow-builder/parse-validate.d.ts

@@ -0,0 +1,6 @@
+import type { ParseAndValidateResult, ValidationWarning } from './types';
+export declare function parseAndValidate(code: string): ParseAndValidateResult;
+export declare function partitionWarnings(warnings: ValidationWarning[]): {
+    errors: ValidationWarning[];
+    informational: ValidationWarning[];
+};

package/dist/workflow-builder/parse-validate.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseAndValidate = parseAndValidate;
+exports.partitionWarnings = partitionWarnings;
+const workflow_sdk_1 = require("@n8n/workflow-sdk");
+const extract_code_1 = require("./extract-code");
+function collectValidationIssues(issues, allWarnings) {
+    for (const issue of issues) {
+        allWarnings.push({
+            code: issue.code,
+            message: issue.message,
+            nodeName: issue.nodeName,
+        });
+    }
+}
+function parseAndValidate(code) {
+    const codeToParse = (0, extract_code_1.stripImportStatements)(code);
+    try {
+        const builder = (0, workflow_sdk_1.parseWorkflowCodeToBuilder)(codeToParse);
+        builder.regenerateNodeIds();
+        const allWarnings = [];
+        const graphValidation = builder.validate();
+        collectValidationIssues(graphValidation.errors, allWarnings);
+        collectValidationIssues(graphValidation.warnings, allWarnings);
+        const json = builder.toJSON();
+        const schemaValidation = (0, workflow_sdk_1.validateWorkflow)(json);
+        collectValidationIssues(schemaValidation.errors, allWarnings);
+        collectValidationIssues(schemaValidation.warnings, allWarnings);
+        return { workflow: json, warnings: allWarnings };
+    }
+    catch (error) {
+        throw new Error(`Failed to parse workflow code: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+function partitionWarnings(warnings) {
+    const informationalCodes = new Set(['MISSING_TRIGGER', 'DISCONNECTED_NODE']);
+    const errors = [];
+    const informational = [];
+    for (const w of warnings) {
+        if (informationalCodes.has(w.code)) {
+            informational.push(w);
+        }
+        else {
+            errors.push(w);
+        }
+    }
+    return { errors, informational };
+}
+//# sourceMappingURL=parse-validate.js.map

package/dist/workflow-builder/parse-validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-validate.js","sourceRoot":"","sources":["../../src/workflow-builder/parse-validate.ts"],"names":[],"mappings":";;AAgDA,4CA+BC;AAQD,8CAmBC;AAlGD,oDAAiF;AAEjF,iDAAuD;AAavD,SAAS,uBAAuB,CAC/B,MAAyB,EACzB,WAAgC;IAEhC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,WAAW,CAAC,IAAI,CAAC;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACxB,CAAC,CAAC;IACJ,CAAC;AACF,CAAC;AAcD,SAAgB,gBAAgB,CAAC,IAAY;IAE5C,MAAM,WAAW,GAAG,IAAA,oCAAqB,EAAC,IAAI,CAAC,CAAC;IAEhD,IAAI,CAAC;QAEJ,MAAM,OAAO,GAAG,IAAA,yCAA0B,EAAC,WAAW,CAAC,CAAC;QAGxD,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAE5B,MAAM,WAAW,GAAwB,EAAE,CAAC;QAG5C,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC3C,uBAAuB,CAAC,eAAe,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC7D,uBAAuB,CAAC,eAAe,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAE/D,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAG9B,MAAM,gBAAgB,GAAG,IAAA,+BAAgB,EAAC,IAAI,CAAC,CAAC;QAChD,uBAAuB,CAAC,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC9D,uBAAuB,CAAC,gBAAgB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAEhE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACd,kCAAkC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAC5F,CAAC;IACH,CAAC;AACF,CAAC;AAQD,SAAgB,iBAAiB,CAAC,QAA6B;IAK9D,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAE7E,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,MAAM,aAAa,GAAwB,EAAE,CAAC;IAE9C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QAC1B,IAAI,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,CAAC;IACF,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AAClC,CAAC"}

package/dist/workflow-builder/patch-code.d.ts

@@ -0,0 +1,14 @@
+interface Patch {
+    old_str: string;
+    new_str: string;
+}
+interface PatchResult {
+    success: true;
+    code: string;
+}
+interface PatchError {
+    success: false;
+    error: string;
+}
+export declare function applyPatches(code: string, patches: Patch[]): PatchResult | PatchError;
+export {};

package/dist/workflow-builder/patch-code.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyPatches = applyPatches;
+function normalizeWhitespace(s) {
+    return s.replace(/\s+/g, ' ').trim();
+}
+function normalizeTrimmedLines(s) {
+    return s
+        .split('\n')
+        .map((line) => line.trim())
+        .join('\n');
+}
+function fuzzyFind(haystack, needle, normalizer) {
+    const normalizedNeedle = normalizer(needle);
+    if (!normalizedNeedle)
+        return null;
+    const normalizedHaystack = normalizer(haystack);
+    const idx = normalizedHaystack.indexOf(normalizedNeedle);
+    if (idx === -1)
+        return null;
+    const ratio = haystack.length / Math.max(normalizedHaystack.length, 1);
+    const approxStart = Math.max(0, Math.floor(idx * ratio) - 50);
+    const approxEnd = Math.min(haystack.length, Math.ceil((idx + normalizedNeedle.length) * ratio) + 50);
+    for (let start = approxStart; start <= approxEnd; start++) {
+        for (let end = start + needle.length - 20; end <= Math.min(haystack.length, start + needle.length + 50); end++) {
+            const candidate = haystack.slice(start, end);
+            if (normalizer(candidate) === normalizedNeedle) {
+                return { start, end };
+            }
+        }
+    }
+    for (let start = 0; start < haystack.length; start++) {
+        for (let end = start + 1; end <= Math.min(haystack.length, start + needle.length * 2); end++) {
+            const candidate = haystack.slice(start, end);
+            if (normalizer(candidate) === normalizedNeedle) {
+                return { start, end };
+            }
+        }
+    }
+    return null;
+}
+function findMatch(code, needle) {
+    const exactIdx = code.indexOf(needle);
+    if (exactIdx !== -1) {
+        return { start: exactIdx, end: exactIdx + needle.length, strategy: 'exact' };
+    }
+    const wsMatch = fuzzyFind(code, needle, normalizeWhitespace);
+    if (wsMatch) {
+        return { ...wsMatch, strategy: 'whitespace-normalized' };
+    }
+    const trimMatch = fuzzyFind(code, needle, normalizeTrimmedLines);
+    if (trimMatch) {
+        return { ...trimMatch, strategy: 'trimmed-lines' };
+    }
+    return null;
+}
+function getContextForError(code, needle) {
+    const firstLine = needle.split('\n')[0].trim();
+    if (!firstLine)
+        return '';
+    const lines = code.split('\n');
+    let bestLineIdx = -1;
+    let bestScore = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (!line)
+            continue;
+        if (line.includes(firstLine) || firstLine.includes(line)) {
+            bestLineIdx = i;
+            bestScore = 100;
+            break;
+        }
+        const needleWords = new Set(firstLine.toLowerCase().split(/\W+/).filter(Boolean));
+        const lineWords = line.toLowerCase().split(/\W+/).filter(Boolean);
+        const overlap = lineWords.filter((w) => needleWords.has(w)).length;
+        if (overlap > bestScore) {
+            bestScore = overlap;
+            bestLineIdx = i;
+        }
+    }
+    if (bestLineIdx === -1 || bestScore < 2)
+        return '';
+    const start = Math.max(0, bestLineIdx - 3);
+    const end = Math.min(lines.length, bestLineIdx + 4);
+    const context = lines
+        .slice(start, end)
+        .map((l, i) => {
+        const lineNum = start + i + 1;
+        const marker = start + i === bestLineIdx ? '> ' : '  ';
+        return `${marker}${lineNum}: ${l}`;
+    })
+        .join('\n');
+    return `\nNearest match in code around line ${bestLineIdx + 1}:\n${context}`;
+}
+function applyPatches(code, patches) {
+    let result = code;
+    for (const patch of patches) {
+        const match = findMatch(result, patch.old_str);
+        if (!match) {
+            const context = getContextForError(result, patch.old_str);
+            const truncated = patch.old_str.slice(0, 150) + (patch.old_str.length > 150 ? '...' : '');
+            return {
+                success: false,
+                error: 'Patch failed: could not find old_str in code.' +
+                    '\nSearched for: "' +
+                    truncated +
+                    '"' +
+                    '\nTried: exact match, whitespace-normalized, trimmed-lines.' +
+                    (context || '\nNo similar code found nearby.') +
+                    '\nTip: use get-workflow-as-code to see the exact current code, then match it precisely.',
+            };
+        }
+        result = result.slice(0, match.start) + patch.new_str + result.slice(match.end);
+    }
+    return { success: true, code: result };
+}
+//# sourceMappingURL=patch-code.js.map

package/dist/workflow-builder/patch-code.js.map

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

package/dist/workflow-builder/sdk-prompt-sections.d.ts

@@ -0,0 +1,4 @@
+export declare const EXPRESSION_REFERENCE = "Available variables inside `expr('{{ ... }}')`:\n\n- `$json` \u2014 current item's JSON data from the immediate predecessor node\n- `$('NodeName').item.json` \u2014 access any node's output by name\n- `$input.first()` \u2014 first item from immediate predecessor\n- `$input.all()` \u2014 all items from immediate predecessor\n- `$input.item` \u2014 current item being processed\n- `$binary` \u2014 binary data of current item from immediate predecessor\n- `$now` \u2014 current date/time (Luxon DateTime). Example: `$now.toISO()`\n- `$today` \u2014 start of today (Luxon DateTime). Example: `$today.plus(1, 'days')`\n- `$itemIndex` \u2014 index of current item being processed\n- `$runIndex` \u2014 current run index\n- `$execution.id` \u2014 unique execution ID\n- `$execution.mode` \u2014 'test' or 'production'\n- `$workflow.id` \u2014 workflow ID\n- `$workflow.name` \u2014 workflow name\n\nString composition \u2014 variables MUST always be inside `{{ }}`, never outside as JS variables:\n\n- `expr('Hello {{ $json.name }}, welcome!')` \u2014 variable embedded in text\n- `expr('Report for {{ $now.toFormat(\"MMMM d, yyyy\") }} - {{ $json.title }}')` \u2014 multiple variables with method call\n- `expr('{{ $json.firstName }} {{ $json.lastName }}')` \u2014 combining multiple fields\n- `expr('Total: {{ $json.items.length }} items, updated {{ $now.toISO() }}')` \u2014 expressions with method calls\n- `expr('Status: {{ $json.count > 0 ? \"active\" : \"empty\" }}')` \u2014 inline ternary\n\nDynamic data from other nodes \u2014 `$()` MUST always be inside `{{ }}`, never used as plain JavaScript:\n\n- WRONG: `expr('{{ ' + JSON.stringify($('Source').all().map(i => i.json.name)) + ' }}')` \u2014 $() outside {{ }}\n- CORRECT: `expr('{{ $(\"Source\").all().map(i => ({ option: i.json.name })) }}')` \u2014 $() inside {{ }}";
+export declare const ADDITIONAL_FUNCTIONS = "Additional SDK functions:\n\n- `placeholder('hint')` \u2014 marks a parameter value for user input. Use directly as the parameter value \u2014 never wrap in `expr()`, objects, or arrays.\n  Example: `parameters: { url: placeholder('Your API URL (e.g. https://api.example.com/v1)') }`\n\n- `sticky('content', nodes?, config?)` \u2014 creates a sticky note on the canvas.\n  Example: `sticky('## Data Processing', [httpNode, setNode], { color: 2 })`\n\n- `.output(n)` \u2014 selects a specific output index for multi-output nodes. IF and Switch have dedicated methods (`onTrue/onFalse`, `onCase`), but `.output(n)` works as a generic alternative.\n  Example: `classifier.output(1).to(categoryB)`\n\n- `.onError(handler)` \u2014 connects a node's error output to a handler node. Requires `onError: 'continueErrorOutput'` in the node config.\n  Example: `httpNode.onError(errorHandler)` (with `config: { onError: 'continueErrorOutput' }`)\n\n- Additional subnode factories (all follow the same pattern as `languageModel()` and `tool()`):\n  `memory()`, `outputParser()`, `embeddings()`, `vectorStore()`, `retriever()`, `documentLoader()`, `textSplitter()`";
+export declare const WORKFLOW_RULES = "Follow these rules strictly when generating workflows:\n\n1. **Always use newCredential() for authentication**\n   - When a node needs credentials, always use `newCredential('Name')` in the credentials config\n   - NEVER use placeholder strings, fake API keys, or hardcoded auth values\n   - Example: `credentials: { slackApi: newCredential('Slack Bot') }`\n   - The credential type must match what the node expects\n\n2. **Handle empty outputs with `alwaysOutputData: true`**\n   - Nodes that query data (Data Table get, Google Sheets lookup, HTTP Request, etc.) may return 0 items\n   - When a node returns 0 items, all downstream nodes are SKIPPED \u2014 the workflow chain breaks silently\n   - Set `alwaysOutputData: true` on any node whose output feeds downstream nodes and might return empty results\n   - Common cases: fresh/empty Data Tables, filtered queries, conditional lookups, API searches with no matches\n   - Example: `config: { ..., alwaysOutputData: true }`\n\n3. **Use `executeOnce: true` for single-execution nodes**\n   - When a node receives N items but should only execute once (not N times), set `executeOnce: true`\n   - Common cases: sending a summary notification, generating a report, calling an API that doesn't need per-item execution\n   - Example: `config: { ..., executeOnce: true }`";
+export declare const WORKFLOW_SDK_PATTERNS = "<linear_chain>\n```javascript\nimport { workflow, node, trigger, sticky, placeholder, newCredential, ifElse, switchCase, merge, splitInBatches, nextBatch, languageModel, memory, tool, outputParser, embedding, embeddings, vectorStore, retriever, documentLoader, textSplitter, fromAi, expr } from '@n8n/workflow-sdk';\n\n// 1. Define all nodes first\nconst startTrigger = trigger({\n  type: 'n8n-nodes-base.manualTrigger',\n  version: 1,\n  config: { name: 'Start' }\n});\n\nconst fetchData = node({\n  type: 'n8n-nodes-base.httpRequest',\n  version: 4.3,\n  config: { name: 'Fetch Data', parameters: { method: 'GET', url: '...' } }\n});\n\nconst processData = node({\n  type: 'n8n-nodes-base.set',\n  version: 3.4,\n  config: { name: 'Process Data', parameters: {} }\n});\n\n// 2. Compose workflow\nexport default workflow('id', 'name')\n  .add(startTrigger)\n  .to(fetchData)\n  .to(processData);\n```\n\n</linear_chain>\n\n<independent_sources>\nWhen nodes return more than 1 item, chaining causes item multiplication: if Source A returns N items, a chained Source B runs N times instead of once.\n\n**When to use `executeOnce: true`:**\n- A node fetches data independently but is chained after another data source (prevents N\u00D7M multiplication)\n- A node should summarize/aggregate all upstream items in a single call (e.g., AI summary, send one notification)\n- A node calls an API that doesn't vary per input item\n\nFix with `executeOnce: true` (simplest) or parallel branches + Merge (when combining results):\n\n```javascript\n// sourceA outputs 10 items. sourceB outputs 10 items.\n// WRONG - processResults runs 100 times\n// startTrigger.to(sourceA.to(sourceB.to(processResults)))\n\n// FIX 1 - executeOnce: sourceB runs once regardless of input items\nconst sourceB = node({ ..., config: { ..., executeOnce: true } });\nstartTrigger.to(sourceA.to(sourceB.to(processResults)));\n\n// FIX 2 - parallel branches + Merge (combine by position)\nconst combineResults = merge({\n  version: 3.2,\n  config: { name: 'Combine Results', parameters: { mode: 'combine', combineBy: 'combineByPosition' } }\n});\nexport default workflow('id', 'name')\n  .add(startTrigger)\n  .to(sourceA.to(combineResults.input(0)))\n  .add(startTrigger)\n  .to(sourceB.to(combineResults.input(1)))\n  .add(combineResults)\n  .to(processResults);\n\n// FIX 3 - parallel branches + Merge (append)\nconst allResults = merge({\n  version: 3.2,\n  config: { name: 'All Results', parameters: { mode: 'append' } }\n});\nexport default workflow('id', 'name')\n  .add(startTrigger)\n  .to(sourceA.to(allResults.input(0)))\n  .add(startTrigger)\n  .to(sourceB.to(allResults.input(1)))\n  .add(allResults)\n  .to(processResults);\n```\n\n</independent_sources>\n\n<zero_item_safety>\nNodes that fetch or filter data may return 0 items, which stops the entire downstream chain.\nUse `alwaysOutputData: true` on data-fetching nodes to ensure the chain continues with an empty item `{json: {}}`.\n\n```javascript\n// Data Table might be empty (fresh table, no matching rows)\nconst getReflections = node({\n  type: 'n8n-nodes-base.dataTable',\n  version: 1.1,\n  config: {\n    name: 'Get Reflections',\n    alwaysOutputData: true,  // Chain continues even if table is empty\n    parameters: { resource: 'row', operation: 'get', returnAll: true }\n  }\n});\n\n// Downstream Code node handles the empty case\nconst processData = node({\n  type: 'n8n-nodes-base.code',\n  version: 2,\n  config: {\n    name: 'Process Data',\n    parameters: {\n      mode: 'runOnceForAllItems',\n      jsCode: \\`\nconst items = $input.all();\n// items will be [{json: {}}] if upstream had no data\nconst hasData = items.length > 0 && Object.keys(items[0].json).length > 0;\n// ... handle both cases\n\\`.trim()\n    }\n  }\n});\n```\n\n**When to use `alwaysOutputData: true`:**\n- Data Table with `operation: 'get'` (table may be empty or freshly created)\n- Any lookup/search/filter node whose result feeds into downstream processing\n- HTTP Request that may return an empty array\n\n**When NOT to use it:**\n- Trigger nodes (they always produce output)\n- Code nodes (handle empty input in your code logic instead)\n- Nodes at the end of the chain (no downstream to protect)\n\n</zero_item_safety>\n\n<conditional_branching>\n\n**CRITICAL:** Each branch defines a COMPLETE processing path. Chain multiple steps INSIDE the branch using .to().\n\n```javascript\n// Assume other nodes are declared\nconst checkValid = ifElse({ version: 2.2, config: { name: 'Check Valid', parameters: {...} } });\n\nexport default workflow('id', 'name')\n  .add(startTrigger)\n  .to(checkValid\n    .onTrue(formatData.to(enrichData.to(saveToDb)))  // Chain 3 nodes on true branch\n    .onFalse(logError));\n```\n\n</conditional_branching>\n\n<multi_way_routing>\n\n```javascript\n// Assume other nodes are declared\nconst routeByPriority = switchCase({ version: 3.2, config: { name: 'Route by Priority', parameters: {...} } });\n\nexport default workflow('id', 'name')\n  .add(startTrigger)\n  .to(routeByPriority\n    .onCase(0, processUrgent.to(notifyTeam.to(escalate)))  // Chain of 3 nodes\n    .onCase(1, processNormal)\n    .onCase(2, archive));\n```\n\n</multi_way_routing>\n\n<parallel_execution>\n```javascript\n// First declare the Merge node using merge()\nconst combineResults = merge({\n  version: 3.2,\n  config: { name: 'Combine Results', parameters: { mode: 'combine' } }\n});\n\n// Declare branch nodes\nconst branch1 = node({ type: 'n8n-nodes-base.httpRequest', ... });\nconst branch2 = node({ type: 'n8n-nodes-base.httpRequest', ... });\nconst processResults = node({ type: 'n8n-nodes-base.set', ... });\n\n// Connect branches to specific merge inputs using .input(n)\nexport default workflow('id', 'name')\n  .add(trigger({ ... }))\n  .to(branch1.to(combineResults.input(0)))  // Connect to input 0\n  .add(trigger({ ... }))\n  .to(branch2.to(combineResults.input(1)))  // Connect to input 1\n  .add(combineResults)\n  .to(processResults);  // Process merged results\n```\n\n</parallel_execution>\n\n<batch_processing>\n```javascript\nconst startTrigger = trigger({\n  type: 'n8n-nodes-base.manualTrigger',\n  version: 1,\n  config: { name: 'Start' }\n});\n\nconst fetchRecords = node({\n  type: 'n8n-nodes-base.httpRequest',\n  version: 4.3,\n  config: { name: 'Fetch Records', parameters: { method: 'GET', url: '...' } }\n});\n\nconst finalizeResults = node({\n  type: 'n8n-nodes-base.set',\n  version: 3.4,\n  config: { name: 'Finalize', parameters: {} }\n});\n\nconst processRecord = node({\n  type: 'n8n-nodes-base.httpRequest',\n  version: 4.3,\n  config: { name: 'Process Record', parameters: { method: 'POST', url: '...' } }\n});\n\nconst sibNode = splitInBatches({ version: 3, config: { name: 'Batch Process', parameters: { batchSize: 10 } } });\n\nexport default workflow('id', 'name')\n  .add(startTrigger)\n  .to(fetchRecords)\n  .to(sibNode\n    .onDone(finalizeResults)\n    .onEachBatch(processRecord.to(nextBatch(sibNode)))\n  );\n```\n\n</batch_processing>\n\n<multiple_triggers>\n```javascript\nconst webhookTrigger = trigger({\n  type: 'n8n-nodes-base.webhook',\n  version: 2.1,\n  config: { name: 'Webhook' }\n});\n\nconst processWebhook = node({\n  type: 'n8n-nodes-base.set',\n  version: 3.4,\n  config: { name: 'Process Webhook', parameters: {} }\n});\n\nconst scheduleTrigger = trigger({\n  type: 'n8n-nodes-base.scheduleTrigger',\n  version: 1.3,\n  config: { name: 'Daily Schedule', parameters: {} }\n});\n\nconst processSchedule = node({\n  type: 'n8n-nodes-base.set',\n  version: 3.4,\n  config: { name: 'Process Schedule', parameters: {} }\n});\n\nexport default workflow('id', 'name')\n  .add(webhookTrigger)\n  .to(processWebhook)\n  .add(scheduleTrigger)\n  .to(processSchedule);\n```\n\n</multiple_triggers>\n\n<fan_in>\n```javascript\n// Each trigger's execution runs in COMPLETE ISOLATION.\n// Different branches have no effect on each other.\n// Never duplicate chains for \"isolation\" - it's already guaranteed.\n\nconst webhookTrigger = trigger({\n  type: 'n8n-nodes-base.webhook',\n  version: 2.1,\n  config: { name: 'Webhook Trigger' }\n});\n\nconst scheduleTrigger = trigger({\n  type: 'n8n-nodes-base.scheduleTrigger',\n  version: 1.3,\n  config: { name: 'Daily Schedule' }\n});\n\nconst processData = node({\n  type: 'n8n-nodes-base.set',\n  version: 3.4,\n  config: { name: 'Process Data', parameters: {} }\n});\n\nconst sendNotification = node({\n  type: 'n8n-nodes-base.slack',\n  version: 2.3,\n  config: { name: 'Notify Slack', parameters: {} }\n});\n\nexport default workflow('id', 'name')\n  .add(webhookTrigger)\n  .to(processData)\n  .to(sendNotification)\n  .add(scheduleTrigger)\n  .to(processData);\n```\n\n</fan_in>\n\n<ai_agent_basic>\n```javascript\nconst openAiModel = languageModel({\n  type: '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n  version: 1.3,\n  config: { name: 'OpenAI Model', parameters: {} }\n});\n\nconst startTrigger = trigger({\n  type: 'n8n-nodes-base.manualTrigger',\n  version: 1,\n  config: { name: 'Start' }\n});\n\nconst aiAgent = node({\n  type: '@n8n/n8n-nodes-langchain.agent',\n  version: 3.1,\n  config: {\n    name: 'AI Assistant',\n    parameters: { promptType: 'define', text: 'You are a helpful assistant' },\n    subnodes: { model: openAiModel }\n  }\n});\n\nexport default workflow('ai-assistant', 'AI Assistant')\n  .add(startTrigger)\n  .to(aiAgent);\n```\n\n</ai_agent_basic>\n\n<ai_agent_with_tools>\n```javascript\nconst openAiModel = languageModel({\n  type: '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n  version: 1.3,\n  config: {\n    name: 'OpenAI Model',\n    parameters: {},\n    credentials: { openAiApi: newCredential('OpenAI') }\n  }\n});\n\nconst calculatorTool = tool({\n  type: '@n8n/n8n-nodes-langchain.toolCalculator',\n  version: 1,\n  config: { name: 'Calculator', parameters: {} }\n});\n\nconst startTrigger = trigger({\n  type: 'n8n-nodes-base.manualTrigger',\n  version: 1,\n  config: { name: 'Start' }\n});\n\nconst aiAgent = node({\n  type: '@n8n/n8n-nodes-langchain.agent',\n  version: 3.1,\n  config: {\n    name: 'Math Agent',\n    parameters: { promptType: 'define', text: 'You can use tools to help users' },\n    subnodes: { model: openAiModel, tools: [calculatorTool] }\n  }\n});\n\nexport default workflow('ai-calculator', 'AI Calculator')\n  .add(startTrigger)\n  .to(aiAgent);\n```\n\n</ai_agent_with_tools>\n\n<ai_agent_with_from_ai>\n```javascript\nconst openAiModel = languageModel({\n  type: '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n  version: 1.3,\n  config: {\n    name: 'OpenAI Model',\n    parameters: {},\n    credentials: { openAiApi: newCredential('OpenAI') }\n  }\n});\n\nconst gmailTool = tool({\n  type: 'n8n-nodes-base.gmailTool',\n  version: 1,\n  config: {\n    name: 'Gmail Tool',\n    parameters: {\n      sendTo: fromAi('recipient', 'Email address'),\n      subject: fromAi('subject', 'Email subject'),\n      message: fromAi('body', 'Email content')\n    },\n    credentials: { gmailOAuth2: newCredential('Gmail') }\n  }\n});\n\nconst startTrigger = trigger({\n  type: 'n8n-nodes-base.manualTrigger',\n  version: 1,\n  config: { name: 'Start' }\n});\n\nconst aiAgent = node({\n  type: '@n8n/n8n-nodes-langchain.agent',\n  version: 3.1,\n  config: {\n    name: 'Email Agent',\n    parameters: { promptType: 'define', text: 'You can send emails' },\n    subnodes: { model: openAiModel, tools: [gmailTool] }\n  }\n});\n\nexport default workflow('ai-email', 'AI Email Sender')\n  .add(startTrigger)\n  .to(aiAgent);\n```\n</ai_agent_with_from_ai>\n\n<ai_agent_with_structured_output>\n```javascript\nconst structuredParser = outputParser({\n  type: '@n8n/n8n-nodes-langchain.outputParserStructured',\n  version: 1.3,\n  config: {\n    name: 'Structured Output Parser',\n    parameters: {\n      schemaType: 'fromJson',\n      jsonSchemaExample: '{ \"sentiment\": \"positive\", \"confidence\": 0.95, \"summary\": \"brief summary\" }'\n    }\n  }\n});\n\nconst aiAgent = node({\n  type: '@n8n/n8n-nodes-langchain.agent',\n  version: 3.1,\n  config: {\n    name: 'Sentiment Analyzer',\n    parameters: { promptType: 'define', text: 'Analyze the sentiment of the input text', hasOutputParser: true },\n    subnodes: { model: openAiModel, outputParser: structuredParser }\n  }\n});\n\nexport default workflow('ai-sentiment', 'AI Sentiment Analyzer')\n  .add(startTrigger)\n  .to(aiAgent);\n```\n</ai_agent_with_structured_output>";