@n8n/instance-ai 1.23.2 → 1.24.0

package/dist/tools/orchestration/verification/prepare-run.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.prepareVerificationRun = prepareVerificationRun;
+const node_keyed_items_1 = require("../../../utils/node-keyed-items");
 const remediation_1 = require("../../../workflow-loop/remediation");
 function getInvalidFixtureOverrideNodeNames(buildOutcome, fixtureOverrides) {
     if (!fixtureOverrides)
@@ -11,7 +12,7 @@ function getInvalidFixtureOverrideNodeNames(buildOutcome, fixtureOverrides) {
     return Object.keys(fixtureOverrides).filter((nodeName) => !simulatedNodeNames.has(nodeName));
 }
 function buildVerificationPinData(buildOutcome, fixtureOverrides) {
-    const merged = { ...(buildOutcome.verificationPinData ?? {}) };
+    const merged = new Map(Object.entries(buildOutcome.verificationPinData ?? {}));
     const fixtures = buildOutcome.simulationFixtures ?? {};
     const simulatedNodes = [];
     const haltedGateNames = [];
@@ -21,28 +22,39 @@ function buildVerificationPinData(buildOutcome, fixtureOverrides) {
         simulatedNodes.push({ nodeName: verdict.nodeName, reason: verdict.reason });
         if (verdict.haltBranch) {
             haltedGateNames.push(verdict.nodeName);
-            merged[verdict.nodeName] = [];
+            merged.set(verdict.nodeName, []);
             continue;
         }
-        const items = fixtures[verdict.nodeName];
-        merged[verdict.nodeName] = items?.length ? items : [{}];
+        const items = (0, node_keyed_items_1.itemsForNode)(fixtures, verdict.nodeName);
+        merged.set(verdict.nodeName, items?.length ? items : [{}]);
     }
     if (fixtureOverrides) {
         for (const [nodeName, items] of Object.entries(fixtureOverrides)) {
             if (haltedGateNames.includes(nodeName))
                 continue;
-            merged[nodeName] = items;
+            merged.set(nodeName, items);
         }
     }
     const gateScript = (buildOutcome.waitGateScripts ?? []).find((script) => haltedGateNames.includes(script.nodeName));
     return {
-        verificationPinData: Object.keys(merged).length > 0 ? merged : undefined,
+        verificationPinData: merged.size > 0 ? Object.fromEntries(merged) : undefined,
         simulatedNodes,
         haltedGateNames,
         ...(gateScript ? { gateScript } : {}),
     };
 }
-function prepareVerificationRun(buildOutcome, fixtureOverrides) {
+function blocked(reason, guidance) {
+    const remediation = (0, remediation_1.createRemediation)({
+        category: 'blocked',
+        shouldEdit: false,
+        reason,
+        guidance,
+    });
+    return { kind: 'blocked', result: { success: false, error: guidance, remediation, guidance } };
+}
+function prepareVerificationRun(buildOutcome, input) {
+    const { fixtureOverrides } = input;
+    const allowedZeroItemNodes = new Set(input.allowZeroItemFixtures ?? []);
     const haltedOverrideNodeNames = Object.keys(fixtureOverrides ?? {}).filter((nodeName) => (buildOutcome.nodeSimulationPlan ?? []).some((verdict) => verdict.nodeName === nodeName && verdict.verdict === 'simulate' && verdict.haltBranch));
     if (haltedOverrideNodeNames.length > 0) {
         const guidance = `Node(s) ${haltedOverrideNodeNames.join(', ')} pause the workflow for a human decision and sit on a loop — ` +
@@ -50,42 +62,25 @@ function prepareVerificationRun(buildOutcome, fixtureOverrides) {
             'answer forever. Verification drives such gates with scripted decisions where possible, or halts at ' +
             'them otherwise. Treat the scripted/halted result as authoritative and tell the user the approval ' +
             'loop needs a manual end-to-end test for final confirmation.';
-        const remediation = (0, remediation_1.createRemediation)({
-            category: 'blocked',
-            shouldEdit: false,
-            reason: 'halted_wait_gate_override',
-            guidance,
-        });
-        return {
-            kind: 'blocked',
-            result: {
-                success: false,
-                error: guidance,
-                remediation,
-                guidance,
-            },
-        };
+        return blocked('halted_wait_gate_override', guidance);
     }
     const invalidFixtureOverrideNodeNames = getInvalidFixtureOverrideNodeNames(buildOutcome, fixtureOverrides);
     if (invalidFixtureOverrideNodeNames.length > 0) {
         const guidance = 'Fixture overrides can only target nodes already classified as simulated in the build outcome. ' +
             `Invalid override node(s): ${invalidFixtureOverrideNodeNames.join(', ')}. ` +
             'Do not run the workflow live; rebuild with declared output fixtures or override a simulated node.';
-        const remediation = (0, remediation_1.createRemediation)({
-            category: 'blocked',
-            shouldEdit: false,
-            reason: 'invalid_fixture_override',
-            guidance,
-        });
-        return {
-            kind: 'blocked',
-            result: {
-                success: false,
-                error: guidance,
-                remediation,
-                guidance,
-            },
-        };
+        return blocked('invalid_fixture_override', guidance);
+    }
+    const zeroItemOverrideNodeNames = Object.entries(fixtureOverrides ?? {})
+        .filter(([nodeName, items]) => items.length === 0 && !allowedZeroItemNodes.has(nodeName))
+        .map(([nodeName]) => nodeName);
+    if (zeroItemOverrideNodeNames.length > 0) {
+        const guidance = `Fixture override(s) for ${zeroItemOverrideNodeNames.join(', ')} pin zero items. ` +
+            'An empty item list stops every downstream node, so verification would pass without running ' +
+            'the branch you are checking. Give each node at least one plausible item instead. ' +
+            'If the empty result IS the case under test, repeat the call with the node listed in ' +
+            '`allowZeroItemFixtures` and report that the downstream branch stayed unverified.';
+        return blocked('zero_item_fixture_override', guidance);
     }
     return { kind: 'ready', prepared: buildVerificationPinData(buildOutcome, fixtureOverrides) };
 }

package/dist/tools/orchestration/verification/prepare-run.js.map

@@ -1 +1 @@
-{"version":3,"file":"prepare-run.js","sourceRoot":"","sources":["../../../../src/tools/orchestration/verification/prepare-run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prepare-run.js","sourceRoot":"","sources":["../../../../src/tools/orchestration/verification/prepare-run.ts"],"names":[],"mappings":"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"}

package/dist/tools/orchestration/verification/types.d.ts

@@ -9,6 +9,7 @@ export interface VerifyToolInput {
     includeData?: boolean;
     maxDataChars?: number;
     fixtureOverrides?: Record<string, Array<Record<string, unknown>>>;
+    allowZeroItemFixtures?: string[];
 }
 export interface ResolvedVerifyInput extends VerifyToolInput {
     workItemId: string;

package/dist/tools/orchestration/verify-built-workflow.tool.d.ts

@@ -9,6 +9,7 @@ export declare const verifyBuiltWorkflowInputSchema: z.ZodObject<{
     includeData: z.ZodOptional<z.ZodBoolean>;
     maxDataChars: z.ZodOptional<z.ZodNumber>;
     fixtureOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>>;
+    allowZeroItemFixtures: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     workItemId?: string | undefined;
     workflowId: string;
@@ -18,6 +19,7 @@ export declare const verifyBuiltWorkflowInputSchema: z.ZodObject<{
     includeData?: boolean | undefined;
     maxDataChars?: number | undefined;
     fixtureOverrides?: Record<string, Record<string, unknown>[]> | undefined;
+    allowZeroItemFixtures?: string[] | undefined;
 }, {
     workItemId?: string | undefined;
     workflowId: string;
@@ -27,5 +29,6 @@ export declare const verifyBuiltWorkflowInputSchema: z.ZodObject<{
     includeData?: boolean | undefined;
     maxDataChars?: number | undefined;
     fixtureOverrides?: Record<string, Record<string, unknown>[]> | undefined;
+    allowZeroItemFixtures?: string[] | undefined;
 }>;
 export declare function createVerifyBuiltWorkflowTool(context: OrchestrationContext): import("@n8n/agents").BuiltTool;

package/dist/tools/orchestration/verify-built-workflow.tool.js

@@ -60,7 +60,13 @@ exports.verifyBuiltWorkflowInputSchema = zod_1.z.object({
     fixtureOverrides: zod_1.z
         .record(zod_1.z.array(zod_1.z.record(zod_1.z.unknown())))
         .optional()
-        .describe('Optional per-run output fixtures keyed by node name. Only nodes already classified as simulated in the build outcome may be overridden. Use this for alternate deterministic scenarios, not raw trigger input.'),
+        .describe('Optional per-run output fixtures keyed by node name. Only nodes already classified as simulated in the build outcome may be overridden. Use this for alternate deterministic scenarios, not raw trigger input. ' +
+        'An empty array is rejected unless the node is also listed in `allowZeroItemFixtures`.'),
+    allowZeroItemFixtures: zod_1.z
+        .array(zod_1.z.string())
+        .optional()
+        .describe('Node names whose `fixtureOverrides` entry may be an empty array. Zero items stop every node below, so the run reports success while verifying nothing. ' +
+        'List a node here only when the empty branch is what you are verifying, and say so in your report.'),
 });
 const remediationOutputSchema = zod_1.z
     .object({
@@ -130,7 +136,7 @@ function createVerifyBuiltWorkflowTool(context) {
                 workflowId,
             });
         }
-        const preparedResult = (0, prepare_run_1.prepareVerificationRun)(buildOutcome, resolvedInput.fixtureOverrides);
+        const preparedResult = (0, prepare_run_1.prepareVerificationRun)(buildOutcome, resolvedInput);
         if (preparedResult.kind === 'blocked') {
             return {
                 ...preparedResult.result,

package/dist/tools/orchestration/verify-built-workflow.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"verify-built-workflow.tool.js","sourceRoot":"","sources":["../../../src/tools/orchestration/verify-built-workflow.tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"verify-built-workflow.tool.js","sourceRoot":"","sources":["../../../src/tools/orchestration/verify-built-workflow.tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/tool-ids.d.ts

@@ -14,6 +14,7 @@ export declare const DOMAIN_TOOL_IDS: {
     readonly PARSE_FILE: 'parse-file';
     readonly AGENTS: 'agents';
     readonly MCP_SERVERS: 'mcp-servers';
+    readonly CONVERSATION_HISTORY: 'conversation-history';
 };
 export declare const COMPILED_WORKFLOW_TRACE_RUN_NAME = "compiled-workflow";
 export declare const AGENT_SNAPSHOT_TRACE_RUN_NAME = "agent-snapshot";
@@ -27,6 +28,7 @@ export declare const ORCHESTRATION_TOOL_IDS: {
     readonly REPORT_VERIFICATION_VERDICT: 'report-verification-verdict';
     readonly APPLY_WORKFLOW_CREDENTIALS: 'apply-workflow-credentials';
     readonly BUILD_AGENT: 'build-agent';
+    readonly LIST_AGENT_CAPABILITIES: 'list-agent-capabilities';
     readonly GET_SESSION: 'get-session';
 };
 export declare const WORKSPACE_TOOL_IDS: {

package/dist/tools/tool-ids.js

@@ -18,6 +18,7 @@ exports.DOMAIN_TOOL_IDS = {
     PARSE_FILE: 'parse-file',
     AGENTS: 'agents',
     MCP_SERVERS: 'mcp-servers',
+    CONVERSATION_HISTORY: 'conversation-history',
 };
 exports.COMPILED_WORKFLOW_TRACE_RUN_NAME = 'compiled-workflow';
 exports.AGENT_SNAPSHOT_TRACE_RUN_NAME = 'agent-snapshot';
@@ -31,6 +32,7 @@ exports.ORCHESTRATION_TOOL_IDS = {
     REPORT_VERIFICATION_VERDICT: 'report-verification-verdict',
     APPLY_WORKFLOW_CREDENTIALS: 'apply-workflow-credentials',
     BUILD_AGENT: 'build-agent',
+    LIST_AGENT_CAPABILITIES: 'list-agent-capabilities',
     GET_SESSION: 'get-session',
 };
 exports.WORKSPACE_TOOL_IDS = {
@@ -56,9 +58,11 @@ exports.ALWAYS_LOADED_TOOL_NAMES = new Set([
     exports.DOMAIN_TOOL_IDS.N8N_DOCS,
     exports.DOMAIN_TOOL_IDS.AGENTS,
     exports.DOMAIN_TOOL_IDS.MCP_SERVERS,
+    exports.DOMAIN_TOOL_IDS.CONVERSATION_HISTORY,
     'web-search',
     'fetch-url',
     ...((0, agent_feature_enabled_1.isAgentFeatureEnabled)() ? [exports.ORCHESTRATION_TOOL_IDS.BUILD_AGENT] : []),
+    ...((0, agent_feature_enabled_1.isAgentFeatureEnabled)() ? [exports.ORCHESTRATION_TOOL_IDS.LIST_AGENT_CAPABILITIES] : []),
 ]);
 exports.CHECKPOINT_FOLLOW_UP_TOOL_NAMES = new Set([
     exports.ORCHESTRATION_TOOL_IDS.COMPLETE_CHECKPOINT,

package/dist/tools/tool-ids.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-ids.js","sourceRoot":"","sources":["../../src/tools/tool-ids.ts"],"names":[],"mappings":";;;AAAA,0EAAuE;AAE1D,QAAA,eAAe,GAAG;IAC9B,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,cAAc,EAAE,gBAAgB;IAChC,UAAU,EAAE,YAAY;IACxB,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,aAAa;CACjB,CAAC;AAME,QAAA,gCAAgC,GAAG,mBAAmB,CAAC;AAIvD,QAAA,6BAA6B,GAAG,gBAAgB,CAAC;AAEjD,QAAA,sBAAsB,GAAG;IACrC,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;IAC5B,qBAAqB,EAAE,uBAAuB;IAC9C,SAAS,EAAE,WAAW;IACtB,mBAAmB,EAAE,qBAAqB;IAC1C,qBAAqB,EAAE,uBAAuB;IAC9C,2BAA2B,EAAE,6BAA6B;IAC1D,0BAA0B,EAAE,4BAA4B;IACxD,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;CACjB,CAAC;AAEE,QAAA,kBAAkB,GAAG;IACjC,UAAU,EAAE,YAAY;CACf,CAAC;AAEE,QAAA,mBAAmB,GAAG,QAAA,eAAe,CAAC,WAAW,CAAC;AAClD,QAAA,mBAAmB,GAAG,QAAA,eAAe,CAAC,WAAW,CAAC;AAClD,QAAA,mBAAmB,GAAG,QAAA,eAAe,CAAC,WAAW,CAAC;AAClD,QAAA,gBAAgB,GAAG,QAAA,eAAe,CAAC,QAAQ,CAAC;AAC5C,QAAA,gBAAgB,GAAG,QAAA,eAAe,CAAC,QAAQ,CAAC;AAE5C,QAAA,wBAAwB,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,MAAM,CAAC,QAAA,sBAAsB,CAAC,CAAC,CAAC;AAElF,QAAA,wBAAwB,GAAG,IAAI,GAAG,CAAS;IACvD,QAAA,eAAe,CAAC,QAAQ;IACxB,QAAA,eAAe,CAAC,WAAW;IAC3B,QAAA,eAAe,CAAC,SAAS;IACzB,QAAA,eAAe,CAAC,UAAU;IAC1B,QAAA,eAAe,CAAC,WAAW;IAC3B,QAAA,eAAe,CAAC,UAAU;IAC1B,QAAA,eAAe,CAAC,cAAc;IAC9B,QAAA,eAAe,CAAC,KAAK;IACrB,QAAA,sBAAsB,CAAC,qBAAqB;IAC5C,QAAA,eAAe,CAAC,QAAQ;IAKxB,QAAA,eAAe,CAAC,QAAQ;IACxB,QAAA,eAAe,CAAC,MAAM;IAItB,QAAA,eAAe,CAAC,WAAW;IAC3B,YAAY;IACZ,WAAW;IAIX,GAAG,CAAC,IAAA,6CAAqB,GAAE,CAAC,CAAC,CAAC,CAAC,QAAA,sBAAsB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;CACxE,CAAC,CAAC;AAEU,QAAA,+BAA+B,GAAG,IAAI,GAAG,CAAS;IAC9D,QAAA,sBAAsB,CAAC,mBAAmB;IAC1C,QAAA,eAAe,CAAC,UAAU;CAC1B,CAAC,CAAC"}
+{"version":3,"file":"tool-ids.js","sourceRoot":"","sources":["../../src/tools/tool-ids.ts"],"names":[],"mappings":";;;AAAA,0EAAuE;AAE1D,QAAA,eAAe,GAAG;IAC9B,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,cAAc,EAAE,gBAAgB;IAChC,UAAU,EAAE,YAAY;IACxB,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,aAAa;IAC1B,oBAAoB,EAAE,sBAAsB;CACnC,CAAC;AAME,QAAA,gCAAgC,GAAG,mBAAmB,CAAC;AAIvD,QAAA,6BAA6B,GAAG,gBAAgB,CAAC;AAEjD,QAAA,sBAAsB,GAAG;IACrC,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;IAC5B,qBAAqB,EAAE,uBAAuB;IAC9C,SAAS,EAAE,WAAW;IACtB,mBAAmB,EAAE,qBAAqB;IAC1C,qBAAqB,EAAE,uBAAuB;IAC9C,2BAA2B,EAAE,6BAA6B;IAC1D,0BAA0B,EAAE,4BAA4B;IACxD,WAAW,EAAE,aAAa;IAC1B,uBAAuB,EAAE,yBAAyB;IAClD,WAAW,EAAE,aAAa;CACjB,CAAC;AAEE,QAAA,kBAAkB,GAAG;IACjC,UAAU,EAAE,YAAY;CACf,CAAC;AAEE,QAAA,mBAAmB,GAAG,QAAA,eAAe,CAAC,WAAW,CAAC;AAClD,QAAA,mBAAmB,GAAG,QAAA,eAAe,CAAC,WAAW,CAAC;AAClD,QAAA,mBAAmB,GAAG,QAAA,eAAe,CAAC,WAAW,CAAC;AAClD,QAAA,gBAAgB,GAAG,QAAA,eAAe,CAAC,QAAQ,CAAC;AAC5C,QAAA,gBAAgB,GAAG,QAAA,eAAe,CAAC,QAAQ,CAAC;AAE5C,QAAA,wBAAwB,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,MAAM,CAAC,QAAA,sBAAsB,CAAC,CAAC,CAAC;AAElF,QAAA,wBAAwB,GAAG,IAAI,GAAG,CAAS;IACvD,QAAA,eAAe,CAAC,QAAQ;IACxB,QAAA,eAAe,CAAC,WAAW;IAC3B,QAAA,eAAe,CAAC,SAAS;IACzB,QAAA,eAAe,CAAC,UAAU;IAC1B,QAAA,eAAe,CAAC,WAAW;IAC3B,QAAA,eAAe,CAAC,UAAU;IAC1B,QAAA,eAAe,CAAC,cAAc;IAC9B,QAAA,eAAe,CAAC,KAAK;IACrB,QAAA,sBAAsB,CAAC,qBAAqB;IAC5C,QAAA,eAAe,CAAC,QAAQ;IAKxB,QAAA,eAAe,CAAC,QAAQ;IACxB,QAAA,eAAe,CAAC,MAAM;IAItB,QAAA,eAAe,CAAC,WAAW;IAC3B,QAAA,eAAe,CAAC,oBAAoB;IACpC,YAAY;IACZ,WAAW;IAIX,GAAG,CAAC,IAAA,6CAAqB,GAAE,CAAC,CAAC,CAAC,CAAC,QAAA,sBAAsB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAMxE,GAAG,CAAC,IAAA,6CAAqB,GAAE,CAAC,CAAC,CAAC,CAAC,QAAA,sBAAsB,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;CACpF,CAAC,CAAC;AAEU,QAAA,+BAA+B,GAAG,IAAI,GAAG,CAAS;IAC9D,QAAA,sBAAsB,CAAC,mBAAmB;IAC1C,QAAA,eAAe,CAAC,UAAU;CAC1B,CAAC,CAAC"}

package/dist/tools/workflows/build-workflow.tool.d.ts

@@ -28,6 +28,38 @@ export declare const buildWorkflowInputSchema: z.ZodObject<{
     preferNewCredentials?: string[] | undefined;
     executionIntent?: "one-off" | "reusable" | undefined;
 }>;
+export declare const buildWorkflowInputSchemaWithFolderPlacement: z.ZodObject<{
+    filePath: z.ZodEffects<z.ZodString, string, string>;
+    sourceCode: z.ZodOptional<z.ZodString>;
+    workflowId: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    workItemId: z.ZodOptional<z.ZodString>;
+    isSupportingWorkflow: z.ZodOptional<z.ZodBoolean>;
+    preferNewCredentials: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    executionIntent: z.ZodOptional<z.ZodEnum<["one-off", "reusable"]>>;
+} & {
+    folderPath: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    filePath: string;
+    sourceCode?: string | undefined;
+    workflowId?: string | undefined;
+    name?: string | undefined;
+    workItemId?: string | undefined;
+    isSupportingWorkflow?: boolean | undefined;
+    preferNewCredentials?: string[] | undefined;
+    executionIntent?: "one-off" | "reusable" | undefined;
+    folderPath?: string | undefined;
+}, {
+    filePath: string;
+    sourceCode?: string | undefined;
+    workflowId?: string | undefined;
+    name?: string | undefined;
+    workItemId?: string | undefined;
+    isSupportingWorkflow?: boolean | undefined;
+    preferNewCredentials?: string[] | undefined;
+    executionIntent?: "one-off" | "reusable" | undefined;
+    folderPath?: string | undefined;
+}>;
 export declare function autoImportMissingSdkSymbols(source: string, errors: string[]): {
     source: string;
     symbols: string[];

package/dist/tools/workflows/build-workflow.tool.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildWorkflowInputSchema = void 0;
+exports.buildWorkflowInputSchemaWithFolderPlacement = exports.buildWorkflowInputSchema = void 0;
 exports.autoImportMissingSdkSymbols = autoImportMissingSdkSymbols;
 exports.createBuildWorkflowTool = createBuildWorkflowTool;
 const agents_1 = require("@n8n/agents");
@@ -17,6 +17,7 @@ const plan_verification_simulation_1 = require("./plan-verification-simulation")
 const preserve_node_positions_1 = require("./preserve-node-positions");
 const resolve_credentials_1 = require("./resolve-credentials");
 const resolved_credential_schema_1 = require("./resolved-credential.schema");
+const setup_items_1 = require("./setup-items");
 const setup_skip_state_1 = require("./setup-skip-state");
 const setup_workflow_service_1 = require("./setup-workflow.service");
 const workflow_build_context_1 = require("./workflow-build-context");
@@ -29,6 +30,7 @@ const workflow_json_utils_1 = require("./workflow-json-utils");
 const workflow_node_diff_1 = require("./workflow-node-diff");
 const workflow_source_compiler_1 = require("./workflow-source-compiler");
 const workflow_validation_warnings_1 = require("./workflow-validation-warnings");
+const folder_resolution_error_1 = require("../../errors/folder-resolution.error");
 const workflow_save_conflict_error_1 = require("../../errors/workflow-save-conflict.error");
 const runtime_skills_1 = require("../../skills/runtime-skills");
 const langsmith_tracing_1 = require("../../tracing/langsmith-tracing");
@@ -109,6 +111,34 @@ exports.buildWorkflowInputSchema = zod_1.z
         'anything the user may run again.'),
 })
     .strict();
+const FOLDER_PATH_PLACEMENT_DESCRIPTION = 'Folder to create the NEW workflow in, named the way the user named it — "Clients/Acme", "Acme". ' +
+    'Pass it whenever the workflow has a clear home: the user named a folder, or the related workflows you read live there. ' +
+    'Resolved strictly (exact path, then folder name, then path suffix), never fuzzy: an unresolved folder fails the build before anything is saved and lists the real folders, so retry with one of those or ask the user. ' +
+    'New workflows only — to move an existing workflow use `workspace(action="move-workflow-to-folder")`.';
+exports.buildWorkflowInputSchemaWithFolderPlacement = exports.buildWorkflowInputSchema
+    .extend({
+    folderPath: zod_1.z.string().optional().describe(FOLDER_PATH_PLACEMENT_DESCRIPTION),
+})
+    .strict();
+function pickBuildWorkflowInputSchema(context) {
+    return context.folderExplorationEnabled === true
+        ? exports.buildWorkflowInputSchemaWithFolderPlacement
+        : exports.buildWorkflowInputSchema;
+}
+function formatFolderPlacementFailure(failure) {
+    const candidates = failure.candidates.length > 0
+        ? ` Folders in this project: ${failure.candidates.map((path) => `"${path}"`).join(', ')}.`
+        : '';
+    const retry = ' Re-run `build-workflow` with one of those paths as `folderPath`, or ask the user which folder they mean. Do NOT guess a folder from workflow names, and do NOT drop `folderPath` to save at the project root unless the user agrees.';
+    switch (failure.reason) {
+        case 'ambiguous':
+            return `Folder "${failure.requested}" matches more than one folder, so the workflow was NOT created.${candidates}${retry}`;
+        case 'unsupported':
+            return `Folders are not available on this instance, so the workflow was NOT created in "${failure.requested}". Tell the user, and re-run without \`folderPath\` only if they agree to a root-level workflow.`;
+        default:
+            return `No folder matches "${failure.requested}", so the workflow was NOT created.${candidates}${retry}`;
+    }
+}
 const triggerNodeOutputSchema = zod_1.z.object({
     nodeName: zod_1.z.string(),
     nodeType: zod_1.z.string(),
@@ -255,6 +285,39 @@ async function handleValidationFailure(args) {
         warnings: (0, workflow_build_context_1.combineWarnings)(informational.map((w) => (0, workflow_build_context_1.formatWarning)(w.code, w.message))),
     };
 }
+const buildWorkflowOutputSchema = zod_1.z.object({
+    success: zod_1.z.boolean(),
+    filePath: zod_1.z.string(),
+    sourceHash: zod_1.z.string().optional(),
+    workflowId: zod_1.z.string().optional(),
+    workflowName: zod_1.z.string().optional(),
+    workItemId: zod_1.z.string().optional(),
+    triggerNodes: zod_1.z.array(triggerNodeOutputSchema).optional(),
+    verificationReadiness: verificationReadinessOutputSchema.optional(),
+    executionIntent: zod_1.z.enum(['one-off', 'reusable']).optional(),
+    setupRequirement: setupRequirementOutputSchema.optional(),
+    postBuildFlow: postBuildFlowOutputSchema.optional(),
+    isSupportingWorkflow: zod_1.z.boolean().optional(),
+    mockedNodeNames: zod_1.z.array(zod_1.z.string()).optional(),
+    mockedCredentialTypes: zod_1.z.array(zod_1.z.string()).optional(),
+    mockedCredentialsByNode: zod_1.z.record(zod_1.z.array(zod_1.z.string())).optional(),
+    resolvedCredentialsByNode: zod_1.z.record(zod_1.z.array(resolved_credential_schema_1.resolvedCredentialSchema)).optional(),
+    credentialResolutionNote: zod_1.z.string().optional(),
+    referencedWorkflowIds: zod_1.z.array(zod_1.z.string()).optional(),
+    hasUnresolvedPlaceholders: zod_1.z.boolean().optional(),
+    denied: zod_1.z.boolean().optional(),
+    reason: zod_1.z.string().optional(),
+    remediation: workflow_loop_state_1.remediationMetadataSchema.optional(),
+    errors: zod_1.z.array(zod_1.z.string()).optional(),
+    warnings: zod_1.z.array(zod_1.z.string()).optional(),
+});
+function pickBuildWorkflowOutputSchema(context) {
+    return context.folderExplorationEnabled === true
+        ? buildWorkflowOutputSchema.extend({
+            folder: zod_1.z.object({ id: zod_1.z.string(), name: zod_1.z.string(), path: zod_1.z.string() }).optional(),
+        })
+        : buildWorkflowOutputSchema;
+}
 function createBuildWorkflowTool(context) {
     const failureTracker = new build_failure_tracker_1.BuildFailureTracker();
     return new agents_1.Tool('build-workflow')
@@ -264,33 +327,8 @@ function createBuildWorkflowTool(context) {
         'Use TypeScript SDK .workflow.ts source for new and existing workflows. ' +
         'Prefer writing the file with `workspace_write_file` / `workspace_str_replace_file` so `workflow-sdk validate` can run on it, then call this tool with filePath. ' +
         'For a one-shot create/rewrite you may pass `sourceCode` instead (the tool writes filePath and builds).')
-        .input(exports.buildWorkflowInputSchema)
-        .output(zod_1.z.object({
-        success: zod_1.z.boolean(),
-        filePath: zod_1.z.string(),
-        sourceHash: zod_1.z.string().optional(),
-        workflowId: zod_1.z.string().optional(),
-        workflowName: zod_1.z.string().optional(),
-        workItemId: zod_1.z.string().optional(),
-        triggerNodes: zod_1.z.array(triggerNodeOutputSchema).optional(),
-        verificationReadiness: verificationReadinessOutputSchema.optional(),
-        executionIntent: zod_1.z.enum(['one-off', 'reusable']).optional(),
-        setupRequirement: setupRequirementOutputSchema.optional(),
-        postBuildFlow: postBuildFlowOutputSchema.optional(),
-        isSupportingWorkflow: zod_1.z.boolean().optional(),
-        mockedNodeNames: zod_1.z.array(zod_1.z.string()).optional(),
-        mockedCredentialTypes: zod_1.z.array(zod_1.z.string()).optional(),
-        mockedCredentialsByNode: zod_1.z.record(zod_1.z.array(zod_1.z.string())).optional(),
-        resolvedCredentialsByNode: zod_1.z.record(zod_1.z.array(resolved_credential_schema_1.resolvedCredentialSchema)).optional(),
-        credentialResolutionNote: zod_1.z.string().optional(),
-        referencedWorkflowIds: zod_1.z.array(zod_1.z.string()).optional(),
-        hasUnresolvedPlaceholders: zod_1.z.boolean().optional(),
-        denied: zod_1.z.boolean().optional(),
-        reason: zod_1.z.string().optional(),
-        remediation: workflow_loop_state_1.remediationMetadataSchema.optional(),
-        errors: zod_1.z.array(zod_1.z.string()).optional(),
-        warnings: zod_1.z.array(zod_1.z.string()).optional(),
-    }))
+        .input(pickBuildWorkflowInputSchema(context))
+        .output(pickBuildWorkflowOutputSchema(context))
         .suspend(confirmationSuspendSchema)
         .resume(confirmationResumeSchema)
         .handler(async (input, ctx) => {
@@ -364,6 +402,33 @@ function createBuildWorkflowTool(context) {
             }
         }
         const targetWorkflowId = binding.workflowId;
+        const folderPath = 'folderPath' in input && typeof input.folderPath === 'string'
+            ? input.folderPath
+            : undefined;
+        if (folderPath !== undefined && targetWorkflowId) {
+            const remediation = (0, remediation_1.createRemediation)({
+                category: 'blocked',
+                shouldEdit: false,
+                reason: 'folder_placement_on_update',
+                guidance: '`folderPath` only applies when creating a new workflow. Nothing was saved. Re-run without `folderPath` to update the workflow, and move it with `workspace(action="move-workflow-to-folder")` if the user asked for that.',
+            });
+            (0, workflow_build_telemetry_1.trackWorkflowSourceBuild)(context, {
+                result: 'blocked',
+                stage: 'folder',
+                binding,
+                targetWorkflowId,
+                isSupportingWorkflow: input.isSupportingWorkflow,
+                remediation,
+                errorCount: 1,
+            });
+            return {
+                success: false,
+                ...(0, workflow_build_context_1.sourceResponseBase)(binding),
+                workflowId: targetWorkflowId,
+                errors: [remediation.guidance],
+                remediation,
+            };
+        }
         const permKey = targetWorkflowId ? 'updateWorkflow' : 'createWorkflow';
         if (context.permissions?.[permKey] === 'blocked') {
             const remediation = (0, remediation_1.createRemediation)({
@@ -798,11 +863,27 @@ function createBuildWorkflowTool(context) {
                 (nodeName !== undefined && changedNodeNames.includes(nodeName));
             const hasPlaceholders = (json.nodes ?? []).some((n) => isInSetupScope(n.name) && (0, placeholder_1.hasPlaceholderDeep)(n.parameters));
             const createSuccessResponse = async (saved, operation) => {
-                const setupRequests = await (0, setup_workflow_service_1.analyzeWorkflow)(context, saved.id, undefined, {
+                const setupItemsEmitter = (0, setup_items_1.isSetupPanelEnabled)(context)
+                    ? context.setupItemsEmitter
+                    : undefined;
+                const analyzedRequests = await (0, setup_workflow_service_1.analyzeWorkflow)(context, saved.id, undefined, {
                     ...(input.preferNewCredentials
                         ? { preferNewCredentialTypes: input.preferNewCredentials }
                         : {}),
+                    ...(setupItemsEmitter ? { includeSettled: true } : {}),
                 });
+                const setupRequests = analyzedRequests.filter((request) => !!request.needsAction);
+                if (setupItemsEmitter) {
+                    try {
+                        setupItemsEmitter.emit(saved.id, (0, setup_items_1.buildSetupItemsFromSetupRequests)(saved.id, analyzedRequests));
+                    }
+                    catch (error) {
+                        context.logger.warn('Failed to emit setup-items snapshot for built workflow', {
+                            workflowId: saved.id,
+                            error: error instanceof Error ? error.message : String(error),
+                        });
+                    }
+                }
                 const { pending: pendingSetupRequests, skippedByUser: skippedSetupRequests } = (0, setup_skip_state_1.partitionSkippedSetupRequests)(setupRequests, saved.id, (0, setup_skip_state_1.getSkippedSetupSubjects)(context));
                 const needsSetupInScope = (request) => request.needsAction === true && isInSetupScope(request.node.name);
                 const workflowNeedsSetup = pendingSetupRequests.some(needsSetupInScope);
@@ -907,6 +988,7 @@ function createBuildWorkflowTool(context) {
                     workflowId: saved.id,
                     workflowName: json.name || undefined,
                     workItemId: resolvedWorkItemId,
+                    ...(saved.folder ? { folder: saved.folder } : {}),
                     isSupportingWorkflow: isSupportingWorkflow || undefined,
                     triggerNodes,
                     verificationReadiness: outcome.verificationReadiness,
@@ -942,12 +1024,41 @@ function createBuildWorkflowTool(context) {
             }
             const created = await context.workflowService.createFromWorkflowJSON(json, {
                 markAsAiTemporary: true,
+                ...(folderPath !== undefined ? { folderPath } : {}),
             });
             await (0, workflow_build_context_1.recordSessionOwnedWorkflow)(context, created.id);
             return await createSuccessResponse(created, 'create');
         }
         catch (error) {
             const message = error instanceof Error ? error.message : 'Unknown error';
+            if (error instanceof folder_resolution_error_1.FolderResolutionError) {
+                const failureText = formatFolderPlacementFailure(error.folderResolution);
+                const remediation = (0, remediation_1.createRemediation)({
+                    category: 'blocked',
+                    shouldEdit: false,
+                    reason: `folder_${error.folderResolution.reason.replace(/-/g, '_')}`,
+                    guidance: failureText,
+                });
+                (0, workflow_build_telemetry_1.trackWorkflowSourceBuild)(context, {
+                    result: 'failure',
+                    stage: 'folder',
+                    binding,
+                    targetWorkflowId,
+                    saveOperation: 'create',
+                    isSupportingWorkflow,
+                    isAuxiliarySupportingWorkflow,
+                    remediation,
+                    errorCount: 1,
+                });
+                return {
+                    success: false,
+                    ...(0, workflow_build_context_1.sourceResponseBase)(binding),
+                    workflowName: json.name || undefined,
+                    workItemId: resolvedWorkItemId,
+                    errors: [failureText],
+                    remediation,
+                };
+            }
             if (error instanceof workflow_save_conflict_error_1.WorkflowSaveConflictError) {
                 const remediation = (0, workflow_build_remediation_1.createWorkflowModifiedExternallyRemediation)();
                 binding = await (0, workflow_build_context_1.markSourceBuildFailed)(context, binding, sourceHash);