n8n 2.28.3 → 2.29.0

package/dist/modules/agents/builder/interactive/ask-credential.tool.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildAskCredentialTool = buildAskCredentialTool;
+exports.buildAskEmbeddingCredentialTool = buildAskEmbeddingCredentialTool;
 const tool_1 = require("@n8n/agents/tool");
 const api_types_1 = require("@n8n/api-types");
 function withNodeCredentialMap(input, resume) {
@@ -18,6 +19,22 @@ function withNodeCredentialMap(input, resume) {
         },
     };
 }
+async function resolveCredentialSelection(input, ctx, deps, mapResume) {
+    if (ctx.resumeData !== undefined)
+        return mapResume(ctx.resumeData);
+    if (deps.isCredentialTypeKnown && !deps.isCredentialTypeKnown(input.credentialType)) {
+        throw new Error(`Unknown credential type "${input.credentialType}". Use an exact n8n credential type name.`);
+    }
+    const all = await deps.credentialProvider.list();
+    const matching = all.filter((c) => c.type === input.credentialType);
+    if (matching.length === 1) {
+        return mapResume({
+            credentialId: matching[0].id,
+            credentialName: matching[0].name,
+        });
+    }
+    return await ctx.suspend(input);
+}
 function buildAskCredentialTool(deps) {
     return (new tool_1.Tool(api_types_1.ASK_CREDENTIAL_TOOL_NAME)
         .description('Show a credential picker card in the chat UI and suspend until the user selects ' +
@@ -30,21 +47,28 @@ function buildAskCredentialTool(deps) {
         .suspend(api_types_1.askCredentialInputSchema)
         .resume(api_types_1.askCredentialResumeSchema)
         .handler(async (input, ctx) => {
-        if (ctx.resumeData !== undefined)
-            return withNodeCredentialMap(input, ctx.resumeData);
-        if (deps.isCredentialTypeKnown && !deps.isCredentialTypeKnown(input.credentialType)) {
-            throw new Error(`Unknown credential type "${input.credentialType}". Use an exact n8n credential type name.`);
-        }
-        const all = await deps.credentialProvider.list();
-        const matching = all.filter((c) => c.type === input.credentialType);
-        if (matching.length === 1) {
+        return await resolveCredentialSelection(input, ctx, deps, (resume) => withNodeCredentialMap(input, resume));
+    })
+        .build());
+}
+function buildAskEmbeddingCredentialTool(deps) {
+    return new tool_1.Tool(api_types_1.ASK_EMBEDDING_CREDENTIAL_TOOL_NAME)
+        .description('Resolve the OpenAI embedding credential for Episodic Memory. Tries to resolve n8n managed credential. Otherwise behaves ' +
+        'like ask_credential: show a credential picker card in the chat UI and suspend until ' +
+        'the user selects a credential. Returns { credentialId, credentialName, credentials } ' +
+        'on success or { skipped: true } if the user skips credential setup.')
+        .input(api_types_1.askCredentialInputSchema)
+        .suspend(api_types_1.askCredentialInputSchema)
+        .resume(api_types_1.askCredentialResumeSchema)
+        .handler(async (input, ctx) => {
+        if (deps.isAssistantProxyEnabled()) {
             return withNodeCredentialMap(input, {
-                credentialId: matching[0].id,
-                credentialName: matching[0].name,
+                credentialId: api_types_1.MANAGED_CREDENTIAL_TOKEN,
+                credentialName: 'Managed by n8n',
             });
         }
-        return await ctx.suspend(input);
+        return await resolveCredentialSelection(input, ctx, deps, (resume) => withNodeCredentialMap(input, resume));
     })
-        .build());
+        .build();
 }
 //# sourceMappingURL=ask-credential.tool.js.map

package/dist/modules/agents/builder/interactive/ask-credential.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"ask-credential.tool.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/interactive/ask-credential.tool.ts"],"names":[],"mappings":";;AA0CA,wDA2CC;AArFD,2CAAwC;AAExC,8CAMwB;AAexB,SAAS,qBAAqB,CAC7B,KAAyB,EACzB,MAA2B;IAE3B,IAAI,SAAS,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAEvC,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,cAAc,CAAC;IACpE,OAAO;QACN,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,WAAW,EAAE;YACZ,CAAC,cAAc,CAAC,EAAE;gBACjB,EAAE,EAAE,MAAM,CAAC,YAAY;gBACvB,IAAI,EAAE,MAAM,CAAC,cAAc;aAC3B;SACD;KACD,CAAC;AACH,CAAC;AAED,SAAgB,sBAAsB,CAAC,IAA2B;IACjE,OAAO,CACN,IAAI,WAAI,CAAC,oCAAwB,CAAC;SAChC,WAAW,CACX,kFAAkF;QACjF,sFAAsF;QACtF,kGAAkG;QAClG,mFAAmF;QACnF,6HAA6H;QAC7H,kFAAkF,CACnF;SACA,KAAK,CAAC,oCAAwB,CAAC;SAG/B,OAAO,CAAC,oCAAwB,CAAC;SACjC,MAAM,CAAC,qCAAyB,CAAC;SACjC,OAAO,CACP,KAAK,EACJ,KAAyB,EACzB,GAAsE,EACrE,EAAE;QACH,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS;YAAE,OAAO,qBAAqB,CAAC,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;QACtF,IAAI,IAAI,CAAC,qBAAqB,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;YACrF,MAAM,IAAI,KAAK,CACd,4BAA4B,KAAK,CAAC,cAAc,2CAA2C,CAC3F,CAAC;QACH,CAAC;QAID,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC;QACjD,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,cAAc,CAAC,CAAC;QACpE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,qBAAqB,CAAC,KAAK,EAAE;gBACnC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;gBAC5B,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;aAChC,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC,CACD;SACA,KAAK,EAAE,CACT,CAAC;AACH,CAAC"}
+{"version":3,"file":"ask-credential.tool.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/interactive/ask-credential.tool.ts"],"names":[],"mappings":"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"}

package/dist/modules/agents/builder/interactive/ask-llm.tool.js

@@ -6,9 +6,7 @@ const api_types_1 = require("@n8n/api-types");
 function buildAskLlmTool() {
     return new tool_1.Tool(api_types_1.ASK_LLM_TOOL_NAME)
         .description('Show a model + credential picker card in the chat UI and suspend until the user ' +
-        'selects a provider, model and credential. Use only when resolve_llm returns an ' +
-        'ambiguous result, when credentials are missing and the user must choose/configure one, ' +
-        'or when the user explicitly asks to pick/change the model. ' +
+        'selects a provider, model and credential. ' +
         'After resume: set model = "{provider}/{model}" and credential = credentialId ' +
         'via write_config or patch_config.')
         .systemInstruction('Never ask the user in plain text to choose, confirm, configure, or change the agent ' +

package/dist/modules/agents/builder/interactive/ask-llm.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"ask-llm.tool.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/interactive/ask-llm.tool.ts"],"names":[],"mappings":";;AAUA,0CAyBC;AAnCD,2CAAwC;AAExC,8CAMwB;AAExB,SAAgB,eAAe;IAC9B,OAAO,IAAI,WAAI,CAAC,6BAAiB,CAAC;SAChC,WAAW,CACX,kFAAkF;QACjF,iFAAiF;QACjF,yFAAyF;QACzF,6DAA6D;QAC7D,+EAA+E;QAC/E,mCAAmC,CACpC;SACA,iBAAiB,CACjB,sFAAsF;QACrF,oFAAoF;QACpF,mDAAmD,CACpD;SACA,KAAK,CAAC,6BAAiB,CAAC;SACxB,OAAO,CAAC,6BAAiB,CAAC;SAC1B,MAAM,CAAC,8BAAkB,CAAC;SAC1B,OAAO,CACP,KAAK,EAAE,KAAkB,EAAE,GAAwD,EAAE,EAAE;QACtF,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC,UAAU,CAAC;QACxD,OAAO,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC,CACD;SACA,KAAK,EAAE,CAAC;AACX,CAAC"}
+{"version":3,"file":"ask-llm.tool.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/interactive/ask-llm.tool.ts"],"names":[],"mappings":";;AAUA,0CAuBC;AAhCD,2CAAwC;AACxC,8CAMwB;AAExB,SAAgB,eAAe;IAC9B,OAAO,IAAI,WAAI,CAAC,6BAAiB,CAAC;SAChC,WAAW,CACX,kFAAkF;QACjF,4CAA4C;QAC5C,+EAA+E;QAC/E,mCAAmC,CACpC;SACA,iBAAiB,CACjB,sFAAsF;QACrF,oFAAoF;QACpF,mDAAmD,CACpD;SACA,KAAK,CAAC,6BAAiB,CAAC;SACxB,OAAO,CAAC,6BAAiB,CAAC;SAC1B,MAAM,CAAC,8BAAkB,CAAC;SAC1B,OAAO,CACP,KAAK,EAAE,KAAkB,EAAE,GAAwD,EAAE,EAAE;QACtF,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC,UAAU,CAAC;QACxD,OAAO,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC,CACD;SACA,KAAK,EAAE,CAAC;AACX,CAAC"}

package/dist/modules/agents/builder/interactive/ask-question.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"ask-question.tool.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/interactive/ask-question.tool.ts"],"names":[],"mappings":";;AAUA,oDA+BC;AAzCD,2CAAwC;AAExC,8CAMwB;AAExB,SAAgB,oBAAoB;IACnC,OAAO,IAAI,WAAI,CAAC,kCAAsB,CAAC;SACrC,WAAW,CACX,mFAAmF;QAClF,mFAAmF;QACnF,mFAAmF;QACnF,qFAAqF;QACrF,mFAAmF;QACnF,8CAA8C,CAC/C;SACA,KAAK,CAAC,kCAAsB,CAAC;SAC7B,OAAO,CAAC,kCAAsB,CAAC;SAC/B,MAAM,CAAC,mCAAuB,CAAC;SAC/B,OAAO,CACP,KAAK,EACJ,KAAuB,EACvB,GAAkE,EACjE,EAAE;QACH,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC,UAAU,CAAC;QAMxD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;YAChE,OAAO,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7C,CAAC;QACD,OAAO,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC,CACD;SACA,KAAK,EAAE,CAAC;AACX,CAAC"}
+{"version":3,"file":"ask-question.tool.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/interactive/ask-question.tool.ts"],"names":[],"mappings":";;AAUA,oDA+BC;AAxCD,2CAAwC;AACxC,8CAMwB;AAExB,SAAgB,oBAAoB;IACnC,OAAO,IAAI,WAAI,CAAC,kCAAsB,CAAC;SACrC,WAAW,CACX,mFAAmF;QAClF,mFAAmF;QACnF,mFAAmF;QACnF,qFAAqF;QACrF,mFAAmF;QACnF,8CAA8C,CAC/C;SACA,KAAK,CAAC,kCAAsB,CAAC;SAC7B,OAAO,CAAC,kCAAsB,CAAC;SAC/B,MAAM,CAAC,mCAAuB,CAAC;SAC/B,OAAO,CACP,KAAK,EACJ,KAAuB,EACvB,GAAkE,EACjE,EAAE;QACH,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC,UAAU,CAAC;QAMxD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;YAChE,OAAO,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7C,CAAC;QACD,OAAO,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC,CACD;SACA,KAAK,EAAE,CAAC;AACX,CAAC"}

package/dist/modules/agents/builder/interactive/index.d.ts

@@ -1,4 +1,4 @@
-export { buildAskCredentialTool } from './ask-credential.tool';
+export { buildAskCredentialTool, buildAskEmbeddingCredentialTool } from './ask-credential.tool';
 export { buildAskLlmTool } from './ask-llm.tool';
 export { buildAskQuestionTool } from './ask-question.tool';
 export { buildResolveLlmTool } from './resolve-llm.tool';

package/dist/modules/agents/builder/interactive/index.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildResolveLlmTool = exports.buildAskQuestionTool = exports.buildAskLlmTool = exports.buildAskCredentialTool = void 0;
+exports.buildResolveLlmTool = exports.buildAskQuestionTool = exports.buildAskLlmTool = exports.buildAskEmbeddingCredentialTool = exports.buildAskCredentialTool = void 0;
 var ask_credential_tool_1 = require("./ask-credential.tool");
 Object.defineProperty(exports, "buildAskCredentialTool", { enumerable: true, get: function () { return ask_credential_tool_1.buildAskCredentialTool; } });
+Object.defineProperty(exports, "buildAskEmbeddingCredentialTool", { enumerable: true, get: function () { return ask_credential_tool_1.buildAskEmbeddingCredentialTool; } });
 var ask_llm_tool_1 = require("./ask-llm.tool");
 Object.defineProperty(exports, "buildAskLlmTool", { enumerable: true, get: function () { return ask_llm_tool_1.buildAskLlmTool; } });
 var ask_question_tool_1 = require("./ask-question.tool");

package/dist/modules/agents/builder/interactive/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/interactive/index.ts"],"names":[],"mappings":";;;AAAA,6DAA+D;AAAtD,6HAAA,sBAAsB,OAAA;AAC/B,+CAAiD;AAAxC,+GAAA,eAAe,OAAA;AACxB,yDAA2D;AAAlD,yHAAA,oBAAoB,OAAA;AAC7B,uDAAyD;AAAhD,uHAAA,mBAAmB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/interactive/index.ts"],"names":[],"mappings":";;;AAAA,6DAAgG;AAAvF,6HAAA,sBAAsB,OAAA;AAAE,sIAAA,+BAA+B,OAAA;AAChE,+CAAiD;AAAxC,+GAAA,eAAe,OAAA;AACxB,yDAA2D;AAAlD,yHAAA,oBAAoB,OAAA;AAC7B,uDAAyD;AAAhD,uHAAA,mBAAmB,OAAA"}

package/dist/modules/agents/builder/interactive/llm-provider-defaults.js

@@ -14,7 +14,7 @@ exports.LLM_PROVIDER_DEFAULTS = {
     },
     openAiApi: {
         provider: 'openai',
-        defaultModel: 'gpt-5',
+        defaultModel: 'gpt-5-mini',
         modelLookup: {
             kind: 'listSearch',
             nodeType: '@n8n/n8n-nodes-langchain.lmChatOpenAi',

package/dist/modules/agents/builder/interactive/llm-provider-defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"llm-provider-defaults.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/interactive/llm-provider-defaults.ts"],"names":[],"mappings":";;;AAsCa,QAAA,qBAAqB,GAAuC;IACxE,YAAY,EAAE;QACb,QAAQ,EAAE,WAAW;QACrB,YAAY,EAAE,mBAAmB;QACjC,WAAW,EAAE;YACZ,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,0CAA0C;YACpD,OAAO,EAAE,GAAG;YACZ,UAAU,EAAE,cAAc;SAC1B;KACD;IACD,SAAS,EAAE;QACV,QAAQ,EAAE,QAAQ;QAClB,YAAY,EAAE,OAAO;QACrB,WAAW,EAAE;YACZ,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,uCAAuC;YACjD,OAAO,EAAE,GAAG;YACZ,UAAU,EAAE,cAAc;SAC1B;KACD;IACD,aAAa,EAAE;QACd,QAAQ,EAAE,QAAQ;QAClB,YAAY,EAAE,gBAAgB;QAC9B,WAAW,EAAE;YACZ,IAAI,EAAE,oBAAoB;YAC1B,QAAQ,EAAE,6CAA6C;YACvD,OAAO,EAAE,GAAG;YACZ,YAAY,EAAE,WAAW;SACzB;KACD;IACD,MAAM,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE;IACnD,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,yBAAyB,EAAE;IACtE,eAAe,EAAE;QAChB,QAAQ,EAAE,SAAS;QACnB,YAAY,EAAE,sBAAsB;QACpC,WAAW,EAAE;YACZ,IAAI,EAAE,oBAAoB;YAC1B,QAAQ,EAAE,6CAA6C;YACvD,OAAO,EAAE,CAAC;YACV,YAAY,EAAE,OAAO;SACrB;KACD;IACD,WAAW,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE;IACpE,SAAS,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE;IACjE,aAAa,EAAE;QACd,QAAQ,EAAE,YAAY;QACtB,YAAY,EAAE,6BAA6B;QAC3C,WAAW,EAAE;YACZ,IAAI,EAAE,oBAAoB;YAC1B,QAAQ,EAAE,2CAA2C;YACrD,OAAO,EAAE,CAAC;YACV,YAAY,EAAE,OAAO;SACrB;KACD;IACD,SAAS,EAAE;QACV,QAAQ,EAAE,QAAQ;QAClB,YAAY,EAAE,wCAAwC;QACtD,WAAW,EAAE;YACZ,IAAI,EAAE,oBAAoB;YAC1B,QAAQ,EAAE,uCAAuC;YACjD,OAAO,EAAE,CAAC;YACV,YAAY,EAAE,OAAO;SACrB;KACD;CACD,CAAC"}
+{"version":3,"file":"llm-provider-defaults.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/interactive/llm-provider-defaults.ts"],"names":[],"mappings":";;;AAsCa,QAAA,qBAAqB,GAAuC;IACxE,YAAY,EAAE;QACb,QAAQ,EAAE,WAAW;QACrB,YAAY,EAAE,mBAAmB;QACjC,WAAW,EAAE;YACZ,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,0CAA0C;YACpD,OAAO,EAAE,GAAG;YACZ,UAAU,EAAE,cAAc;SAC1B;KACD;IACD,SAAS,EAAE;QACV,QAAQ,EAAE,QAAQ;QAClB,YAAY,EAAE,YAAY;QAC1B,WAAW,EAAE;YACZ,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,uCAAuC;YACjD,OAAO,EAAE,GAAG;YACZ,UAAU,EAAE,cAAc;SAC1B;KACD;IACD,aAAa,EAAE;QACd,QAAQ,EAAE,QAAQ;QAClB,YAAY,EAAE,gBAAgB;QAC9B,WAAW,EAAE;YACZ,IAAI,EAAE,oBAAoB;YAC1B,QAAQ,EAAE,6CAA6C;YACvD,OAAO,EAAE,GAAG;YACZ,YAAY,EAAE,WAAW;SACzB;KACD;IACD,MAAM,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE;IACnD,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,yBAAyB,EAAE;IACtE,eAAe,EAAE;QAChB,QAAQ,EAAE,SAAS;QACnB,YAAY,EAAE,sBAAsB;QACpC,WAAW,EAAE;YACZ,IAAI,EAAE,oBAAoB;YAC1B,QAAQ,EAAE,6CAA6C;YACvD,OAAO,EAAE,CAAC;YACV,YAAY,EAAE,OAAO;SACrB;KACD;IACD,WAAW,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE;IACpE,SAAS,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE;IACjE,aAAa,EAAE;QACd,QAAQ,EAAE,YAAY;QACtB,YAAY,EAAE,6BAA6B;QAC3C,WAAW,EAAE;YACZ,IAAI,EAAE,oBAAoB;YAC1B,QAAQ,EAAE,2CAA2C;YACrD,OAAO,EAAE,CAAC;YACV,YAAY,EAAE,OAAO;SACrB;KACD;IACD,SAAS,EAAE;QACV,QAAQ,EAAE,QAAQ;QAClB,YAAY,EAAE,wCAAwC;QACtD,WAAW,EAAE;YACZ,IAAI,EAAE,oBAAoB;YAC1B,QAAQ,EAAE,uCAAuC;YACjD,OAAO,EAAE,CAAC;YACV,YAAY,EAAE,OAAO;SACrB;KACD;CACD,CAAC"}

package/dist/modules/agents/builder/interactive/resolve-llm.tool.js

@@ -55,8 +55,9 @@ async function resolveModelAgainstLookup(credential, defaults, requestedModel, m
 }
 function buildResolveLlmTool(deps) {
     return new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.RESOLVE_LLM)
-        .description('Resolve the agent main LLM without showing a picker. Use this when the user ' +
-        'explicitly requests a provider/model, or when a fresh agent needs its main LLM set. ' +
+        .description('Resolve the agent main LLM without showing a picker. ' +
+        'Only call this when the user explicitly names a provider or model — do NOT call it ' +
+        'at the start of a conversation or proactively for fresh agents. ' +
         'If provider is given, resolves only that provider; if model is omitted, uses the ' +
         'provider default model. For "Anthropic via OpenRouter", pass provider="openrouter" ' +
         'and omit model unless the user named a concrete OpenRouter model id. Returns ok=false ' +

package/dist/modules/agents/builder/interactive/resolve-llm.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-llm.tool.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/interactive/resolve-llm.tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resolve-llm.tool.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/interactive/resolve-llm.tool.ts"],"names":[],"mappings":"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"}

package/dist/modules/agents/builder/prompts/config-mutation.prompt.js

@@ -31,7 +31,7 @@ ${(0, config_rules_prompt_1.getSchemaReferenceSection)()}
 - Follow the Config schema reference exactly; do not invent top-level fields.
 - Keep each feature in the schema path where it belongs.
 - Preserve unrelated existing config unless the user asked to change it.
-- Never write placeholder instructions or descriptions.
+- Never write placeholder instructions, tool descriptions, or skill descriptions.
 - Never copy credential IDs from \`list_credentials\`; use \`resolve_llm\`, \`ask_llm\`, or \`ask_credential\`.
 - Valid provider tool keys are complete provider tool IDs documented in the Tool Guidance section.
 - \`providerTools\` keys must be complete provider tool IDs from the valid key list.
@@ -40,15 +40,13 @@ ${(0, config_rules_prompt_1.getSchemaReferenceSection)()}
 
 #### Create Or Replace A Fresh Runnable Agent
 
-- Requires \`name\`, \`description\`, \`model\`, \`credential\`, and \`instructions\`.
-- \`description\` must be a brief, specific summary of what the agent does.
+- Requires \`name\`, \`model\`, \`credential\`, and \`instructions\`.
 - Keep \`tools\` and \`skills\` arrays if present.
 
 Good minimal shape:
 \`\`\`json
 {
   "name": "Support assistant",
-  "description": "Answers support questions and helps triage customer issues.",
   "model": "openrouter/openai/gpt-5.5",
   "credential": "<main-llm-credential-id>",
   "instructions": "Help the user with support questions.",
@@ -128,7 +126,7 @@ Bad: replacing \`config\` while dropping unrelated settings
 - \`patch_config\` cannot create a config when none exists; use \`write_config\` first.
 - \`/array/-\` appends to an array; \`/array/0\` inserts before the current first item.
 - Model-only changes must preserve existing Brave or SearXNG \`config.webSearch\`.
-- Empty, placeholder, or guessed \`instructions\` or \`description\` values are rejected; ask for details instead.
+- Empty, placeholder, or guessed \`instructions\` values are rejected; ask for details instead.
 
 ### Verify
 

package/dist/modules/agents/builder/prompts/config-mutation.prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-mutation.prompt.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/prompts/config-mutation.prompt.ts"],"names":[],"mappings":";;AAEA,0DA+IC;AAjJD,+DAAyF;AAEzF,SAAgB,uBAAuB;IACtC,OAAO;;;;;;;;;;;;;;;;;;;;;EAqBN,IAAA,2CAAqB,GAAE;;EAEvB,IAAA,+CAAyB,GAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EAsH+C,CAAC;AAC7E,CAAC"}
+{"version":3,"file":"config-mutation.prompt.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/prompts/config-mutation.prompt.ts"],"names":[],"mappings":";;AAEA,0DA6IC;AA/ID,+DAAyF;AAEzF,SAAgB,uBAAuB;IACtC,OAAO;;;;;;;;;;;;;;;;;;;;;EAqBN,IAAA,2CAAqB,GAAE;;EAEvB,IAAA,+CAAyB,GAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EAoH+C,CAAC;AAC7E,CAAC"}

package/dist/modules/agents/builder/prompts/config-rules.prompt.js

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getConfigRulesSection = getConfigRulesSection;
 exports.getSchemaReferenceSection = getSchemaReferenceSection;
+const api_types_1 = require("@n8n/api-types");
 const zod_1 = require("zod");
 const zod_to_json_schema_1 = require("zod-to-json-schema");
-const api_types_1 = require("@n8n/api-types");
 const schema_text_serializer_1 = require("../../json-config/schema-text-serializer");
 const BuilderPromptMemoryWorkerModelSchema = zod_1.z.object({
     model: api_types_1.AgentModelSchema,
@@ -48,14 +48,12 @@ function getConfigRulesSection() {
 
 - \`model\` must be "provider/model-name".
 - \`credential\` must be the id returned by \`resolve_llm\` or \`ask_llm\`.
-- Fresh agents must include a brief \`description\` explaining what the agent
-  does. Keep it specific and user-facing; never write placeholder copy.
 - Fresh agents must include
   \`memory: { "enabled": true, "storage": "n8n" }\`
   unless the user explicitly asks to disable memory.
 - \`memory.storage\` must be "n8n".
-- \`memory.episodicMemory\` requires \`ask_credential\` with
-  \`credentialType: "openAiApi"\`.
+- \`memory.episodicMemory\` requires \`ask_embedding_credential\` with
+  \`credentialType: "openAiApi"\`; use its returned \`credentialId\` value.
 - Memory worker model fields use \`{ "model": "provider/model-name", "credential": "<credentialId>" }\`;
   use only credential IDs returned by \`resolve_llm\`, \`ask_llm\`, or \`ask_credential\`.
 - Sub-agent configuration lives at top level under \`subAgents\`. Load
@@ -71,7 +69,7 @@ function getConfigRulesSection() {
 - Preserve existing Brave/SearXNG \`config.webSearch\` on model switches unless
   the user explicitly asks to change web-search method.
 - \`config.maxIterations\` caps the number of agent loop iterations per run. Do not set or change this unless the user explicitly asks.
-- Fresh agents need a real model, credential, description, and instructions
+- Fresh agents need a real model, credential, and instructions
   before config is written.`;
 }
 function getSchemaReferenceSection() {

package/dist/modules/agents/builder/prompts/config-rules.prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-rules.prompt.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/prompts/config-rules.prompt.ts"],"names":[],"mappings":";;AAgDA,sDA+BC;AAED,8DASC;AAxFD,6BAAwB;AACxB,2DAAqD;AAErD,8CAAiF;AAEjF,qFAAmF;AAEnF,MAAM,oCAAoC,GAAG,OAAC,CAAC,MAAM,CAAC;IACrD,KAAK,EAAE,4BAAgB;IACvB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACpC,CAAC,CAAC;AAEH,MAAM,+BAA+B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACzB,mBAAmB,EAAE,OAAC;SACpB,MAAM,CAAC;QACP,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC/B,aAAa,EAAE,oCAAoC,CAAC,QAAQ,EAAE;QAC9D,cAAc,EAAE,oCAAoC,CAAC,QAAQ,EAAE;QAC/D,uBAAuB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC3D,wBAAwB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC5D,iBAAiB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QACrD,uBAAuB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC3D,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;KAC7C,CAAC;SACD,QAAQ,EAAE;IACZ,cAAc,EAAE,OAAC;SACf,kBAAkB,CAAC,SAAS,EAAE;QAC9B,OAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,OAAC,CAAC,MAAM,CAAC;YACR,OAAO,EAAE,OAAC,CAAC,OAAO,CAAC,IAAI,CAAC;YACxB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7B,cAAc,EAAE,oCAAoC,CAAC,QAAQ,EAAE;YAC/D,cAAc,EAAE,oCAAoC,CAAC,QAAQ,EAAE;YAC/D,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;YACjD,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;SAC5D,CAAC;KACF,CAAC;SACD,QAAQ,EAAE;CACZ,CAAC,CAAC;AAEH,MAAM,kCAAkC,GAAG,yCAA6B,CAAC,MAAM,CAAC;IAC/E,MAAM,EAAE,+BAA+B,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC;AAEH,SAAgB,qBAAqB;IACpC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA6BoB,CAAC;AAC7B,CAAC;AAED,SAAgB,yBAAyB;IACxC,MAAM,SAAS,GAA2B,kCAAkC,CAAC;IAC7E,MAAM,cAAc,GAAG,IAAA,gDAAuB,EAAC,IAAA,oCAAe,EAAC,SAAS,CAAgB,CAAC,CAAC;IAC1F,OAAO;;;;EAIN,cAAc;OACT,CAAC;AACR,CAAC"}
+{"version":3,"file":"config-rules.prompt.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/prompts/config-rules.prompt.ts"],"names":[],"mappings":";;AA+CA,sDA6BC;AAED,8DASC;AAvFD,8CAAiF;AAGjF,6BAAwB;AACxB,2DAAqD;AAErD,qFAAmF;AAEnF,MAAM,oCAAoC,GAAG,OAAC,CAAC,MAAM,CAAC;IACrD,KAAK,EAAE,4BAAgB;IACvB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACpC,CAAC,CAAC;AAEH,MAAM,+BAA+B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACzB,mBAAmB,EAAE,OAAC;SACpB,MAAM,CAAC;QACP,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC/B,aAAa,EAAE,oCAAoC,CAAC,QAAQ,EAAE;QAC9D,cAAc,EAAE,oCAAoC,CAAC,QAAQ,EAAE;QAC/D,uBAAuB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC3D,wBAAwB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC5D,iBAAiB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QACrD,uBAAuB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC3D,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;KAC7C,CAAC;SACD,QAAQ,EAAE;IACZ,cAAc,EAAE,OAAC;SACf,kBAAkB,CAAC,SAAS,EAAE;QAC9B,OAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,OAAC,CAAC,MAAM,CAAC;YACR,OAAO,EAAE,OAAC,CAAC,OAAO,CAAC,IAAI,CAAC;YACxB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7B,cAAc,EAAE,oCAAoC,CAAC,QAAQ,EAAE;YAC/D,cAAc,EAAE,oCAAoC,CAAC,QAAQ,EAAE;YAC/D,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;YACjD,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;SAC5D,CAAC;KACF,CAAC;SACD,QAAQ,EAAE;CACZ,CAAC,CAAC;AAEH,MAAM,kCAAkC,GAAG,yCAA6B,CAAC,MAAM,CAAC;IAC/E,MAAM,EAAE,+BAA+B,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC;AAEH,SAAgB,qBAAqB;IACpC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA2BoB,CAAC;AAC7B,CAAC;AAED,SAAgB,yBAAyB;IACxC,MAAM,SAAS,GAA2B,kCAAkC,CAAC;IAC7E,MAAM,cAAc,GAAG,IAAA,gDAAuB,EAAC,IAAA,oCAAe,EAAC,SAAS,CAAgB,CAAC,CAAC;IAC1F,OAAO;;;;EAIN,cAAc;OACT,CAAC;AACR,CAAC"}

package/dist/modules/agents/builder/prompts/llm-selection.prompt.js

@@ -14,7 +14,7 @@ Use this to resolve the target agent's main \`model\` and \`credential\`.
 
 ### Workflow
 
-1. Use \`resolve_llm\` before \`ask_llm\` when the request contains enough provider/model detail.
+1. Use \`resolve_llm\` when the request contains enough provider/model detail, otherwise call \`ask_llm\`.
 2. If \`resolve_llm\` succeeds, persist \`model = "{provider}/{model}"\` and \`credential = credentialId\`.
 3. If the user asks to pick, change, confirm, or configure a model or main credential, call \`ask_llm\`; do not ask in prose.
 4. If \`resolve_llm\` reports missing or ambiguous credentials/provider, call \`ask_llm\`.

package/dist/modules/agents/builder/prompts/memory.prompt.d.ts

@@ -1 +1 @@
-export declare const MEMORY_PROMPT = "## Memory Guidance\n\n### Purpose\n\nUse this to configure the target agent's memory behavior.\n\n### Workflow\n\nFresh agents must include this default memory config unless the user explicitly asks to disable or change memory:\n```json\n{\n  \"enabled\": true,\n  \"storage\": \"n8n\",\n  \"observationalMemory\": {\n    \"enabled\": true\n  }\n}\n```\n\nThis is the configurable agent's session memory. The runtime-managed\n`observationalMemory` settings tune that memory behavior; they are not a\nseparate user-facing memory product.\n\n### Rules\n\n- When creating a new agent, always write the exact default `memory` object above.\n- Set `storage` to \"n8n\".\n- Set `observationalMemory.enabled` to `true` for new agents unless the user explicitly asks to disable observational memory.\n- Keep the rest of `observationalMemory` optional; add tuning fields only for explicit tuning or disabling.\n- Supported observational memory tuning fields: `enabled`, `observerModel`, `reflectorModel`, `observerThresholdTokens`, `reflectorThresholdTokens`, `renderTokenBudget`, `observationLogTailLimit`, and `lockTtlMs`.\n- Memory worker model fields must use object shape: `{ \"model\": \"provider/model-name\", \"credential\": \"<credentialId>\" }`.\n- Only set `observerModel`, `reflectorModel`, `extractorModel`, or `episodicMemory.reflectorModel` when the user explicitly asks to use a specific model for memory work.\n- Use only credential IDs returned by `resolve_llm`, `ask_llm`, or `ask_credential` for memory worker model fields. Do not invent IDs or copy a main-model credential unless one of those tools returned it for that worker model provider.\n\n### Episodic Memory\n\n- Enable `memory.episodicMemory` only when the user asks for Episodic Memory, long-term memory, prior conversations, remembered decisions, exact artifacts, or cross-session memory.\n- Before enabling it, call `ask_credential({ credentialType: \"openAiApi\", purpose: \"OpenAI credential for Episodic Memory embeddings\" })`.\n- On success, set `memory.episodicMemory = { \"enabled\": true, \"credential\": \"<credentialId>\" }` and preserve existing `topK` or `maxEntriesPerRun`.\n- `memory.episodicMemory.credential` is only for OpenAI embeddings. It is separate from optional `extractorModel` and `reflectorModel` worker credentials.\n- If credential selection is skipped, do not enable Episodic Memory; explain that it needs an OpenAI credential for embeddings.\n- Do not add instructions saying the agent should remember, store, save, or decide what context matters. The runtime handles memory extraction and indexing.\n- If instructions mention Episodic Memory, phrase it as retrieval/use only, e.g. \"Use recalled prior context when relevant to the user's request.\"\n- Do not invent Episodic Memory credential IDs or reuse the main model credential unless `ask_credential` returned it for this purpose.\n\n### Gotchas\n\n- Session memory and Episodic Memory are different features; do not use one as a substitute for the other.\n- Observational memory is runtime-managed session memory behavior; do not add target-agent instructions telling it how to save observations.\n- A skipped Episodic Memory credential means Episodic Memory stays disabled.\n\n### Verify\n\n- Fresh runnable agents have enabled n8n memory unless explicitly disabled.\n- Fresh runnable agents set `observationalMemory.enabled` to `true` unless explicitly disabled.\n- Episodic Memory has an OpenAI credential returned by `ask_credential`.\n- Existing memory tuning is preserved unless the user asked to change it.";
+export declare const MEMORY_PROMPT = "## Memory Guidance\n\n### Purpose\n\nUse this to configure the target agent's memory behavior.\n\n### Workflow\n\nFresh agents must include this default memory config unless the user explicitly asks to disable or change memory:\n```json\n{\n  \"enabled\": true,\n  \"storage\": \"n8n\",\n  \"observationalMemory\": {\n    \"enabled\": true\n  }\n}\n```\n\nThis is the configurable agent's session memory. The runtime-managed\n`observationalMemory` settings tune that memory behavior; they are not a\nseparate user-facing memory product.\n\n### Rules\n\n- When creating a new agent, always write the exact default `memory` object above.\n- Set `storage` to \"n8n\".\n- Set `observationalMemory.enabled` to `true` for new agents unless the user explicitly asks to disable observational memory.\n- Keep the rest of `observationalMemory` optional; add tuning fields only for explicit tuning or disabling.\n- Supported observational memory tuning fields: `enabled`, `observerModel`, `reflectorModel`, `observerThresholdTokens`, `reflectorThresholdTokens`, `renderTokenBudget`, `observationLogTailLimit`, and `lockTtlMs`.\n- Memory worker model fields must use object shape: `{ \"model\": \"provider/model-name\", \"credential\": \"<credentialId>\" }`.\n- Only set `observerModel`, `reflectorModel`, `extractorModel`, or `episodicMemory.reflectorModel` when the user explicitly asks to use a specific model for memory work.\n- Use only credential IDs returned by `resolve_llm`, `ask_llm`, or `ask_credential` for memory worker model fields. Do not invent IDs or copy a main-model credential unless one of those tools returned it for that worker model provider.\n\n### Episodic Memory\n\n- Enable `memory.episodicMemory` only when the user asks for Episodic Memory, long-term memory, prior conversations, remembered decisions, exact artifacts, or cross-session memory.\n- Before enabling it, call `ask_embedding_credential({ credentialType: \"openAiApi\", purpose: \"OpenAI credential for Episodic Memory embeddings\" })`.\n- On success, set `memory.episodicMemory = { \"enabled\": true, \"credential\": \"<credentialId>\" }`, using the returned `credentialId` value. This can be a real credential id or `\"managed\"` when the assistant proxy is available. Preserve existing `topK` or `maxEntriesPerRun`.\n- `memory.episodicMemory.credential` is only for OpenAI embeddings. It is separate from optional `extractorModel` and `reflectorModel` worker credentials.\n- If credential selection is skipped, do not enable Episodic Memory; explain that it needs an OpenAI credential for embeddings.\n- Do not add instructions saying the agent should remember, store, save, or decide what context matters. The runtime handles memory extraction and indexing.\n- If instructions mention Episodic Memory, phrase it as retrieval/use only, e.g. \"Use recalled prior context when relevant to the user's request.\"\n- Do not invent Episodic Memory credential IDs or reuse the main model credential unless `ask_embedding_credential` returned it for this purpose.\n\n### Gotchas\n\n- Session memory and Episodic Memory are different features; do not use one as a substitute for the other.\n- Observational memory is runtime-managed session memory behavior; do not add target-agent instructions telling it how to save observations.\n- A skipped Episodic Memory credential means Episodic Memory stays disabled.\n\n### Verify\n\n- Fresh runnable agents have enabled n8n memory unless explicitly disabled.\n- Fresh runnable agents set `observationalMemory.enabled` to `true` unless explicitly disabled.\n- Episodic Memory has an OpenAI credential or `\"managed\"` returned by `ask_embedding_credential`.\n- Existing memory tuning is preserved unless the user asked to change it.";

package/dist/modules/agents/builder/prompts/memory.prompt.js

@@ -39,13 +39,13 @@ separate user-facing memory product.
 ### Episodic Memory
 
 - Enable \`memory.episodicMemory\` only when the user asks for Episodic Memory, long-term memory, prior conversations, remembered decisions, exact artifacts, or cross-session memory.
-- Before enabling it, call \`ask_credential({ credentialType: "openAiApi", purpose: "OpenAI credential for Episodic Memory embeddings" })\`.
-- On success, set \`memory.episodicMemory = { "enabled": true, "credential": "<credentialId>" }\` and preserve existing \`topK\` or \`maxEntriesPerRun\`.
+- Before enabling it, call \`ask_embedding_credential({ credentialType: "openAiApi", purpose: "OpenAI credential for Episodic Memory embeddings" })\`.
+- On success, set \`memory.episodicMemory = { "enabled": true, "credential": "<credentialId>" }\`, using the returned \`credentialId\` value. This can be a real credential id or \`"managed"\` when the assistant proxy is available. Preserve existing \`topK\` or \`maxEntriesPerRun\`.
 - \`memory.episodicMemory.credential\` is only for OpenAI embeddings. It is separate from optional \`extractorModel\` and \`reflectorModel\` worker credentials.
 - If credential selection is skipped, do not enable Episodic Memory; explain that it needs an OpenAI credential for embeddings.
 - Do not add instructions saying the agent should remember, store, save, or decide what context matters. The runtime handles memory extraction and indexing.
 - If instructions mention Episodic Memory, phrase it as retrieval/use only, e.g. "Use recalled prior context when relevant to the user's request."
-- Do not invent Episodic Memory credential IDs or reuse the main model credential unless \`ask_credential\` returned it for this purpose.
+- Do not invent Episodic Memory credential IDs or reuse the main model credential unless \`ask_embedding_credential\` returned it for this purpose.
 
 ### Gotchas
 
@@ -57,6 +57,6 @@ separate user-facing memory product.
 
 - Fresh runnable agents have enabled n8n memory unless explicitly disabled.
 - Fresh runnable agents set \`observationalMemory.enabled\` to \`true\` unless explicitly disabled.
-- Episodic Memory has an OpenAI credential returned by \`ask_credential\`.
+- Episodic Memory has an OpenAI credential or \`"managed"\` returned by \`ask_embedding_credential\`.
 - Existing memory tuning is preserved unless the user asked to change it.`;
 //# sourceMappingURL=memory.prompt.js.map

package/dist/modules/agents/builder/prompts/tools.prompt.d.ts

@@ -1 +1 @@
-export declare const TOOLS_PROMPT = "## Tool Guidance\n\n### Purpose\n\nUse this to give the target agent callable capabilities through workflows,\nnodes, custom code tools, or provider tools.\n\n### Workflow\n\nUse this guidance before calling `search_nodes`, `get_node_types`, `build_custom_tool`,\nor adding, changing, or removing entries in `tools[]` / `providerTools`.\n\nCustom tools are for pure computation, validation, formatting, or planning logic;\nthey cannot perform live network, filesystem, process, timer, or host I/O.\n\nIf a product also has a target-agent integration, use node/workflow tools when\nthe product is only an API capability and the conversation or trigger happens\nelsewhere. Use the integration only when that product is the chat/trigger\nsurface or the agent needs the current platform conversation context. For\nexample, use Linear node tools for ordinary issue search/create/update when\nthe agent is triggered from Slack, schedule, Preview, or a workflow; use the\nLinear integration only when people will talk to the agent from Linear\nissues/comments.\n\n#### Workflow Tools\n\n- Call `list_workflows`; reference supported workflows by name with `{ \"type\": \"workflow\", \"workflow\": \"<name>\" }`.\n\n#### Node Tools\n\n- Use `search_nodes`, then `get_node_types`; never guess node type names.\n- Use the tool node id from discovery, usually ending in `Tool`.\n- Put fixed values in `nodeParameters`; use complete n8n expressions for values the agent should decide at runtime:\n  `={{ $fromAI('url', 'The URL to inspect', 'string') }}`.\n- For stable dynamic selectors such as Linear team/teamId, Slack channel, calendar,\n  project, board, database, table, model, or other \"Name or ID\" fields, load skill\n  `agent-builder-resource-locators` and follow it. Do not use `$fromAI` for\n  these fields; resolve them at build time and write the exact returned\n  `parameterValue` into `nodeParameters`.\n- Never write literal `\"$fromAI\"` or bare `$fromAI`; the node will treat it as the actual value.\n- Do not pipe AI-chosen fields through `$json`.\n- Do not include `inputSchema` or `toolDescription` for node tools.\n- For each required credential slot, call `ask_credential` once before config mutation. Pass the node's credential key as `credentialSlot`. On success, copy the returned `credentials` object directly to `node.credentials`. If skipped, still add the tool and omit only that credential slot.\n\n#### Custom Tools\n\n- Use `build_custom_tool` with `export default new Tool(...)` and imports only from `@n8n/agents` and `zod`.\n- Do not use custom tools for live website crawling, HTTP fetching, API calls, SEO crawlers, or scraping. Use workflow or node tools for those.\n- Register the returned custom tool id in config after `build_custom_tool`.\n- Custom handlers are pure functions: take validated `input`, compute, and return a JSON-serializable value. Do not call `.build()`.\n- Follow this pattern:\n```typescript\nimport { Tool } from '@n8n/agents';\nimport { z } from 'zod';\n\nexport default new Tool('tool_name')\n  .description('What the tool does')\n  .input(z.object({ query: z.string() }))\n  .handler(async ({ query }, ctx) => {\n    return { result: query.toUpperCase() };\n  });\n```\n- Custom handlers run in a V8 isolate. No network, filesystem, process, Buffer, fetch, timers, wall-clock waiting, or host I/O.\n- Some globals may exist as stubs: `setTimeout` fires synchronously, `console.log` goes nowhere, and `TextEncoder.encode` returns its input unchanged.\n- Safe globals include `Math`, `Date`, `JSON`, `RegExp`, `Array`, `Object`, `Map`, `Set`, `Promise`, typed arrays, and methods on provided values.\n- The handler receives `(input, ctx)`; `ctx.suspend(payload)` pauses for human-in-the-loop flows. Ignore `ctx` otherwise.\n- Execution is capped at 5 seconds and about 32 MB memory. If runtime fails, fix the code from the returned error and call `build_custom_tool` again.\n\n#### Provider Tools\n\n- Match provider tools to the configured model provider.\n- Anthropic: `providerTools[\"anthropic.web_search\"]`.\n- OpenAI: `providerTools[\"openai.web_search\"]` or `providerTools[\"openai.image_generation\"]`, only for compatible OpenAI models.\n\n### Gotchas\n\n- Web-search fallback services are config, not node tools, unless the user explicitly asks for a node integration.\n- Live crawling, fetching, and API integrations need workflow or node tools, not custom tools.\n- Do not include `inputSchema` or `toolDescription` for node tools.\n- `$fromAI(...)` placeholders define the node tool input schema; do not add it manually.\n- `get_resource_locator_options` response values are builder-time config values. Write\n  `parameterValue` exactly as returned. For resource locators this is an object with\n  `__rl`, `mode`, and `value`; for classic dynamic options it is the raw ID/value.\n- If `get_resource_locator_options` returns `missing_credentials`, call `ask_credential`\n  for one of the returned credential slots and retry. Do not fall back to `$fromAI`\n  for required stable resource IDs.\n- Do not invent node type names, workflow names, credential ids, or provider tool keys.\n- If a required node-tool credential is skipped, add the tool and omit only that credential slot.\n- `build_custom_tool` stores code only; the config still needs a `{ \"type\": \"custom\", \"id\": \"<returned id>\" }` tool ref.\n\n### Verify\n\n- Workflow tools reference discovered workflow names.\n- Node tools use discovered tool node ids and valid node parameters.\n- Custom tools return a stored custom tool id that is registered in config.\n- Provider tool keys match the configured model provider and the valid key list.";
+export declare const TOOLS_PROMPT = "## Tool Guidance\n\n### Purpose\n\nUse this to give the target agent callable capabilities through workflows,\nnodes, custom code tools, or provider tools.\n\n### Workflow\n\nUse this guidance before calling `search_nodes`, `get_node_types`, `build_custom_tool`,\nor adding, changing, or removing entries in `tools[]` / `providerTools`.\n\nCustom tools are for pure computation, validation, formatting, or planning logic;\nthey cannot perform live network, filesystem, process, timer, or host I/O.\n\nIf a product also has a target-agent integration, use node/workflow tools when\nthe product is only an API capability and the conversation or trigger happens\nelsewhere. Use the integration only when that product is the chat/trigger\nsurface or the agent needs the current platform conversation context. For\nexample, use Linear node tools for ordinary issue search/create/update when\nthe agent is triggered from Slack, schedule, Preview, or a workflow; use the\nLinear integration only when people will talk to the agent from Linear\nissues/comments.\n\n#### Workflow Tools\n\n- Call `list_workflows`; reference supported workflows by name with `{ \"type\": \"workflow\", \"workflow\": \"<name>\" }`.\n\n#### Node Tools\n\n- Use `search_nodes`, then `get_node_types`; never guess node type names.\n- Use the tool node id from discovery, usually ending in `Tool`.\n- Put fixed values in `nodeParameters`; use complete n8n expressions for values the agent should decide at runtime:\n  `={{ $fromAI('url', 'The URL to inspect', 'string') }}`.\n- For stable dynamic selectors such as Linear team/teamId, Slack channel, calendar,\n  project, board, database, table, model, or other \"Name or ID\" fields, load skill\n  `agent-builder-resource-locators` and follow it. Do not use `$fromAI` for\n  these fields; resolve them at build time and write the exact returned\n  `parameterValue` into `nodeParameters`.\n- Never write literal `\"$fromAI\"` or bare `$fromAI`; the node will treat it as the actual value.\n- Do not pipe AI-chosen fields through `$json`.\n- Do not include `inputSchema` or `toolDescription` for node tools.\n- For each required credential slot, call `ask_credential` once before config mutation. Pass the node's credential key as `credentialSlot`. On success, copy the returned `credentials` object directly to `node.credentials`. If skipped, still add the tool and omit only that credential slot.\n\n#### Custom Tools\n\n- Use `build_custom_tool` with `export default new Tool(...)` and imports only from `@n8n/agents` and `zod`.\n- Do not use custom tools for live website crawling, HTTP fetching, API calls, SEO crawlers, or scraping. Use workflow or node tools for those.\n- The returned `id` is the tool name from the code (e.g. `new Tool(\"my_tool\")` \u2192 id `\"my_tool\"`).\n- Register the returned id in config: `{ \"type\": \"custom\", \"id\": \"<tool name>\" }`.\n- Tool names must be unique per agent and use only letters, digits, and underscores.\n- To update an existing custom tool (fix a bug, change logic, or rename it): call `build_custom_tool` again with the revised code, then update the config.\n- If the tool name changed since the last build: register the new id AND remove the old `{ type: \"custom\", id: \"<old name>\" }` entry from config.\n- Custom handlers are pure functions: take validated `input`, compute, and return a JSON-serializable value. Do not call `.build()`.\n- Follow this pattern:\n```typescript\nimport { Tool } from '@n8n/agents';\nimport { z } from 'zod';\n\nexport default new Tool('tool_name')\n  .description('What the tool does')\n  .input(z.object({ query: z.string() }))\n  .handler(async ({ query }, ctx) => {\n    return { result: query.toUpperCase() };\n  });\n```\n- Custom handlers run in a V8 isolate. No network, filesystem, process, Buffer, fetch, timers, wall-clock waiting, or host I/O.\n- Some globals may exist as stubs: `setTimeout` fires synchronously, `console.log` goes nowhere, and `TextEncoder.encode` returns its input unchanged.\n- Safe globals include `Math`, `Date`, `JSON`, `RegExp`, `Array`, `Object`, `Map`, `Set`, `Promise`, typed arrays, and methods on provided values.\n- The handler receives `(input, ctx)`; `ctx.suspend(payload)` pauses for human-in-the-loop flows. Ignore `ctx` otherwise.\n- Execution is capped at 5 seconds and about 32 MB memory. If runtime fails, fix the code from the returned error and call `build_custom_tool` again.\n\n#### Provider Tools\n\n- Match provider tools to the configured model provider.\n- Anthropic: `providerTools[\"anthropic.web_search\"]`.\n- OpenAI: `providerTools[\"openai.web_search\"]` or `providerTools[\"openai.image_generation\"]`, only for compatible OpenAI models.\n\n### Gotchas\n\n- Web-search fallback services are config, not node tools, unless the user explicitly asks for a node integration.\n- Live crawling, fetching, and API integrations need workflow or node tools, not custom tools.\n- Do not include `inputSchema` or `toolDescription` for node tools.\n- `$fromAI(...)` placeholders define the node tool input schema; do not add it manually.\n- `get_resource_locator_options` response values are builder-time config values. Write\n  `parameterValue` exactly as returned. For resource locators this is an object with\n  `__rl`, `mode`, and `value`; for classic dynamic options it is the raw ID/value.\n- If `get_resource_locator_options` returns `missing_credentials`, call `ask_credential`\n  for one of the returned credential slots and retry. Do not fall back to `$fromAI`\n  for required stable resource IDs.\n- Do not invent node type names, workflow names, credential ids, or provider tool keys.\n- If a required node-tool credential is skipped, add the tool and omit only that credential slot.\n- `build_custom_tool` stores code only; the config still needs a `{ \"type\": \"custom\", \"id\": \"<tool name>\" }` tool ref.\n- When a tool is renamed, update the config to use the new name and remove the old entry.\n\n### Verify\n\n- Workflow tools reference discovered workflow names.\n- Node tools use discovered tool node ids and valid node parameters.\n- Custom tools: returned id equals the tool name; it is registered in config as `{ type: \"custom\", id: \"<tool name>\" }`.\n- Provider tool keys match the configured model provider and the valid key list.";

package/dist/modules/agents/builder/prompts/tools.prompt.js

@@ -50,7 +50,11 @@ issues/comments.
 
 - Use \`build_custom_tool\` with \`export default new Tool(...)\` and imports only from \`@n8n/agents\` and \`zod\`.
 - Do not use custom tools for live website crawling, HTTP fetching, API calls, SEO crawlers, or scraping. Use workflow or node tools for those.
-- Register the returned custom tool id in config after \`build_custom_tool\`.
+- The returned \`id\` is the tool name from the code (e.g. \`new Tool("my_tool")\` → id \`"my_tool"\`).
+- Register the returned id in config: \`{ "type": "custom", "id": "<tool name>" }\`.
+- Tool names must be unique per agent and use only letters, digits, and underscores.
+- To update an existing custom tool (fix a bug, change logic, or rename it): call \`build_custom_tool\` again with the revised code, then update the config.
+- If the tool name changed since the last build: register the new id AND remove the old \`{ type: "custom", id: "<old name>" }\` entry from config.
 - Custom handlers are pure functions: take validated \`input\`, compute, and return a JSON-serializable value. Do not call \`.build()\`.
 - Follow this pattern:
 \`\`\`typescript
@@ -90,12 +94,13 @@ export default new Tool('tool_name')
   for required stable resource IDs.
 - Do not invent node type names, workflow names, credential ids, or provider tool keys.
 - If a required node-tool credential is skipped, add the tool and omit only that credential slot.
-- \`build_custom_tool\` stores code only; the config still needs a \`{ "type": "custom", "id": "<returned id>" }\` tool ref.
+- \`build_custom_tool\` stores code only; the config still needs a \`{ "type": "custom", "id": "<tool name>" }\` tool ref.
+- When a tool is renamed, update the config to use the new name and remove the old entry.
 
 ### Verify
 
 - Workflow tools reference discovered workflow names.
 - Node tools use discovered tool node ids and valid node parameters.
-- Custom tools return a stored custom tool id that is registered in config.
+- Custom tools: returned id equals the tool name; it is registered in config as \`{ type: "custom", id: "<tool name>" }\`.
 - Provider tool keys match the configured model provider and the valid key list.`;
 //# sourceMappingURL=tools.prompt.js.map

package/dist/modules/agents/builder/prompts/tools.prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.prompt.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/prompts/tools.prompt.ts"],"names":[],"mappings":";;;AAAa,QAAA,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iFAgGqD,CAAC"}
+{"version":3,"file":"tools.prompt.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/prompts/tools.prompt.ts"],"names":[],"mappings":";;;AAAa,QAAA,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iFAqGqD,CAAC"}

package/dist/modules/agents/builder/skills/integrations.skill.js

@@ -6,6 +6,14 @@ function integrationsSkill() {
         id: 'agent-builder-integrations',
         name: 'Agent Builder Integrations',
         description: 'Use when deciding whether Slack, Linear, Telegram, or another external platform should be a target-agent chat integration/trigger versus a node tool, and when adding or changing chat integrations; not for built-in Build chat or Preview chat behavior.',
+        recommendedTools: ['list_integration_types', 'ask_credential', 'read_config', 'patch_config'],
+        allowedTools: [
+            'list_integration_types',
+            'ask_credential',
+            'read_config',
+            'patch_config',
+            'write_config',
+        ],
         instructions: `\
 ## Purpose
 

package/dist/modules/agents/builder/skills/integrations.skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"integrations.skill.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/integrations.skill.ts"],"names":[],"mappings":";;AAEA,8CAsEC;AAtED,SAAgB,iBAAiB;IAChC,OAAO;QACN,EAAE,EAAE,4BAA4B;QAChC,IAAI,EAAE,4BAA4B;QAClC,WAAW,EACV,4PAA4P;QAC7P,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wEA8DwD;KACtE,CAAC;AACH,CAAC"}
+{"version":3,"file":"integrations.skill.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/integrations.skill.ts"],"names":[],"mappings":";;AAEA,8CA8EC;AA9ED,SAAgB,iBAAiB;IAChC,OAAO;QACN,EAAE,EAAE,4BAA4B;QAChC,IAAI,EAAE,4BAA4B;QAClC,WAAW,EACV,4PAA4P;QAC7P,gBAAgB,EAAE,CAAC,wBAAwB,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,CAAC;QAC7F,YAAY,EAAE;YACb,wBAAwB;YACxB,gBAAgB;YAChB,aAAa;YACb,cAAc;YACd,cAAc;SACd;QACD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wEA8DwD;KACtE,CAAC;AACH,CAAC"}

package/dist/modules/agents/builder/skills/mcp.skill.js

@@ -10,6 +10,22 @@ function mcpSkill() {
         id: 'agent-builder-mcp',
         name: 'Agent builder MCP servers',
         description: 'Use when adding, removing, or updating MCP (Model Context Protocol) servers on the target agent.',
+        recommendedTools: [
+            'search_mcp_servers',
+            'ask_credential',
+            'verify_mcp_server',
+            'read_config',
+            'patch_config',
+        ],
+        allowedTools: [
+            'search_mcp_servers',
+            'ask_credential',
+            'verify_mcp_server',
+            'ask_question',
+            'read_config',
+            'patch_config',
+            'write_config',
+        ],
         instructions: `\
 ## Purpose
 

package/dist/modules/agents/builder/skills/mcp.skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.skill.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/mcp.skill.ts"],"names":[],"mappings":";;AAWA,4BAsGC;AAhHD,8CAA+E;AAE/E,2DAAqD;AAErD,qFAAmF;AAEnF,MAAM,mBAAmB,GAAG,IAAA,gDAAuB,EAClD,IAAA,oCAAe,EAAC,iCAAqB,CAAgB,CACrD,CAAC;AAEF,SAAgB,QAAQ;IACvB,OAAO;QACN,EAAE,EAAE,mBAAmB;QACvB,IAAI,EAAE,2BAA2B;QACjC,WAAW,EACV,kGAAkG;QACnG,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCd,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAmCE,kCAAsB;;;;;;;;;;;;;;;;;;;;;;sCAsBP;KACpC,CAAC;AACH,CAAC"}
+{"version":3,"file":"mcp.skill.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/mcp.skill.ts"],"names":[],"mappings":";;AAWA,4BAsHC;AAhID,8CAA+E;AAE/E,2DAAqD;AAErD,qFAAmF;AAEnF,MAAM,mBAAmB,GAAG,IAAA,gDAAuB,EAClD,IAAA,oCAAe,EAAC,iCAAqB,CAAgB,CACrD,CAAC;AAEF,SAAgB,QAAQ;IACvB,OAAO;QACN,EAAE,EAAE,mBAAmB;QACvB,IAAI,EAAE,2BAA2B;QACjC,WAAW,EACV,kGAAkG;QACnG,gBAAgB,EAAE;YACjB,oBAAoB;YACpB,gBAAgB;YAChB,mBAAmB;YACnB,aAAa;YACb,cAAc;SACd;QACD,YAAY,EAAE;YACb,oBAAoB;YACpB,gBAAgB;YAChB,mBAAmB;YACnB,cAAc;YACd,aAAa;YACb,cAAc;YACd,cAAc;SACd;QACD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCd,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAmCE,kCAAsB;;;;;;;;;;;;;;;;;;;;;;sCAsBP;KACpC,CAAC;AACH,CAAC"}

package/dist/modules/agents/builder/skills/resource-locators.skill.js

@@ -6,6 +6,24 @@ function resourceLocatorsSkill() {
         id: 'agent-builder-resource-locators',
         name: 'Agent Builder Resource Locators',
         description: 'Use when adding or changing node tools with stable dynamic selector fields: resourceLocator, loadOptionsMethod, loadOptions routing, "Name or ID" parameters, teamId, channelId, projectId, calendarId, databaseId, tableId, model selectors, or when write_config/patch_config rejects $fromAI on a dynamic selector.',
+        recommendedTools: [
+            'search_nodes',
+            'get_node_types',
+            'ask_credential',
+            'get_resource_locator_options',
+            'read_config',
+            'patch_config',
+        ],
+        allowedTools: [
+            'search_nodes',
+            'get_node_types',
+            'ask_credential',
+            'get_resource_locator_options',
+            'ask_question',
+            'read_config',
+            'patch_config',
+            'write_config',
+        ],
         instructions: `\
 ## Purpose
 

package/dist/modules/agents/builder/skills/resource-locators.skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource-locators.skill.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/resource-locators.skill.ts"],"names":[],"mappings":";;AAEA,sDAuGC;AAvGD,SAAgB,qBAAqB;IACpC,OAAO;QACN,EAAE,EAAE,iCAAiC;QACrC,IAAI,EAAE,iCAAiC;QACvC,WAAW,EACV,wTAAwT;QACzT,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oDA+FoC;KAClD,CAAC;AACH,CAAC"}
+{"version":3,"file":"resource-locators.skill.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/resource-locators.skill.ts"],"names":[],"mappings":";;AAEA,sDAyHC;AAzHD,SAAgB,qBAAqB;IACpC,OAAO;QACN,EAAE,EAAE,iCAAiC;QACrC,IAAI,EAAE,iCAAiC;QACvC,WAAW,EACV,wTAAwT;QACzT,gBAAgB,EAAE;YACjB,cAAc;YACd,gBAAgB;YAChB,gBAAgB;YAChB,8BAA8B;YAC9B,aAAa;YACb,cAAc;SACd;QACD,YAAY,EAAE;YACb,cAAc;YACd,gBAAgB;YAChB,gBAAgB;YAChB,8BAA8B;YAC9B,cAAc;YACd,aAAa;YACb,cAAc;YACd,cAAc;SACd;QACD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oDA+FoC;KAClD,CAAC;AACH,CAAC"}

package/dist/modules/agents/builder/skills/sub-agents.skill.js

@@ -7,6 +7,14 @@ function subAgentsSkill() {
         id: 'agent-builder-sub-agents',
         name: 'Agent Builder Sub-Agents',
         description: 'Use when configuring inline or saved sub-agent delegation for the target agent, selecting published same-project sub-agents, or changing subAgents.maxChildren.',
+        recommendedTools: ['list_sub_agents', 'ask_question', 'read_config', 'patch_config'],
+        allowedTools: [
+            'list_sub_agents',
+            'ask_question',
+            'read_config',
+            'patch_config',
+            'write_config',
+        ],
         instructions: `\
 ## Purpose
 
@@ -44,30 +52,47 @@ subagent.
    added. Do not write agent ids from memory, prose, or user-entered free text.
 2. If published agents are available and the user has not named exact agents,
    call \`ask_question\` with \`allowMultiple: true\`. Use each option's
-   \`value\` as the returned \`agentId\`, and include descriptions when present.
+   \`value\` as the returned \`agentId\`.
 3. If no published agents are available, do not configure saved subagents.
    Inline delegation still works without saved-agent refs.
-4. Call \`read_config\`.
-5. Patch selected saved agents into \`subAgents.agents\` as
-   \`{ "agentId": "<returned-agent-id>" }\`. Avoid duplicates.
+4. Determine the parent-owned routing guidance for each selected saved
+   subagent. Store it as \`useWhen\`, for example
+   \`{ "agentId": "<returned-agent-id>", "useWhen": "Use for billing-policy questions and invoice investigations." }\`.
+5. If it is unclear when a selected saved subagent should be used, ask the user
+   a follow-up before patching \`subAgents.agents\`. Do not invent vague routing
+   guidance.
+6. Call \`read_config\`.
+7. Patch selected saved agents into \`subAgents.agents\`. Avoid duplicates.
 
 Example patch flow:
 
 1. \`list_sub_agents()\`.
 2. If it returns one or more agents and the user has not named exact ones, call
    \`ask_question({ allowMultiple: true, ... })\` with those agents as options.
-3. \`read_config()\`.
-4. \`patch_config(...)\` adding selected \`{ "agentId": "<returned-agent-id>" }\`
-   refs to \`/subAgents/agents\`.
+3. If the user's request does not make the routing rule clear, ask when each
+   selected saved subagent should be used.
+4. \`read_config()\`.
+5. \`patch_config(...)\` adding selected
+   \`{ "agentId": "<returned-agent-id>", "useWhen": "Use for ..." }\` refs to
+   \`/subAgents/agents\`.
 
 ## Rules
 
 - If the resumed values include text that is not one of the listed agent ids,
   do not persist it as an agent id; ask a follow-up.
+- \`useWhen\` is relationship-specific routing guidance owned by this parent
+  config. It is not the child agent's global description.
+- Write \`useWhen\` only when the intended routing is clear from the user's
+  request or an explicit follow-up answer.
+- Every new or updated saved subagent ref must include \`useWhen\`.
+- Good \`useWhen\` values are concrete and intent-oriented, such as
+  "Use for invoice investigations and payment status checks."
+- Do not write vague values such as "Use when helpful", "Use for tasks", or
+  "Use for this agent."
 - Do not add custom tools, custom instructions, or custom schema fields to
   simulate subagents.
 - Preserve existing \`subAgents.agents\` refs unless the user explicitly asks to
-  change saved subagents.
+  change saved subagents. Preserve existing \`useWhen\` values when keeping refs.
 
 ## Inline model mappings
 
@@ -95,6 +120,7 @@ Example shape:
 
 - Inline delegation still works even when \`subAgents.agents\` is absent.
 - Saved refs use only returned same-project published agent ids.
+- New or updated saved refs include concrete \`useWhen\` guidance.
 - Any \`subAgents.maxChildren\` value stays within ${api_types_1.SUB_AGENT_MAX_CHILDREN_MIN} to ${api_types_1.SUB_AGENT_MAX_CHILDREN_MAX}.`,
     };
 }

package/dist/modules/agents/builder/skills/sub-agents.skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"sub-agents.skill.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/sub-agents.skill.ts"],"names":[],"mappings":";;AAOA,wCAgGC;AAtGD,8CAIwB;AAExB,SAAgB,cAAc;IAC7B,OAAO;QACN,EAAE,EAAE,0BAA0B;QAC9B,IAAI,EAAE,0BAA0B;QAChC,WAAW,EACV,iKAAiK;QAClK,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;sDAuBsC,sCAA0B,OAAO,sCAA0B,gCAAgC,0CAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qDAiE1H,sCAA0B,OAAO,sCAA0B,GAAG;KACjH,CAAC;AACH,CAAC"}
+{"version":3,"file":"sub-agents.skill.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/sub-agents.skill.ts"],"names":[],"mappings":";;AAOA,wCA0HC;AAhID,8CAIwB;AAExB,SAAgB,cAAc;IAC7B,OAAO;QACN,EAAE,EAAE,0BAA0B;QAC9B,IAAI,EAAE,0BAA0B;QAChC,WAAW,EACV,iKAAiK;QAClK,gBAAgB,EAAE,CAAC,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,CAAC;QACpF,YAAY,EAAE;YACb,iBAAiB;YACjB,cAAc;YACd,aAAa;YACb,cAAc;YACd,cAAc;SACd;QACD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;sDAuBsC,sCAA0B,OAAO,sCAA0B,gCAAgC,0CAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qDAmF1H,sCAA0B,OAAO,sCAA0B,GAAG;KACjH,CAAC;AACH,CAAC"}