n8n 2.28.3 → 2.29.0

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

@@ -7,6 +7,8 @@ function targetSkillsSkill() {
         id: 'agent-builder-target-skills',
         name: 'Agent Builder Target Skills',
         description: 'Use when creating reusable target-agent skills, playbooks, policies, style guides, or domain instructions with create_skill that should load only for relevant future requests; not for builder guidance or one-off instructions.',
+        recommendedTools: ['create_skill', 'ask_question', 'read_config', 'patch_config'],
+        allowedTools: ['create_skill', 'ask_question', 'read_config', 'patch_config', 'write_config'],
         instructions: `\
 ## Purpose
 
@@ -50,14 +52,31 @@ for open-ended) until you can write it. Never create a placeholder or vague skil
 - Gather the domain detail you need, asking clarifying questions until the
   description and every applicable body section can be written with concrete
   content.
-- Write the \`description\` as the routing contract and the \`body\` using the
+- Write the \`description\` as the routing contract and \`instructions\` using the
   template above. Put all "when to use" / "when not to use" guidance in the
   description, never in the body (the body is invisible until the skill loads).
-- Call \`create_skill\` with \`name\`, \`description\`, and \`body\`.
-- \`create_skill\` stores the body only; it does not attach the skill.
+- Call \`create_skill\` with \`name\`, \`description\`, and \`instructions\`.
+- \`create_skill\` stores the skill only; it does not attach the skill.
 - After it returns an id, call \`read_config\`.
 - Use \`patch_config\` or \`write_config\` to add \`{ "type": "skill", "id": "<returned id>" }\` to \`skills\`.
 
+## Extended fields
+
+- Use \`allowedTools\` only for exact tool names already attached to the target
+  agent that this skill may use.
+- Add \`references\` for longer markdown-only supporting files under
+  \`references/...\`, such as rubrics, examples, policies, templates, or
+  checklists. References are not automatically loaded when the skill loads.
+  If you add references, the main \`instructions\` must say exactly when to load
+  each reference by path.
+- Example reference load rules: "Before scoring renewal risk, load
+  \`references/risk-rubric.md\`"; "Before drafting negotiation copy, load
+  \`references/negotiation-playbook.md\`"; "Before asking intake questions, load
+  \`references/intake-checklist.md\`".
+- Omit fields you cannot fill confidently. Do not invent tool names or file paths.
+- Scripts are not supported in this phase. Do not pass scripts or non-markdown
+  linked files to \`create_skill\`.
+
 ## Rules
 
 - Write descriptions as intent-oriented "Use when..." guidance with concrete

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

@@ -1 +1 @@
-{"version":3,"file":"target-skills.skill.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/target-skills.skill.ts"],"names":[],"mappings":";;AAQA,8CAkFC;AAxFD,gEAIgC;AAEhC,SAAgB,iBAAiB;IAChC,OAAO;QACN,EAAE,EAAE,6BAA6B;QACjC,IAAI,EAAE,6BAA6B;QACnC,WAAW,EACV,mOAAmO;QACpO,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;EAqBd,4CAAsB;;;;EAItB,4CAAsB;;EAEtB,yCAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA+CE;KACrB,CAAC;AACH,CAAC"}
+{"version":3,"file":"target-skills.skill.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/target-skills.skill.ts"],"names":[],"mappings":";;AAQA,8CAqGC;AA3GD,gEAIgC;AAEhC,SAAgB,iBAAiB;IAChC,OAAO;QACN,EAAE,EAAE,6BAA6B;QACjC,IAAI,EAAE,6BAA6B;QACnC,WAAW,EACV,mOAAmO;QACpO,gBAAgB,EAAE,CAAC,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,CAAC;QACjF,YAAY,EAAE,CAAC,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,CAAC;QAC7F,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;EAqBd,4CAAsB;;;;EAItB,4CAAsB;;EAEtB,yCAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAgEE;KACrB,CAAC;AACH,CAAC"}

package/dist/modules/agents/builder/skills/target-tasks.skill.js

@@ -7,6 +7,18 @@ function targetTasksSkill() {
         id: 'agent-builder-target-tasks',
         name: 'Agent Builder Target Tasks',
         description: 'Use when the user wants the target agent to run something on a recurring schedule (a "task"): a daily/weekly/hourly objective the agent carries out on its own with create_task. Not for one-off requests, chat/event triggers, or config/tool/skill/model edits.',
+        recommendedTools: ['create_task', 'ask_question', 'read_config', 'patch_config'],
+        allowedTools: [
+            'create_task',
+            'ask_question',
+            'read_config',
+            'patch_config',
+            'write_config',
+            'list_workflows',
+            'search_nodes',
+            'get_node_types',
+            'ask_credential',
+        ],
         instructions: `\
 ## Purpose
 

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

@@ -1 +1 @@
-{"version":3,"file":"target-tasks.skill.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/target-tasks.skill.ts"],"names":[],"mappings":";;AAIA,4CA6EC;AA/ED,wEAAiG;AAEjG,SAAgB,gBAAgB;IAC/B,OAAO;QACN,EAAE,EAAE,4BAA4B;QAChC,IAAI,EAAE,4BAA4B;QAClC,WAAW,EACV,mQAAmQ;QACpQ,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;EAqBd,oDAA0B;;EAE1B,iDAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCA8Cc;KACrC,CAAC;AACH,CAAC"}
+{"version":3,"file":"target-tasks.skill.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/target-tasks.skill.ts"],"names":[],"mappings":";;AAIA,4CAyFC;AA3FD,wEAAiG;AAEjG,SAAgB,gBAAgB;IAC/B,OAAO;QACN,EAAE,EAAE,4BAA4B;QAChC,IAAI,EAAE,4BAA4B;QAClC,WAAW,EACV,mQAAmQ;QACpQ,gBAAgB,EAAE,CAAC,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,CAAC;QAChF,YAAY,EAAE;YACb,aAAa;YACb,cAAc;YACd,aAAa;YACb,cAAc;YACd,cAAc;YACd,gBAAgB;YAChB,cAAc;YACd,gBAAgB;YAChB,gBAAgB;SAChB;QACD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;EAqBd,oDAA0B;;EAE1B,iDAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCA8Cc;KACrC,CAAC;AACH,CAAC"}

package/dist/modules/agents/entities/agent-memory-entry.entity.d.ts

@@ -1,5 +1,5 @@
-import { WithTimestampsAndStringId } from '@n8n/db';
 import type { JSONObject } from '@n8n/agents';
+import { WithTimestampsAndStringId } from '@n8n/db';
 export type MemoryEntryStatus = 'active' | 'superseded' | 'dropped';
 export declare class AgentMemoryEntryEntity extends WithTimestampsAndStringId {
     agentId: string;

package/dist/modules/agents/entities/agent-memory-entry.entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-memory-entry.entity.js","sourceRoot":"","sources":["../../../../src/modules/agents/entities/agent-memory-entry.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,gCAAgF;AAChF,0CAAqD;AAU9C,IAAM,sBAAsB,GAA5B,MAAM,sBAAuB,SAAQ,8BAAyB;CA8BpE,CAAA;AA9BY,wDAAsB;AAElC;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;uDACxB;AAGhB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;0DACtB;AAGnB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;uDACT;AAGhB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;2DACpB;AAGpB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;sDACd;AAG1B;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;4DAC5B;AAG5B;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;8DAC3B;AAG9B;IADC,IAAA,eAAU,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yDACJ;AAG3B;IADC,IAAA,eAAU,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;wDACH;AAG5B;IADC,IAAA,mBAAc,GAAE;8BACL,IAAI;0DAAC;iCA7BL,sBAAsB;IALlC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;IACzC,IAAA,eAAK,EAAC,CAAC,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IAC7D,IAAA,eAAK,EAAC,CAAC,SAAS,EAAE,YAAY,EAAE,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACjE,IAAA,eAAK,EAAC,CAAC,YAAY,CAAC,CAAC;IACrB,IAAA,eAAK,EAAC,CAAC,cAAc,CAAC,CAAC;GACX,sBAAsB,CA8BlC"}
+{"version":3,"file":"agent-memory-entry.entity.js","sourceRoot":"","sources":["../../../../src/modules/agents/entities/agent-memory-entry.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,gCAAgF;AAChF,0CAAqD;AAS9C,IAAM,sBAAsB,GAA5B,MAAM,sBAAuB,SAAQ,8BAAyB;CA8BpE,CAAA;AA9BY,wDAAsB;AAElC;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;uDACxB;AAGhB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;0DACtB;AAGnB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;uDACT;AAGhB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;2DACpB;AAGpB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;sDACd;AAG1B;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;4DAC5B;AAG5B;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;8DAC3B;AAG9B;IADC,IAAA,eAAU,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yDACJ;AAG3B;IADC,IAAA,eAAU,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;wDACH;AAG5B;IADC,IAAA,mBAAc,GAAE;8BACL,IAAI;0DAAC;iCA7BL,sBAAsB;IALlC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;IACzC,IAAA,eAAK,EAAC,CAAC,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IAC7D,IAAA,eAAK,EAAC,CAAC,SAAS,EAAE,YAAY,EAAE,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACjE,IAAA,eAAK,EAAC,CAAC,YAAY,CAAC,CAAC;IACrB,IAAA,eAAK,EAAC,CAAC,cAAc,CAAC,CAAC;GACX,sBAAsB,CA8BlC"}

package/dist/modules/agents/entities/agent.entity.d.ts

@@ -1,11 +1,10 @@
-import type { AgentIntegrationConfig, AgentJsonConfig, AgentSkill } from '@n8n/api-types';
 import type { ToolDescriptor } from '@n8n/agents';
+import type { AgentIntegrationConfig, AgentJsonConfig, AgentSkill } from '@n8n/api-types';
 import { Project, WithTimestampsAndStringId } from '@n8n/db';
 import { type Relation } from '@n8n/typeorm';
 import type { AgentHistory } from './agent-history.entity';
 export declare class Agent extends WithTimestampsAndStringId {
     name: string;
-    description: string | null;
     project: Project;
     projectId: string;
     schema: AgentJsonConfig | null;

package/dist/modules/agents/entities/agent.entity.js

@@ -19,10 +19,6 @@ __decorate([
     (0, typeorm_1.Column)({ type: 'varchar', length: 128 }),
     __metadata("design:type", String)
 ], Agent.prototype, "name", void 0);
-__decorate([
-    (0, typeorm_1.Column)({ type: 'varchar', length: 512, nullable: true }),
-    __metadata("design:type", Object)
-], Agent.prototype, "description", void 0);
 __decorate([
     (0, typeorm_1.ManyToOne)(() => db_1.Project, { onDelete: 'CASCADE' }),
     (0, typeorm_1.JoinColumn)({ name: 'projectId' }),

package/dist/modules/agents/entities/agent.entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.entity.js","sourceRoot":"","sources":["../../../../src/modules/agents/entities/agent.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,gCAAyE;AACzE,0CAAoF;AAK7E,IAAM,KAAK,GAAX,MAAM,KAAM,SAAQ,8BAAyB;CA2CnD,CAAA;AA3CY,sBAAK;AAEjB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;mCAC5B;AAGb;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;0CAC9B;AAI3B;IAFC,IAAA,mBAAS,EAAC,GAAG,EAAE,CAAC,YAAO,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjD,IAAA,oBAAU,EAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;8BACzB,YAAO;sCAAC;AAGjB;IADC,IAAA,gBAAM,GAAE;;wCACS;AAGlB;IADC,IAAA,eAAU,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;;qCACf;AAG/B;IADC,IAAA,eAAU,EAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;;2CACS;AAGvC;IADC,IAAA,eAAU,EAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;;oCAO5B;AAGF;IADC,IAAA,eAAU,EAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;;qCACK;AAInC;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;wCAC/B;AAIzB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;8CACzB;AAI/B;IAFC,IAAA,mBAAS,EAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACnE,IAAA,oBAAU,EAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;;4CACM;gBA1ClC,KAAK;IADjB,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;GACd,KAAK,CA2CjB"}
+{"version":3,"file":"agent.entity.js","sourceRoot":"","sources":["../../../../src/modules/agents/entities/agent.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,gCAAyE;AACzE,0CAAoF;AAK7E,IAAM,KAAK,GAAX,MAAM,KAAM,SAAQ,8BAAyB;CAwCnD,CAAA;AAxCY,sBAAK;AAEjB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;mCAC5B;AAIb;IAFC,IAAA,mBAAS,EAAC,GAAG,EAAE,CAAC,YAAO,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjD,IAAA,oBAAU,EAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;8BACzB,YAAO;sCAAC;AAGjB;IADC,IAAA,gBAAM,GAAE;;wCACS;AAGlB;IADC,IAAA,eAAU,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;;qCACf;AAG/B;IADC,IAAA,eAAU,EAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;;2CACS;AAGvC;IADC,IAAA,eAAU,EAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;;oCAO5B;AAGF;IADC,IAAA,eAAU,EAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;;qCACK;AAInC;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;wCAC/B;AAIzB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;8CACzB;AAI/B;IAFC,IAAA,mBAAS,EAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACnE,IAAA,oBAAU,EAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;;4CACM;gBAvClC,KAAK;IADjB,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;GACd,KAAK,CAwCjB"}

package/dist/modules/agents/integrations/agent-chat-bridge.d.ts

@@ -1,7 +1,7 @@
 import type { StreamChunk } from '@n8n/agents';
 import type { Chat } from 'chat';
 import type { Logger } from 'n8n-workflow';
-import type { AgentsService } from '../agents.service';
+import type { AgentExecutionOrchestratorService } from '../agent-execution-orchestrator.service';
 import type { ComponentMapper, ShortenCallback } from './component-mapper';
 import { IntegrationMessageContextService } from './integration-message-context.service';
 import type { AgentIntegrationConfig } from '@n8n/api-types';
@@ -34,13 +34,13 @@ export declare class AgentChatBridge {
     private readonly logger;
     private readonly n8nProjectId;
     private readonly integration;
-    private readonly messageContextStore?;
-    private readonly activeResumedRuns;
     private readonly callbackStore?;
-    private readonly disableStreaming;
     private readonly integrationImpl;
-    constructor(chat: Chat, agentId: string, agentService: AgentExecutor, componentMapper: ComponentMapper, logger: Logger, n8nProjectId: string, integration: AgentIntegrationConfig, messageContextStore?: IntegrationMessageContextService | undefined);
-    static create(chat: Chat, agentId: string, agentService: AgentsService, componentMapper: ComponentMapper, logger: Logger, n8nProjectId: string, integration: AgentIntegrationConfig): AgentChatBridge;
+    private readonly messageContextBridge;
+    private readonly streamConsumer;
+    private readonly hitlResumeHandler;
+    constructor(chat: Chat, agentId: string, agentService: AgentExecutor, componentMapper: ComponentMapper, logger: Logger, n8nProjectId: string, integration: AgentIntegrationConfig, messageContextStore?: IntegrationMessageContextService);
+    static create(chat: Chat, agentId: string, agentService: AgentExecutionOrchestratorService, componentMapper: ComponentMapper, logger: Logger, n8nProjectId: string, integration: AgentIntegrationConfig): AgentChatBridge;
     private registerHandlers;
     dispose(): void;
     private canUserAccess;
@@ -48,27 +48,11 @@ export declare class AgentChatBridge {
     private toAgentThreadId;
     getShortenCallback(): ShortenCallback | undefined;
     private executeAndStream;
-    private consumeStream;
-    private createResponseLifecycle;
-    private consumeStreamBuffered;
+    private resolveBridgeExecutionContext;
     private handleSuspension;
     private handleMessage;
-    private parseActionId;
-    private resolveCallbackData;
-    private cleanUpBeforeResume;
-    private executeResume;
-    private startThinkingStatus;
-    private setSlackAssistantStatus;
-    private clearSlackAssistantStatus;
-    private setSlackAssistantStatusWithRetry;
-    private getSlackThreadContext;
-    private getSlackAssistantStatusAdapter;
-    private updateLatestMessageContext;
     private getPlatformAgentContext;
     private prepareInboundText;
-    private getPreviousContext;
-    private resolveMessageSubject;
-    private handleAction;
     private postErrorToThread;
 }
 export {};