n8n 2.23.2 → 2.24.0

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

@@ -71,13 +71,26 @@ Use \`patch_config\` with:
 #### Configure Native Provider Features
 
 - Thinking lives under \`config.thinking\`.
-- The write path fills native provider tool defaults. Do not invent provider tool keys.
+- Web search lives under \`config.webSearch\`.
+- Only OpenAI and Anthropic models support native web search. For those models, set
+  \`config.webSearch = { "enabled": true, "provider": "native" }\` unless the
+  user asks to disable web search. Omitting \`provider\` also means native.
+- For every other provider, never use \`provider: "native"\` or omit
+  \`provider\` for enabled web search.
+- For Brave or SearXNG search, call \`ask_credential\`, then set
+  \`config.webSearch = { "enabled": true, "provider": "brave" | "searxng", "credential": "<credentialId>" }\`.
+- Brave and SearXNG remain fallback tools even when the model provider also supports native search.
+- When patching only \`/model\` and \`/credential\`, do not patch
+  \`/config/webSearch\` if the existing provider is \`"brave"\` or \`"searxng"\`
+  unless the user explicitly asked to change the web-search method.
+- Never write \`{ "enabled": true }\` alone for fallback search.
+- The write path fills native provider tool defaults only for native search. Do not invent provider tool keys.
 
 #### Configure Fallback Services
 
-- Services that require credentials must call \`ask_credential\` first.
-- Persist only the credential id returned by \`ask_credential\`.
+- Services that require credentials must call \`ask_credential\` first and persist only its returned credential id.
 - If credential selection is skipped, do not enable the feature unless it supports missing credentials.
+- For fallback web search, use exact credential type names: \`braveSearchApi\` for \`provider: "brave"\`, and \`searXngApi\` for \`provider: "searxng"\`.
 
 #### Add Node Or Workflow Tools
 
@@ -89,7 +102,7 @@ Use \`patch_config\` with:
 
 Bad: inventing top-level fields
 \`\`\`json
-{ "temperature": 0.7 }
+{ "webSearch": { "enabled": true } }
 \`\`\`
 
 Bad: provider namespace as provider tool
@@ -104,7 +117,7 @@ Bad: copying credential IDs from \`list_credentials\`
 
 Bad: replacing \`config\` while dropping unrelated settings
 \`\`\`json
-{ "config": { "thinking": { "provider": "anthropic", "budgetTokens": 1024 } } }
+{ "config": { "webSearch": { "enabled": true } } }
 \`\`\`
 
 ### Gotchas
@@ -112,12 +125,14 @@ Bad: replacing \`config\` while dropping unrelated settings
 - \`write_config\` replaces the full config; include every field that should survive.
 - \`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\` are rejected; ask for details instead.
 
 ### Verify
 
 - The final payload validates against the Config schema reference.
 - Existing unrelated config, tools, skills, integrations, and memory remain present unless intentionally changed.
+- Existing Brave or SearXNG web search remains present on model-only changes.
 - Credential fields use ids returned by the correct interactive credential tools.
 - Provider tool keys are valid and match the selected model provider.
 

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,0DA8HC;AAhID,+DAAyF;AAEzF,SAAgB,uBAAuB;IACtC,OAAO;;;;;;;;;;;;;;;;;;;;;EAqBN,IAAA,2CAAqB,GAAE;;EAEvB,IAAA,+CAAyB,GAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EAqG+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

@@ -6,13 +6,18 @@ 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,
+    credential: zod_1.z.string().trim().min(1),
+});
 const BuilderPromptMemoryConfigSchema = zod_1.z.object({
     enabled: zod_1.z.boolean(),
     storage: zod_1.z.literal('n8n'),
-    lastMessages: zod_1.z.number().int().min(1).max(200).optional(),
     observationalMemory: zod_1.z
         .object({
         enabled: zod_1.z.boolean().optional(),
+        observerModel: BuilderPromptMemoryWorkerModelSchema.optional(),
+        reflectorModel: BuilderPromptMemoryWorkerModelSchema.optional(),
         observerThresholdTokens: zod_1.z.number().int().min(1).optional(),
         reflectorThresholdTokens: zod_1.z.number().int().min(1).optional(),
         renderTokenBudget: zod_1.z.number().int().min(1).optional(),
@@ -26,6 +31,8 @@ const BuilderPromptMemoryConfigSchema = zod_1.z.object({
         zod_1.z.object({
             enabled: zod_1.z.literal(true),
             credential: zod_1.z.string().min(1),
+            extractorModel: BuilderPromptMemoryWorkerModelSchema.optional(),
+            reflectorModel: BuilderPromptMemoryWorkerModelSchema.optional(),
             topK: zod_1.z.number().int().min(1).max(100).optional(),
             maxEntriesPerRun: zod_1.z.number().int().min(1).max(50).optional(),
         }),
@@ -42,17 +49,29 @@ function getConfigRulesSection() {
 - \`model\` must be "provider/model-name".
 - \`credential\` must be the id returned by \`resolve_llm\` or \`ask_llm\`.
 - Fresh agents must include
-  \`memory: { "enabled": true, "storage": "n8n", "lastMessages": 50 }\`
+  \`memory: { "enabled": true, "storage": "n8n" }\`
   unless the user explicitly asks to disable memory.
-- \`memory.storage\` must be "n8n"; \`memory.lastMessages\` defaults to 50.
+- \`memory.storage\` must be "n8n".
 - \`memory.episodicMemory\` requires \`ask_credential\` with
   \`credentialType: "openAiApi"\`.
+- Memory worker model fields use \`{ "model": "provider/model-name", "credential": "<credentialId>" }\`;
+  use only credential IDs returned by \`resolve_llm\`, \`ask_llm\`, or \`ask_credential\`.
+- Web search lives under \`config.webSearch\`. Only OpenAI and Anthropic models
+  support native web search; for those providers, use
+  \`{ "enabled": true, "provider": "native" }\` or omit \`provider\`. Every
+  other provider requires fallback search with \`provider: "brave"\` or
+  \`provider: "searxng"\` and a credential. Never write \`{ "enabled": true }\`
+  alone for fallback search. Use exact \`ask_credential\` types:
+  \`braveSearchApi\` for Brave and \`searXngApi\` for SearXNG.
+- 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, and instructions before config
   is written.`;
 }
 function getSchemaReferenceSection() {
-    const jsonSchemaText = (0, schema_text_serializer_1.jsonSchemaToCompactText)((0, zod_to_json_schema_1.zodToJsonSchema)(BuilderPromptAgentJsonConfigSchema));
+    const zodSchema = BuilderPromptAgentJsonConfigSchema;
+    const jsonSchemaText = (0, schema_text_serializer_1.jsonSchemaToCompactText)((0, zod_to_json_schema_1.zodToJsonSchema)(zodSchema));
     return `\
 #### Config Schema Reference
 

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":";;AAuCA,sDAeC;AAED,8DAUC;AAjED,6BAAwB;AACxB,2DAAqD;AAErD,8CAA+D;AAE/D,qFAAmF;AAEnF,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,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACzD,mBAAmB,EAAE,OAAC;SACpB,MAAM,CAAC;QACP,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC/B,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,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;;;;;;;;;;;;;cAaM,CAAC;AACf,CAAC;AAED,SAAgB,yBAAyB;IACxC,MAAM,cAAc,GAAG,IAAA,gDAAuB,EAC7C,IAAA,oCAAe,EAAC,kCAAkC,CAAgB,CAClE,CAAC;IACF,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":";;AAgDA,sDA0BC;AAED,8DASC;AAnFD,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;;;;;;;;;;;;;;;;;;;;;;;;cAwBM,CAAC;AACf,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

@@ -26,6 +26,21 @@ Use this to resolve the target agent's main \`model\` and \`credential\`.
 - Explicit provider/model requests go to \`resolve_llm\` first.
 - If the user asks to pick, change, confirm, or configure a model or main credential, call \`ask_llm\`; do not ask in prose.
 - If \`resolve_llm\` succeeds, persist \`model = "{provider}/{model}"\` and \`credential = credentialId\`.
+- Only OpenAI and Anthropic models support native web search. Use native web
+  search by default for those providers only, and only for
+  fresh agents or agents with no existing \`config.webSearch\`. Persist
+  \`config.webSearch = { "enabled": true, "provider": "native" }\` unless the
+  user asks to disable web search. Do not write native \`providerTools\`; the
+  write path derives them.
+- When changing models, preserve existing Brave or SearXNG
+  \`config.webSearch\` unchanged, including its credential, even if the new
+  model supports native search. Switch fallback search to native only when the
+  user explicitly asks for native/provider web search.
+- For every provider other than OpenAI or Anthropic, web search requires
+  fallback search: call \`ask_credential\`, then use \`provider: "brave"\` or
+  \`provider: "searxng"\`.
+- If the user explicitly asks for Brave or SearXNG, keep that provider even
+  when the selected model also supports native search.
 - If \`resolve_llm\` reports missing or ambiguous credentials/provider, call \`ask_llm\`.
 - If it reports \`unknown_model\`, retry with a plausible returned model value or call \`ask_llm\`.
 - For "Anthropic via OpenRouter", pass \`provider: "openrouter"\`; if the user names a routed model, pass the routed id without adding another provider prefix.
@@ -37,11 +52,13 @@ Use this to resolve the target agent's main \`model\` and \`credential\`.
 - Use \`resolve_llm\` or \`ask_llm\` only for the target agent's main model credential.
 - Use \`ask_credential\` for node tools, integrations, and Episodic Memory.
 - For OpenRouter, \`provider\` is \`"openrouter"\`; the model can be a routed id such as \`anthropic/...\`.
+- Model changes must not silently replace existing Brave or SearXNG web search with native search.
 - Do not recommend current, best, latest, or fallback model IDs from memory when the recommendation catalog is unavailable.
 
 ### Verify
 
 - The persisted \`model\` is in \`provider/model\` form.
-- The persisted \`credential\` came from \`resolve_llm\` or \`ask_llm\`.${recommendationGuidance}`;
+- The persisted \`credential\` came from \`resolve_llm\` or \`ask_llm\`.
+- Existing Brave or SearXNG \`config.webSearch\` is preserved on model changes unless the user explicitly requested a web-search method change.${recommendationGuidance}`;
 }
 //# sourceMappingURL=llm-selection.prompt.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"llm-selection.prompt.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/prompts/llm-selection.prompt.ts"],"names":[],"mappings":";;AAAA,sDA2CC;AA3CD,SAAgB,qBAAqB,CAAC,2BAA0C;IAC/E,MAAM,sBAAsB,GAAG,2BAA2B;QACzD,CAAC,CAAC,OAAO,2BAA2B,EAAE;QACtC,CAAC,CAAC,mMAAmM,CAAC;IAEvM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0EAqCkE,sBAAsB,EAAE,CAAC;AACnG,CAAC"}
+{"version":3,"file":"llm-selection.prompt.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/prompts/llm-selection.prompt.ts"],"names":[],"mappings":";;AAAA,sDA4DC;AA5DD,SAAgB,qBAAqB,CAAC,2BAA0C;IAC/E,MAAM,sBAAsB,GAAG,2BAA2B;QACzD,CAAC,CAAC,OAAO,2BAA2B,EAAE;QACtC,CAAC,CAAC,mMAAmM,CAAC;IAEvM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iJAsDyI,sBAAsB,EAAE,CAAC;AAC1K,CAAC"}

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  \"lastMessages\": 50,\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- `lastMessages` defaults to 50.\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`, `observerThresholdTokens`, `reflectorThresholdTokens`, `renderTokenBudget`, `observationLogTailLimit`, and `lockTtlMs`.\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- 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_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.";

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

@@ -15,7 +15,6 @@ Fresh agents must include this default memory config unless the user explicitly
 {
   "enabled": true,
   "storage": "n8n",
-  "lastMessages": 50,
   "observationalMemory": {
     "enabled": true
   }
@@ -30,16 +29,19 @@ separate user-facing memory product.
 
 - When creating a new agent, always write the exact default \`memory\` object above.
 - Set \`storage\` to "n8n".
-- \`lastMessages\` defaults to 50.
 - Set \`observationalMemory.enabled\` to \`true\` for new agents unless the user explicitly asks to disable observational memory.
 - Keep the rest of \`observationalMemory\` optional; add tuning fields only for explicit tuning or disabling.
-- Supported observational memory tuning fields: \`enabled\`, \`observerThresholdTokens\`, \`reflectorThresholdTokens\`, \`renderTokenBudget\`, \`observationLogTailLimit\`, and \`lockTtlMs\`.
+- Supported observational memory tuning fields: \`enabled\`, \`observerModel\`, \`reflectorModel\`, \`observerThresholdTokens\`, \`reflectorThresholdTokens\`, \`renderTokenBudget\`, \`observationLogTailLimit\`, and \`lockTtlMs\`.
+- Memory worker model fields must use object shape: \`{ "model": "provider/model-name", "credential": "<credentialId>" }\`.
+- Only set \`observerModel\`, \`reflectorModel\`, \`extractorModel\`, or \`episodicMemory.reflectorModel\` when the user explicitly asks to use a specific model for memory work.
+- 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.
 
 ### 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\`.
+- \`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."

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

@@ -1 +1 @@
-{"version":3,"file":"memory.prompt.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/prompts/memory.prompt.ts"],"names":[],"mappings":";;;AAAa,QAAA,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0EAuD6C,CAAC"}
+{"version":3,"file":"memory.prompt.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/prompts/memory.prompt.ts"],"names":[],"mappings":";;;AAAa,QAAA,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0EAyD6C,CAAC"}

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\nPrefer existing workflow tools and node tools over custom tools for real-world actions.\nCustom tools are for pure computation, validation, formatting, or planning logic;\nthey cannot perform live network, filesystem, process, timer, or host I/O.\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- 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. 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- 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- 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- 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- 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.";

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

@@ -14,10 +14,18 @@ nodes, custom code tools, or provider tools.
 Use this guidance before calling \`search_nodes\`, \`get_node_types\`, \`build_custom_tool\`,
 or adding, changing, or removing entries in \`tools[]\` / \`providerTools\`.
 
-Prefer existing workflow tools and node tools over custom tools for real-world actions.
 Custom tools are for pure computation, validation, formatting, or planning logic;
 they cannot perform live network, filesystem, process, timer, or host I/O.
 
+If a product also has a target-agent integration, use node/workflow tools when
+the product is only an API capability and the conversation or trigger happens
+elsewhere. Use the integration only when that product is the chat/trigger
+surface or the agent needs the current platform conversation context. For
+example, use Linear node tools for ordinary issue search/create/update when
+the agent is triggered from Slack, schedule, Preview, or a workflow; use the
+Linear integration only when people will talk to the agent from Linear
+issues/comments.
+
 #### Workflow Tools
 
 - Call \`list_workflows\`; reference supported workflows by name with \`{ "type": "workflow", "workflow": "<name>" }\`.
@@ -31,7 +39,7 @@ they cannot perform live network, filesystem, process, timer, or host I/O.
 - Never write literal \`"$fromAI"\` or bare \`$fromAI\`; the node will treat it as the actual value.
 - Do not pipe AI-chosen fields through \`$json\`.
 - Do not include \`inputSchema\` or \`toolDescription\` for node tools.
-- For each required credential slot, call \`ask_credential\` once before config mutation. If skipped, still add the tool and omit only that credential slot.
+- 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.
 
 #### Custom Tools
 
@@ -65,6 +73,7 @@ export default new Tool('tool_name')
 
 ### Gotchas
 
+- Web-search fallback services are config, not node tools, unless the user explicitly asks for a node integration.
 - Live crawling, fetching, and API integrations need workflow or node tools, not custom tools.
 - Do not include \`inputSchema\` or \`toolDescription\` for node tools.
 - \`$fromAI(...)\` placeholders define the node tool input schema; do not add it manually.

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iFA4EqD,CAAC"}
+{"version":3,"file":"tools.prompt.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/prompts/tools.prompt.ts"],"names":[],"mappings":";;;AAAa,QAAA,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iFAqFqD,CAAC"}

package/dist/modules/agents/builder/search-mcp-servers.tool.d.ts

@@ -0,0 +1,6 @@
+import type { BuiltTool } from '@n8n/agents';
+import type { McpRegistryService } from '../../../modules/mcp-registry/registry/mcp-registry.service';
+export interface SearchMcpServersDeps {
+    mcpRegistryService: McpRegistryService;
+}
+export declare function buildSearchMcpServersTool(deps: SearchMcpServersDeps): BuiltTool;

package/dist/modules/agents/builder/search-mcp-servers.tool.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSearchMcpServersTool = buildSearchMcpServersTool;
+const tool_1 = require("@n8n/agents/tool");
+const change_case_1 = require("change-case");
+const zod_1 = require("zod");
+const node_description_transform_1 = require("../../../modules/mcp-registry/node-description-transform");
+const builder_tool_names_1 = require("./builder-tool-names");
+const searchMcpServersInputSchema = zod_1.z.object({
+    queries: zod_1.z
+        .array(zod_1.z.string())
+        .min(1)
+        .describe('Search queries for MCP servers (e.g., ["github"], ["slack"])'),
+});
+function getMcpRegistryCredentialTypeName(server) {
+    return `${(0, change_case_1.camelCase)(server.slug)}McpOAuth2Api`;
+}
+function pickPreferredRemote(server) {
+    const streamable = server.remotes.find((remote) => remote.type === 'streamable-http');
+    if (streamable)
+        return { type: 'streamableHttp', url: streamable.url };
+    const sse = server.remotes.find((remote) => remote.type === 'sse');
+    if (sse)
+        return { type: 'sse', url: sse.url };
+    return null;
+}
+function registryServerToMcpConfig(server) {
+    const remote = pickPreferredRemote(server);
+    if (!remote)
+        return null;
+    const credentialType = getMcpRegistryCredentialTypeName(server);
+    const nodeTypeName = `${node_description_transform_1.MCP_REGISTRY_PACKAGE_NAME}.${(0, change_case_1.camelCase)(server.slug)}`;
+    return {
+        name: (0, change_case_1.camelCase)(server.slug),
+        title: server.title,
+        description: server.tagline,
+        url: remote.url,
+        transport: remote.type,
+        authentication: credentialType,
+        credentialType,
+        tools: server.tools.map((tool) => ({
+            name: tool.name,
+            ...(tool.title ? { title: tool.title } : {}),
+        })),
+        metadata: {
+            nodeTypeName,
+        },
+    };
+}
+function normalizeQueries(queries) {
+    return queries.map((query) => query.trim().toLowerCase()).filter((query) => query.length > 0);
+}
+function matchesServerQuery(server, normalizedQueries) {
+    const fields = [
+        server.slug,
+        (0, change_case_1.camelCase)(server.slug),
+        server.title,
+        server.description,
+        server.tagline,
+    ]
+        .map((field) => (typeof field === 'string' ? field.toLowerCase() : null))
+        .filter((field) => field !== null);
+    return normalizedQueries.some((query) => fields.some((field) => field.includes(query)));
+}
+function buildSearchMcpServersTool(deps) {
+    return new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.SEARCH_MCP_SERVERS)
+        .description('Search the MCP registry for available MCP servers. Returns MCP config-ready server details, ' +
+        'including credentialType for ask_credential and server metadata needed for patch_config.')
+        .input(searchMcpServersInputSchema)
+        .handler(async ({ queries }) => {
+        const normalizedQueries = normalizeQueries(queries);
+        if (normalizedQueries.length === 0)
+            return { results: [] };
+        const servers = await deps.mcpRegistryService.getAll();
+        const results = servers.flatMap((server) => {
+            if (!matchesServerQuery(server, normalizedQueries))
+                return [];
+            const transformed = registryServerToMcpConfig(server);
+            return transformed ? [transformed] : [];
+        });
+        return { results };
+    })
+        .build();
+}
+//# sourceMappingURL=search-mcp-servers.tool.js.map

package/dist/modules/agents/builder/search-mcp-servers.tool.js.map

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

package/dist/modules/agents/builder/skill-body-template.d.ts

@@ -0,0 +1,4 @@
+export declare const SKILL_DESCRIPTION_RULE: string;
+export declare const SKILL_BODY_FORMAT_RULE: string;
+export declare const SKILL_BODY_TEMPLATE = "## Overview\n<1-2 sentences: what the agent should do when this skill is loaded, and the outcome it produces.>\n\n## Inputs\n<What the agent needs before starting \u2014 required inputs, tools, credentials, or context \u2014 and how to obtain them. Write \"None\" if there are no prerequisites.>\n\n## Steps\n1. <First action \u2014 specific and actionable.>\n2. <Next action.>\n\n## Rules\n- <A constraint or guideline the agent must always follow.>\n\n## Example\n<A concrete, representative example: the input and the expected output or result.>\n\n## Gotchas\n<Common mistakes or edge cases, and how to handle them.>";
+export declare const SKILL_BODY_GUIDANCE = "The body is loaded only after the skill triggers, so it must be a self-contained, actionable operating manual. Follow this exact Markdown structure, filling each applicable section with concrete, specific content \u2014 no placeholders or angle-bracket text. Do NOT put \"when to use\" triggers here; those belong in the description:\n\n## Overview\n<1-2 sentences: what the agent should do when this skill is loaded, and the outcome it produces.>\n\n## Inputs\n<What the agent needs before starting \u2014 required inputs, tools, credentials, or context \u2014 and how to obtain them. Write \"None\" if there are no prerequisites.>\n\n## Steps\n1. <First action \u2014 specific and actionable.>\n2. <Next action.>\n\n## Rules\n- <A constraint or guideline the agent must always follow.>\n\n## Example\n<A concrete, representative example: the input and the expected output or result.>\n\n## Gotchas\n<Common mistakes or edge cases, and how to handle them.>";

package/dist/modules/agents/builder/skill-body-template.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_BODY_GUIDANCE = exports.SKILL_BODY_TEMPLATE = exports.SKILL_BODY_FORMAT_RULE = exports.SKILL_DESCRIPTION_RULE = void 0;
+exports.SKILL_DESCRIPTION_RULE = 'The description is the routing contract — the only text the agent sees when deciding whether ' +
+    'to load this skill, so it must be specific: state what the skill does AND the concrete ' +
+    'situations or keywords that should trigger it (e.g. "Use when the user asks to …"), plus when ' +
+    'NOT to use it where helpful. A vague description means the skill never loads.';
+exports.SKILL_BODY_FORMAT_RULE = 'The body is loaded only after the skill triggers, so it must be a self-contained, actionable ' +
+    'operating manual. Follow this exact Markdown structure, filling each applicable section with ' +
+    'concrete, specific content — no placeholders or angle-bracket text. Do NOT put "when to use" ' +
+    'triggers here; those belong in the description:';
+exports.SKILL_BODY_TEMPLATE = `## Overview
+<1-2 sentences: what the agent should do when this skill is loaded, and the outcome it produces.>
+
+## Inputs
+<What the agent needs before starting — required inputs, tools, credentials, or context — and how to obtain them. Write "None" if there are no prerequisites.>
+
+## Steps
+1. <First action — specific and actionable.>
+2. <Next action.>
+
+## Rules
+- <A constraint or guideline the agent must always follow.>
+
+## Example
+<A concrete, representative example: the input and the expected output or result.>
+
+## Gotchas
+<Common mistakes or edge cases, and how to handle them.>`;
+exports.SKILL_BODY_GUIDANCE = `${exports.SKILL_BODY_FORMAT_RULE}\n\n${exports.SKILL_BODY_TEMPLATE}`;
+//# sourceMappingURL=skill-body-template.js.map

package/dist/modules/agents/builder/skill-body-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-body-template.js","sourceRoot":"","sources":["../../../../src/modules/agents/builder/skill-body-template.ts"],"names":[],"mappings":";;;AAgBa,QAAA,sBAAsB,GAClC,+FAA+F;IAC/F,yFAAyF;IACzF,gGAAgG;IAChG,+EAA+E,CAAC;AAGpE,QAAA,sBAAsB,GAClC,+FAA+F;IAC/F,+FAA+F;IAC/F,+FAA+F;IAC/F,iDAAiD,CAAC;AAEtC,QAAA,mBAAmB,GAAG;;;;;;;;;;;;;;;;;yDAiBsB,CAAC;AAG7C,QAAA,mBAAmB,GAAG,GAAG,8BAAsB,OAAO,2BAAmB,EAAE,CAAC"}

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

@@ -2,11 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getBuilderRuntimeSkills = getBuilderRuntimeSkills;
 const integrations_skill_1 = require("./integrations.skill");
+const mcp_skill_1 = require("./mcp.skill");
 const target_skills_skill_1 = require("./target-skills.skill");
+const target_tasks_skill_1 = require("./target-tasks.skill");
 function getBuilderRuntimeSkills() {
-    return [
+    const skills = [
         (0, integrations_skill_1.integrationsSkill)(),
+        (0, mcp_skill_1.mcpSkill)(),
         (0, target_skills_skill_1.targetSkillsSkill)(),
+        (0, target_tasks_skill_1.targetTasksSkill)(),
     ];
+    return skills;
 }
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/index.ts"],"names":[],"mappings":";;AAKA,0DASC;AAZD,6DAAyD;AACzD,+DAA0D;AAE1D,SAAgB,uBAAuB;IACtC,OAAO;QACN,IAAA,sCAAiB,GAAE;QACnB,IAAA,uCAAiB,GAAE;KAKnB,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/index.ts"],"names":[],"mappings":";;AAOA,0DAaC;AAlBD,6DAAyD;AACzD,2CAAuC;AACvC,+DAA0D;AAC1D,6DAAwD;AAExD,SAAgB,uBAAuB;IACtC,MAAM,MAAM,GAAmB;QAC9B,IAAA,sCAAiB,GAAE;QACnB,IAAA,oBAAQ,GAAE;QACV,IAAA,uCAAiB,GAAE;QACnB,IAAA,qCAAgB,GAAE;KAKlB,CAAC;IAEF,OAAO,MAAM,CAAC;AACf,CAAC"}

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

@@ -5,48 +5,69 @@ function integrationsSkill() {
     return {
         id: 'agent-builder-integrations',
         name: 'Agent Builder Integrations',
-        description: 'Use when adding or changing target-agent schedule triggers or connected external chat-platform integrations; not for built-in Build chat or Preview chat behavior.',
+        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.',
         instructions: `\
 ## Purpose
 
-Use this to configure entries in the target agent's \`integrations\` array.
+Use this to decide whether the target agent needs an entry in \`integrations\`
+or a normal node/workflow tool for an external product, then configure
+\`integrations\` only when the integration is the right surface.
 
-## Boundaries
+## Use when
 
-- The user is asking for Build chat or Preview chat behavior.
-- The user wants an agent tool that sends messages; follow the Tool Guidance section instead.
-- The user only needs model, memory, or config-schema guidance.
-- Built-in Preview chat does not need an \`integrations\` entry.
+- The user asks to add, update, or remove entries in the target agent's
+  \`integrations\` array.
+- The user asks to connect the target agent to an external chat platform with
+  credentials.
 
-## Workflow
+## Integration vs Node Tool Decision
 
-The \`integrations\` array controls how the target agent is triggered.
+Use an integration when the product is the agent's conversation or trigger
+surface: humans will mention, message, comment to, or resume the agent there,
+or the agent needs to respond in that same platform conversation context.
+
+Use a node/workflow tool when the product is only something the agent operates
+on: searching records, creating tickets, updating objects, or sending a
+business-process notification while the conversation happens elsewhere.
+
+Examples:
 
-### Schedule
+- Slack integration: the agent should be chatted with in Slack, respond in
+  Slack threads, DM users, message channels, add reactions, or render rich UI
+  to Slack users.
+- Linear integration: the agent should be triggered from Linear issues/comments,
+  understand the current Linear subject, or reply in the same Linear
+  conversation.
+- Linear node tools: the agent is triggered from Slack, Preview, a task, or a
+  workflow and only needs to search/create/update Linear tickets.
 
-- One schedule integration per agent.
-- Use \`{ "type": "schedule", "active": false, "cronExpression": "0 9 * * *", "wakeUpPrompt": "..." }\`.
-- Keep \`active: false\`; schedules run only after publish and activation.
-- Use standard 5-field cron.
+## Workflow
+
+The \`integrations\` array controls how the target agent is triggered.
 
 ### Chat Integrations
 
 - These are connected external chat platforms, not built-in Preview chat.
 - Call \`list_integration_types\` first.
+- Read the returned \`capabilities\`, \`useIntegrationWhen\`, and
+  \`useNodeToolWhen\` fields before deciding to add an integration.
 - Pick one returned \`credentialTypes\` entry and pass it to \`ask_credential\`.
 - Persist only \`type\` and \`credentialId\`; never invent credential IDs or names.
-- Preserve existing schedule and chat integrations unless the user asked to remove them.
+- Preserve existing chat integrations unless the user asked to remove them.
 
 ## Gotchas
 
-- Active schedules are rejected until the agent is published; create or update schedules as inactive.
-- The schedule \`wakeUpPrompt\` is the message sent when the schedule fires, not target-agent system instructions.
 - Chat integration credential types must come from \`list_integration_types\`.
+- Do not add a Linear integration just because the agent needs Linear issue
+  CRUD. Use Linear node tools unless Linear itself is the chat/trigger context.
+- For recurring or scheduled runs, create a task (\`create_task\`), not an
+  integration.
 
 ## Verify
 
-- Schedule configs include \`type\`, \`active\`, \`cronExpression\`, and \`wakeUpPrompt\`.
 - Connected chat integrations use a credential id returned by \`ask_credential\`.
+- The chosen integration matches \`useIntegrationWhen\`; otherwise use node or
+  workflow tools.
 - The final \`integrations\` array keeps unrelated integrations intact.`,
     };
 }

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,8CAiDC;AAjDD,SAAgB,iBAAiB;IAChC,OAAO;QACN,EAAE,EAAE,4BAA4B;QAChC,IAAI,EAAE,4BAA4B;QAClC,WAAW,EACV,oKAAoK;QACrK,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wEAyCwD;KACtE,CAAC;AACH,CAAC"}
+{"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"}

package/dist/modules/agents/builder/skills/mcp.skill.d.ts

@@ -0,0 +1,2 @@
+import type { RuntimeSkill } from '@n8n/agents';
+export declare function mcpSkill(): RuntimeSkill;