n8n 2.37.6 → 2.38.1

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

@@ -6,7 +6,7 @@ function subAgentsSkill() {
     return {
         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.',
+        description: 'Use when configuring inline or saved sub-agent delegation for the target agent, selecting same-project sub-agents, or changing subAgents.maxChildren.',
         recommendedTools: ['list_sub_agents', 'ask_questions', 'read_config', 'patch_config'],
         allowedTools: [
             'list_sub_agents',
@@ -30,9 +30,8 @@ The target agent can call \`delegate_subagent\` with \`subAgentId: "inline"\`
 without any saved-agent refs. Inline subagents are ad-hoc child agents for
 one-off focused tasks.
 
-\`subAgents.agents\` is only for optional saved/published n8n Agent specialists
-that the target agent may select by id when they are a better fit than an inline
-subagent.
+\`subAgents.agents\` is only for optional saved n8n Agent specialists that the
+target agent may select by id when they are a better fit than an inline subagent.
 
 ## When to configure
 
@@ -43,19 +42,19 @@ subagent.
   delegated tasks in a run. It is not the same as \`config.toolCallConcurrency\`.
 - Do not create fields such as \`subAgents.maxConcurrentDelegations\`,
   \`delegationConcurrency\`, or \`delegateConcurrency\`.
-- Add saved subagent refs only when the user asks to use specific published
-  agents, reusable specialists, named helper agents, or saved-agent delegation.
+- Add saved subagent refs only when the user asks to use specific agents,
+  reusable specialists, named helper agents, or saved-agent delegation.
 
 ## Saved sub-agent workflow
 
-1. Call \`list_sub_agents\` to discover published same-project agents that can be
-   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,
+1. Call \`list_sub_agents\` to discover same-project agents that can be added.
+   Do not write agent ids from memory, prose, or user-entered free text.
+2. If agents are available and the user has not named exact agents,
    call \`ask_questions\` with one \`type: "multi"\` question whose \`options\`
    are the returned agent names. Map each selected option back to the
    matching \`agentId\` from the \`list_sub_agents\` result.
-3. If no published agents are available, do not configure saved subagents.
-   Inline delegation still works without saved-agent refs.
+3. If no agents are available, do not configure saved subagents. Inline
+   delegation still works without saved-agent refs.
 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." }\`.
@@ -80,6 +79,10 @@ Example patch flow:
 
 ## Rules
 
+- Saved subagents run their current draft in Preview/test runs and their
+  published version in production runs. Delegating to a never-published agent
+  fails in production, so tell the user to publish saved subagents the target
+  agent relies on before production use.
 - 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
@@ -121,7 +124,7 @@ Example shape:
 ## Verify
 
 - Inline delegation still works even when \`subAgents.agents\` is absent.
-- Saved refs use only returned same-project published agent ids.
+- Saved refs use only returned same-project 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":";;;AACA,8CAIwB;AAExB;IACC,OAAO;QACN,EAAE,EAAE,0BAA0B;QAC9B,IAAI,EAAE,0BAA0B;QAChC,WAAW,EACV,iKAAiK;QAClK,gBAAgB,EAAE,CAAC,iBAAiB,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,CAAC;QACrF,YAAY,EAAE;YACb,iBAAiB;YACjB,eAAe;YACf,aAAa;YACb,cAAc;YACd,cAAc;SACd;QACD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;sDAuBsC,sCAA0B,OAAO,sCAA0B,gCAAgC,0CAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qDAqF1H,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":";;;AACA,8CAIwB;AAExB;IACC,OAAO;QACN,EAAE,EAAE,0BAA0B;QAC9B,IAAI,EAAE,0BAA0B;QAChC,WAAW,EACV,uJAAuJ;QACxJ,gBAAgB,EAAE,CAAC,iBAAiB,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,CAAC;QACrF,YAAY,EAAE;YACb,iBAAiB;YACjB,eAAe;YACf,aAAa;YACb,cAAc;YACd,cAAc;SACd;QACD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;sDAsBsC,sCAA0B,OAAO,sCAA0B,gCAAgC,0CAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qDAyF1H,sCAA0B,OAAO,sCAA0B,GAAG;KACjH,CAAC;AACH,CAAC"}

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

@@ -88,9 +88,13 @@ Initial Build rules in your system prompt. Never create a placeholder or
 - For each new or replacement objective, fill every template section with
   run-specific details. Do not duplicate Agent Instructions or Skill bodies;
   name a configured capability only when it helps route the work.
-- Make sure the agent already has every tool the steps need (an integration,
-  node/workflow tool, or web search). If something is missing, add it to the agent
-  config first — a task can only use tools the agent already has.
+- Make sure the agent already has every capability the steps need (an
+  integration, node/workflow tool, or web search). Configured chat integrations
+  automatically generate their context and action tools in scheduled runs too.
+  If the task sends through a configured platform and the integration lists the
+  needed action (for example \`send_dm\`), use that action; do not add a
+  same-platform node, MCP, or workflow tool. Add a tool only when the exact
+  operation is not supplied by an existing integration.
 - Translate each cadence into a valid 5-field cron expression (e.g. daily 09:00
   -> "0 9 * * *"; weekdays 08:30 -> "30 8 * * 1-5"; hourly -> "0 * * * *").
   Keep this cadence out of the objective; only a data lookback window belongs
@@ -125,8 +129,15 @@ Initial Build rules in your system prompt. Never create a placeholder or
 - To disable or remove a task, edit \`config.tasks\` with \`patch_config\` (set
   \`enabled: false\`, or drop the ref). Changes take effect on the next
   \`publish_agent\`.
-- \`create_tasks\` does NOT add tools — if a task needs a tool the agent lacks,
-  add it to the config yourself first.
+- \`create_tasks\` does not add config tools. This does not mean a scheduled
+  message needs a messaging node: configured integrations supply their generated
+  action tools at runtime even when the task has no inbound conversation.
+- A proactive or scheduled send through a connected chat platform is not a
+  separate backend integration. Use the channel's \`send_dm\` or
+  \`send_channel_message\` action when available.
+- Never claim that a task requires a same-platform messaging node solely because
+  it starts without an inbound conversation. If such a redundant tool already
+  exists and the integration covers its action, remove it.
 - Do not call \`create_tasks\` once per task when several are ready; batch them
   into one call so the whole set is stored in a single round trip.`,
     };

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":";;;AAEA,wEAAiG;AAEjG;IACC,OAAO;QACN,EAAE,EAAE,4BAA4B;QAChC,IAAI,EAAE,4BAA4B;QAClC,WAAW,EACV,kMAAkM;QACnM,gBAAgB,EAAE;YACjB,cAAc;YACd,YAAY;YACZ,aAAa;YACb,eAAe;YACf,aAAa;YACb,cAAc;YACd,eAAe;SACf;QACD,YAAY,EAAE;YACb,cAAc;YACd,YAAY;YACZ,aAAa;YACb,eAAe;YACf,aAAa;YACb,cAAc;YACd,cAAc;YACd,gBAAgB;YAChB,cAAc;YACd,gBAAgB;YAChB,gBAAgB;YAChB,eAAe;SACf;QACD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;EAyBd,oDAA0B;;EAE1B,iDAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mEAuE0C;KACjE,CAAC;AACH,CAAC"}
+{"version":3,"file":"target-tasks.skill.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/target-tasks.skill.ts"],"names":[],"mappings":";;;AAEA,wEAAiG;AAEjG;IACC,OAAO;QACN,EAAE,EAAE,4BAA4B;QAChC,IAAI,EAAE,4BAA4B;QAClC,WAAW,EACV,kMAAkM;QACnM,gBAAgB,EAAE;YACjB,cAAc;YACd,YAAY;YACZ,aAAa;YACb,eAAe;YACf,aAAa;YACb,cAAc;YACd,eAAe;SACf;QACD,YAAY,EAAE;YACb,cAAc;YACd,YAAY;YACZ,aAAa;YACb,eAAe;YACf,aAAa;YACb,cAAc;YACd,cAAc;YACd,gBAAgB;YAChB,cAAc;YACd,gBAAgB;YAChB,gBAAgB;YAChB,eAAe;SACf;QACD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;EAyBd,oDAA0B;;EAE1B,iDAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mEAkF0C;KACjE,CAAC;AACH,CAAC"}

package/dist/modules/agents/entities/agent-background-job.entity.d.ts

@@ -0,0 +1,18 @@
+import { WithTimestampsAndStringId } from '@n8n/db';
+export type AgentBackgroundJobKind = 'subagent' | 'workflow';
+export type AgentBackgroundJobStatus = 'running' | 'completed' | 'failed' | 'cancelled';
+export declare class AgentBackgroundJob extends WithTimestampsAndStringId {
+    kind: AgentBackgroundJobKind;
+    status: AgentBackgroundJobStatus;
+    parentAgentId: string;
+    parentThreadId: string;
+    title: string;
+    subAgentId: string | null;
+    childThreadId: string | null;
+    childExecutionId: string | null;
+    workflowId: string | null;
+    timeoutAt: Date | null;
+    result: string | null;
+    error: string | null;
+    settledAt: Date | null;
+}

package/dist/modules/agents/entities/agent-background-job.entity.js

@@ -0,0 +1,78 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentBackgroundJob = void 0;
+const db_1 = require("@n8n/db");
+const typeorm_1 = require("@n8n/typeorm");
+let AgentBackgroundJob = class AgentBackgroundJob extends db_1.WithTimestampsAndStringId {
+};
+exports.AgentBackgroundJob = AgentBackgroundJob;
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 16 }),
+    __metadata("design:type", String)
+], AgentBackgroundJob.prototype, "kind", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 16 }),
+    __metadata("design:type", String)
+], AgentBackgroundJob.prototype, "status", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 36 }),
+    __metadata("design:type", String)
+], AgentBackgroundJob.prototype, "parentAgentId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 128 }),
+    __metadata("design:type", String)
+], AgentBackgroundJob.prototype, "parentThreadId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 255 }),
+    __metadata("design:type", String)
+], AgentBackgroundJob.prototype, "title", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 36, nullable: true }),
+    __metadata("design:type", Object)
+], AgentBackgroundJob.prototype, "subAgentId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 128, nullable: true }),
+    __metadata("design:type", Object)
+], AgentBackgroundJob.prototype, "childThreadId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 36, nullable: true }),
+    __metadata("design:type", Object)
+], AgentBackgroundJob.prototype, "childExecutionId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 36, nullable: true }),
+    __metadata("design:type", Object)
+], AgentBackgroundJob.prototype, "workflowId", void 0);
+__decorate([
+    (0, db_1.DateTimeColumn)({ precision: 3, nullable: true }),
+    __metadata("design:type", Object)
+], AgentBackgroundJob.prototype, "timeoutAt", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], AgentBackgroundJob.prototype, "result", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], AgentBackgroundJob.prototype, "error", void 0);
+__decorate([
+    (0, db_1.DateTimeColumn)({ precision: 3, nullable: true }),
+    __metadata("design:type", Object)
+], AgentBackgroundJob.prototype, "settledAt", void 0);
+exports.AgentBackgroundJob = AgentBackgroundJob = __decorate([
+    (0, typeorm_1.Entity)({ name: 'agent_background_job' }),
+    (0, typeorm_1.Index)(['parentThreadId', 'status']),
+    (0, typeorm_1.Index)(['parentAgentId']),
+    (0, typeorm_1.Index)(['settledAt']),
+    (0, typeorm_1.Index)(['childExecutionId'], { unique: true, where: '"childExecutionId" IS NOT NULL' }),
+    (0, typeorm_1.Index)(['timeoutAt'], { where: '"status" = \'running\'' })
+], AgentBackgroundJob);
+//# sourceMappingURL=agent-background-job.entity.js.map

package/dist/modules/agents/entities/agent-background-job.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-background-job.entity.js","sourceRoot":"","sources":["../../../../src/modules/agents/entities/agent-background-job.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,gCAAoE;AACpE,0CAAqD;AAkB9C,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,8BAAyB;CAiDhE,CAAA;;AA/CA;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;gDACX;AAG7B;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;kDACP;AAGjC;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;yDAClB;AAMtB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;0DAClB;AAIvB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;iDAC3B;AAId;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;sDAC9B;AAI1B;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yDAC5B;AAI7B;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;4DACxB;AAIhC;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;sDAC9B;AAI1B;IADC,IAAA,mBAAc,EAAC,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;qDAC1B;AAIvB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kDACnB;AAGtB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;iDACpB;AAGrB;IADC,IAAA,mBAAc,EAAC,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;qDAC1B;6BAhDX,kBAAkB;IAN9B,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC;IACxC,IAAA,eAAK,EAAC,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;IACnC,IAAA,eAAK,EAAC,CAAC,eAAe,CAAC,CAAC;IACxB,IAAA,eAAK,EAAC,CAAC,WAAW,CAAC,CAAC;IACpB,IAAA,eAAK,EAAC,CAAC,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC;IACtF,IAAA,eAAK,EAAC,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;GAC7C,kBAAkB,CAiD9B"}

package/dist/modules/agents/entities/agent-channel-status.entity.d.ts

@@ -0,0 +1,16 @@
+import { WithTimestamps } from '@n8n/db';
+import { type Relation } from '@n8n/typeorm';
+import { Agent } from './agent.entity';
+export type AgentChannelStatusValue = 'connected' | 'error';
+export declare class AgentChannelStatus extends WithTimestamps {
+    agentId: string;
+    agent: Relation<Agent>;
+    integrationType: string;
+    credentialId: string;
+    hostId: string;
+    status: AgentChannelStatusValue;
+    errorMessage: string | null;
+    attempts: number;
+    backoffUntil: Date | null;
+    expiresAt: Date | null;
+}

package/dist/modules/agents/entities/agent-channel-status.entity.js

@@ -0,0 +1,99 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentChannelStatus = void 0;
+const db_1 = require("@n8n/db");
+const typeorm_1 = require("@n8n/typeorm");
+const agent_entity_1 = require("./agent.entity");
+let AgentChannelStatus = class AgentChannelStatus extends db_1.WithTimestamps {
+};
+exports.AgentChannelStatus = AgentChannelStatus;
+__decorate([
+    (0, typeorm_1.PrimaryColumn)({
+        type: 'varchar',
+        length: 36,
+        comment: 'Agent that owns this channel',
+    }),
+    __metadata("design:type", String)
+], AgentChannelStatus.prototype, "agentId", void 0);
+__decorate([
+    (0, typeorm_1.ManyToOne)(() => agent_entity_1.Agent, { onDelete: 'CASCADE' }),
+    (0, typeorm_1.JoinColumn)({ name: 'agentId' }),
+    __metadata("design:type", Object)
+], AgentChannelStatus.prototype, "agent", void 0);
+__decorate([
+    (0, typeorm_1.PrimaryColumn)({
+        type: 'varchar',
+        length: 64,
+        comment: 'Chat integration platform for this channel',
+    }),
+    __metadata("design:type", String)
+], AgentChannelStatus.prototype, "integrationType", void 0);
+__decorate([
+    (0, typeorm_1.PrimaryColumn)({
+        type: 'varchar',
+        length: 36,
+        comment: 'Credential connection that backs this channel; no FK so a failure is still recordable after the credential is deleted',
+    }),
+    __metadata("design:type", String)
+], AgentChannelStatus.prototype, "credentialId", void 0);
+__decorate([
+    (0, typeorm_1.Index)(),
+    (0, typeorm_1.PrimaryColumn)({
+        type: 'varchar',
+        length: 128,
+        comment: 'Process that observed this; the only writer of this row',
+    }),
+    __metadata("design:type", String)
+], AgentChannelStatus.prototype, "hostId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'varchar',
+        length: 16,
+        comment: 'What this process last observed: connected or error',
+    }),
+    __metadata("design:type", String)
+], AgentChannelStatus.prototype, "status", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'text',
+        nullable: true,
+        comment: 'Why this process could not start the channel; null once it succeeds',
+    }),
+    __metadata("design:type", Object)
+], AgentChannelStatus.prototype, "errorMessage", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'int',
+        default: 0,
+        comment: 'Consecutive failed startup attempts by this process, reset on success',
+    }),
+    __metadata("design:type", Number)
+], AgentChannelStatus.prototype, "attempts", void 0);
+__decorate([
+    (0, db_1.DateTimeColumn)({
+        nullable: true,
+        comment: 'Earliest this process should retry; null when there is nothing to retry',
+    }),
+    __metadata("design:type", Object)
+], AgentChannelStatus.prototype, "backoffUntil", void 0);
+__decorate([
+    (0, typeorm_1.Index)(),
+    (0, db_1.DateTimeColumn)({
+        nullable: true,
+        comment: 'When this row stops counting unless its owner refreshes it; null never expires',
+    }),
+    __metadata("design:type", Object)
+], AgentChannelStatus.prototype, "expiresAt", void 0);
+exports.AgentChannelStatus = AgentChannelStatus = __decorate([
+    (0, typeorm_1.Entity)({ name: 'agent_channel_status' })
+], AgentChannelStatus);
+//# sourceMappingURL=agent-channel-status.entity.js.map

package/dist/modules/agents/entities/agent-channel-status.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-channel-status.entity.js","sourceRoot":"","sources":["../../../../src/modules/agents/entities/agent-channel-status.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,gCAAyD;AACzD,0CAQsB;AAEtB,iDAAuC;AAwBhC,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,mBAAc;CAiFrD,CAAA;;AA3EA;IALC,IAAA,uBAAa,EAAC;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,8BAA8B;KACvC,CAAC;;mDACc;AAIhB;IAFC,IAAA,mBAAS,EAAC,GAAG,EAAE,CAAC,oBAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC/C,IAAA,oBAAU,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;iDACT;AAOvB;IALC,IAAA,uBAAa,EAAC;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,4CAA4C;KACrD,CAAC;;2DACsB;AAQxB;IANC,IAAA,uBAAa,EAAC;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,EAAE;QACV,OAAO,EACN,uHAAuH;KACxH,CAAC;;wDACmB;AASrB;IANC,IAAA,eAAK,GAAE;IACP,IAAA,uBAAa,EAAC;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,yDAAyD;KAClE,CAAC;;kDACa;AAOf;IALC,IAAA,gBAAM,EAAC;QACP,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,qDAAqD;KAC9D,CAAC;;kDAC8B;AAOhC;IALC,IAAA,gBAAM,EAAC;QACP,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,qEAAqE;KAC9E,CAAC;;wDAC0B;AAO5B;IALC,IAAA,gBAAM,EAAC;QACP,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,uEAAuE;KAChF,CAAC;;oDACe;AAUjB;IAJC,IAAA,mBAAc,EAAC;QACf,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,yEAAyE;KAClF,CAAC;;wDACwB;AAe1B;IALC,IAAA,eAAK,GAAE;IACP,IAAA,mBAAc,EAAC;QACf,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,gFAAgF;KACzF,CAAC;;qDACqB;6BAhFX,kBAAkB;IAD9B,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC;GAC5B,kBAAkB,CAiF9B"}

package/dist/modules/agents/instance-ai-builder-delegate.adapter.d.ts

@@ -1,13 +1,13 @@
 import type { CredentialProvider } from '@n8n/agents';
 import type { User } from '@n8n/db';
-import type { InstanceAiBuilderDelegate } from '@n8n/instance-ai';
+import { type InstanceAiBuilderDelegate, type InstanceAiCredentialService } from '@n8n/instance-ai';
 import { AgentConfigService } from './agent-config.service';
 import { AgentSkillsService } from './agent-skills.service';
 import { AgentsService } from './agents.service';
 import { AgentsBuilderService } from './builder/agents-builder.service';
 import { N8nMemory } from './integrations/n8n-memory';
 import { AgentThreadRepository } from './repositories/agent-thread.repository';
-export declare const INSTANCE_AI_BUILDER_ADDENDUM = "## Instance AI session rules\n\nYou are running as a sub-agent inside n8n's instance AI chat; the user sees your questions as chat cards.\n\nPreview links work in this chat. Include a markdown Preview link after a successful build and when `call_agent` reports an unsupported interaction as `approval_required`, using the exact relative path from \"When To Build vs When To Converse\" (form: `[Preview](<path>)`). Do not invent absolute URLs. Do not omit the link and describe the path in plain text instead.\n\nYou can publish and unpublish the target agent with `publish_agent` and `unpublish_agent`. Never tell the user to open the agent editor and click Publish.\n\nThe Instance AI orchestrator can create workflows and data tables \u2014 never ask the user to create them manually. State missing prerequisites in your reply; the orchestrator will provision them and call you again.";
+export declare const INSTANCE_AI_BUILDER_ADDENDUM = "## Instance AI session rules\n\nYou are running as a sub-agent inside n8n's instance AI chat; the user sees your questions as chat cards.\n\nPreview links work in this chat. Include a markdown Preview link after a successful build and when `call_agent` reports an unsupported interaction as `approval_required`, using the exact relative path from \"When To Build vs When To Converse\" (form: `[Preview](<path>)`). Do not invent absolute URLs. Do not omit the link and describe the path in plain text instead.\n\nYou can publish and unpublish the target agent with `publish_agent` and `unpublish_agent`. Never tell the user to open the agent editor and click Publish.\n\nThe Instance AI orchestrator can create workflows and data tables \u2014 never ask the user to create them manually. For each missing artifact, call `report_required_artifact` with its concrete requirements before your final reply; the orchestrator will provision them and call you again when the Agent needs the result.\n\nSome requested chat platforms do not have a native Agent integration. In that case, finish the Agent without adding same-platform messaging nodes as Agent tools, then report an `agent-entrypoint` workflow. It must use the platform trigger, pass the incoming message and a stable conversation identifier into Message an Agent with a custom session key, then send the Agent's text response back through the platform. This workflow invokes the Agent and must never be attached to the Agent as a workflow tool.";
 export declare class InstanceAiBuilderDelegateAdapterService {
     private readonly agentsService;
     private readonly agentsBuilderService;
@@ -17,6 +17,6 @@ export declare class InstanceAiBuilderDelegateAdapterService {
     private readonly agentSkills;
     constructor(agentsService: AgentsService, agentsBuilderService: AgentsBuilderService, n8nMemory: N8nMemory, agentThreadRepository: AgentThreadRepository, agentConfig: AgentConfigService, agentSkills: AgentSkillsService);
     private buildSubAgentSession;
-    createDelegate(user: User, projectId: string, credentialProvider: CredentialProvider): InstanceAiBuilderDelegate;
+    createDelegate(user: User, projectId: string, credentialProvider: CredentialProvider, credentialService: InstanceAiCredentialService): InstanceAiBuilderDelegate;
     deleteBuilderSessions(instanceAiThreadId: string): Promise<void>;
 }

package/dist/modules/agents/instance-ai-builder-delegate.adapter.js

@@ -31,15 +31,21 @@ Preview links work in this chat. Include a markdown Preview link after a success
 
 You can publish and unpublish the target agent with \`publish_agent\` and \`unpublish_agent\`. Never tell the user to open the agent editor and click Publish.
 
-The Instance AI orchestrator can create workflows and data tables — never ask the user to create them manually. State missing prerequisites in your reply; the orchestrator will provision them and call you again.`;
+The Instance AI orchestrator can create workflows and data tables — never ask the user to create them manually. For each missing artifact, call \`report_required_artifact\` with its concrete requirements before your final reply; the orchestrator will provision them and call you again when the Agent needs the result.
+
+Some requested chat platforms do not have a native Agent integration. In that case, finish the Agent without adding same-platform messaging nodes as Agent tools, then report an \`agent-entrypoint\` workflow. It must use the platform trigger, pass the incoming message and a stable conversation identifier into Message an Agent with a custom session key, then send the Agent's text response back through the platform. This workflow invokes the Agent and must never be attached to the Agent as a workflow tool.`;
 function isTextDeltaChunk(chunk) {
     return chunk.type === 'text-delta';
 }
-function toBuilderTurnStream(chunks) {
+function toBuilderTurnStream(chunks, requiredArtifacts) {
     let resolveText;
     const text = new Promise((resolve) => {
         resolveText = resolve;
     });
+    let resolveRequiredArtifacts;
+    const requiredArtifactsPromise = new Promise((resolve) => {
+        resolveRequiredArtifacts = resolve;
+    });
     let acc = '';
     async function* pump() {
         try {
@@ -51,9 +57,10 @@ function toBuilderTurnStream(chunks) {
         }
         finally {
             resolveText(acc);
+            resolveRequiredArtifacts([...requiredArtifacts]);
         }
     }
-    return { fullStream: pump(), text };
+    return { fullStream: pump(), text, requiredArtifacts: requiredArtifactsPromise };
 }
 let InstanceAiBuilderDelegateAdapterService = class InstanceAiBuilderDelegateAdapterService {
     constructor(agentsService, agentsBuilderService, n8nMemory, agentThreadRepository, agentConfig, agentSkills) {
@@ -64,7 +71,7 @@ let InstanceAiBuilderDelegateAdapterService = class InstanceAiBuilderDelegateAda
         this.agentConfig = agentConfig;
         this.agentSkills = agentSkills;
     }
-    buildSubAgentSession(session) {
+    buildSubAgentSession(session, onRequiredArtifact) {
         return {
             threadId: session.threadId,
             hostThreadId: session.hostThreadId,
@@ -75,9 +82,10 @@ let InstanceAiBuilderDelegateAdapterService = class InstanceAiBuilderDelegateAda
             ...(session.memoryTaskObserver ? { memoryTaskObserver: session.memoryTaskObserver } : {}),
             abortSignal: session.abortSignal,
             ...(session.mcpTools ? { mcpTools: session.mcpTools } : {}),
+            onRequiredArtifact,
         };
     }
-    createDelegate(user, projectId, credentialProvider) {
+    createDelegate(user, projectId, credentialProvider, credentialService) {
         const assertProjectScope = async (scope) => {
             if (!(await (0, check_access_1.userHasScopes)(user, [scope], false, { projectId }))) {
                 throw new forbidden_error_1.ForbiddenError('You do not have permission to access agents in this project.');
@@ -94,11 +102,13 @@ let InstanceAiBuilderDelegateAdapterService = class InstanceAiBuilderDelegateAda
             },
             streamBuild: async (agentId, message, session) => {
                 await assertProjectScope('agent:update');
-                return toBuilderTurnStream(this.agentsBuilderService.buildAgent(agentId, projectId, message, credentialProvider, user, this.buildSubAgentSession(session)));
+                const requiredArtifacts = [];
+                return toBuilderTurnStream(this.agentsBuilderService.buildAgent(agentId, projectId, message, credentialProvider, credentialService, user, this.buildSubAgentSession(session, (artifact) => requiredArtifacts.push(artifact))), requiredArtifacts);
             },
             resumeBuild: async (agentId, resume, session) => {
                 await assertProjectScope('agent:update');
-                return toBuilderTurnStream(this.agentsBuilderService.resumeBuild(agentId, projectId, resume.runId, resume.toolCallId, resume.resumeData, credentialProvider, user, this.buildSubAgentSession(session)));
+                const requiredArtifacts = [];
+                return toBuilderTurnStream(this.agentsBuilderService.resumeBuild(agentId, projectId, resume.runId, resume.toolCallId, resume.resumeData, credentialProvider, credentialService, user, this.buildSubAgentSession(session, (artifact) => requiredArtifacts.push(artifact))), requiredArtifacts);
             },
             findOpenSuspensions: async (agentId, session) => {
                 await assertProjectScope('agent:update');

package/dist/modules/agents/instance-ai-builder-delegate.adapter.js.map

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

package/dist/modules/agents/integrations/agent-channel-reconciler.service.d.ts

@@ -0,0 +1,38 @@
+import { Logger } from '@n8n/backend-common';
+import { AgentsConfig } from '@n8n/config';
+import { ErrorReporter, InstanceSettings } from 'n8n-core';
+import { AgentChannelStatusReporter } from './agent-channel-status-reporter';
+import { ChatIntegrationRegistry } from './agent-chat-integration';
+import { ChatIntegrationService } from './chat-integration.service';
+import { AgentChannelStatusRepository } from '../repositories/agent-channel-status.repository';
+import { AgentRepository } from '../repositories/agent.repository';
+export type ChannelReconcileReason = 'startup' | 'leader-takeover' | 'interval';
+export declare class AgentChannelReconciler {
+    private readonly logger;
+    private readonly agentsConfig;
+    private readonly agentRepository;
+    private readonly channelStatusRepository;
+    private readonly statusReporter;
+    private readonly chatIntegrationService;
+    private readonly integrationRegistry;
+    private readonly instanceSettings;
+    private readonly errorReporter;
+    private reconcileInterval;
+    private isInitialized;
+    private isShuttingDown;
+    private inFlight;
+    constructor(logger: Logger, agentsConfig: AgentsConfig, agentRepository: AgentRepository, channelStatusRepository: AgentChannelStatusRepository, statusReporter: AgentChannelStatusReporter, chatIntegrationService: ChatIntegrationService, integrationRegistry: ChatIntegrationRegistry, instanceSettings: InstanceSettings, errorReporter: ErrorReporter);
+    init(): void;
+    shutdown(): Promise<void>;
+    private settleInFlight;
+    reconcileOnLeaderTakeover(): Promise<void>;
+    reconcile(reason: ChannelReconcileReason): Promise<void>;
+    private runPass;
+    private runsHere;
+    private settleWanted;
+    private affirmRunning;
+    private releaseGhosts;
+    private forgetOwnOrphans;
+    private sweepExpired;
+    private refOf;
+}