n8n 2.32.5 → 2.33.0

package/dist/modules/agents/builder/interactive/finish-setup.tool.js

@@ -0,0 +1,316 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildFinishSetupTool = buildFinishSetupTool;
+const tool_1 = require("@n8n/agents/tool");
+const api_types_1 = require("@n8n/api-types");
+const telemetry_1 = require("@n8n/telemetry");
+const nanoid_1 = require("nanoid");
+const zod_1 = require("zod");
+const builder_tool_names_1 = require("../builder-tool-names");
+function credentialsOfType(all, credentialType) {
+    return all.filter((c) => c.type === credentialType).map((c) => ({ id: c.id, name: c.name }));
+}
+const finishSetupCredentialRequestInputSchema = zod_1.z.object({
+    credentialType: zod_1.z.string().min(1),
+    purpose: zod_1.z.string().min(1),
+    credentialSlot: zod_1.z.string().optional(),
+});
+const finishSetupChannelInputSchema = zod_1.z.object({
+    integrationType: zod_1.z.string().min(1),
+});
+const finishSetupInputSchema = zod_1.z
+    .object({
+    questions: zod_1.z.array(api_types_1.interactionQuestionSchema).optional(),
+    credentialRequests: zod_1.z.array(finishSetupCredentialRequestInputSchema).optional(),
+    channels: zod_1.z.array(finishSetupChannelInputSchema).optional(),
+})
+    .refine((v) => (v.questions?.length ?? 0) + (v.credentialRequests?.length ?? 0) + (v.channels?.length ?? 0) >
+    0, { message: 'Pass at least one pending setup item.' });
+const credentialOutcomeSchema = zod_1.z.union([
+    zod_1.z.object({ id: zod_1.z.string(), name: zod_1.z.string() }),
+    zod_1.z.literal('skipped'),
+]);
+const channelOutcomeSchema = zod_1.z.union([
+    zod_1.z.literal('connected'),
+    zod_1.z.literal('skipped'),
+    zod_1.z.literal('blocked'),
+]);
+const questionsPhaseSchema = zod_1.z.object({ kind: zod_1.z.literal('questions') });
+const credentialsPhaseSchema = zod_1.z.object({
+    kind: zod_1.z.literal('credentials'),
+    slots: zod_1.z.array(finishSetupCredentialRequestInputSchema),
+});
+const channelPhaseSchema = zod_1.z.object({
+    kind: zod_1.z.literal('channel'),
+    integrationType: zod_1.z.string(),
+});
+const phaseDescriptorSchema = zod_1.z.union([
+    questionsPhaseSchema,
+    credentialsPhaseSchema,
+    channelPhaseSchema,
+]);
+const collectedSchema = zod_1.z.object({
+    answers: zod_1.z.array(api_types_1.questionAnswerSchema).optional(),
+    credentials: zod_1.z.record(credentialOutcomeSchema).optional(),
+    channels: zod_1.z.record(channelOutcomeSchema).optional(),
+});
+const chainStateSchema = zod_1.z.object({
+    currentPhase: phaseDescriptorSchema,
+    remainingPhases: zod_1.z.array(phaseDescriptorSchema),
+    collected: collectedSchema,
+    totalPhases: zod_1.z.number(),
+});
+const finishSetupSuspendSchema = zod_1.z.union([
+    api_types_1.questionsSuspendPayloadSchema.extend({ finishSetupChain: chainStateSchema }),
+    api_types_1.credentialSuspendPayloadSchema.extend({ finishSetupChain: chainStateSchema }),
+    api_types_1.channelSuspendPayloadSchema.extend({ finishSetupChain: chainStateSchema }),
+]);
+const finishSetupResumeSchema = zod_1.z.object({
+    approved: zod_1.z.boolean().optional(),
+    answers: zod_1.z.array(api_types_1.questionAnswerSchema).optional(),
+    credentials: zod_1.z.record(zod_1.z.string()).optional(),
+    skipped: zod_1.z.boolean().optional(),
+});
+function validateCredentialTypes(input, deps) {
+    for (const request of input.credentialRequests ?? []) {
+        if (deps.isCredentialTypeKnown && !deps.isCredentialTypeKnown(request.credentialType)) {
+            throw new Error(`Unknown credential type "${request.credentialType}". Use an exact n8n credential type name.`);
+        }
+    }
+}
+function validateChannelTypes(input, deps) {
+    const availableChannelTypes = deps.listChatIntegrationTypes();
+    for (const channel of input.channels ?? []) {
+        if (!availableChannelTypes.includes(channel.integrationType)) {
+            const availableMessage = availableChannelTypes.length
+                ? ` Available: ${availableChannelTypes.join(', ')}.`
+                : ' No chat channels are currently available.';
+            throw new Error(`Unsupported chat channel "${channel.integrationType}". Call list_integration_types ` +
+                'and choose a returned type.' +
+                availableMessage);
+        }
+    }
+}
+async function computeInitialPlan(input, deps) {
+    validateCredentialTypes(input, deps);
+    validateChannelTypes(input, deps);
+    const collected = {};
+    const pendingSlots = [];
+    if (input.credentialRequests?.length) {
+        const integrationCredentialIds = (await deps.listIntegrationCredentialIds?.()) ?? [];
+        const all = await deps.credentialProvider.list();
+        const credentials = {};
+        for (const slot of input.credentialRequests) {
+            const key = slot.credentialSlot ?? slot.credentialType;
+            const existingCredentials = credentialsOfType(all, slot.credentialType);
+            const channelMatch = existingCredentials.find((credential) => integrationCredentialIds.includes(credential.id));
+            const autoResolved = channelMatch ?? (existingCredentials.length === 1 ? existingCredentials[0] : undefined);
+            if (autoResolved) {
+                credentials[key] = autoResolved;
+            }
+            else {
+                pendingSlots.push(slot);
+            }
+        }
+        if (Object.keys(credentials).length > 0)
+            collected.credentials = credentials;
+    }
+    const phases = [];
+    if (input.questions?.length)
+        phases.push({ kind: 'questions' });
+    if (pendingSlots.length > 0)
+        phases.push({ kind: 'credentials', slots: pendingSlots });
+    for (const channel of input.channels ?? []) {
+        phases.push({ kind: 'channel', integrationType: channel.integrationType });
+    }
+    return { phases, collected };
+}
+async function mergeResumeIntoCollected(phase, resumeData, previous, deps) {
+    if (phase.kind === 'questions') {
+        const answers = resumeData?.answers ?? [];
+        const skippedCount = answers.filter((answer) => answer.skipped === true).length;
+        const hasUsableAnswer = answers.some((answer) => answer.skipped !== true);
+        deps.track(telemetry_1.TELEMETRY_EVENT.AGENTS.USER_ANSWERED_BUILDER_QUESTIONS, {
+            outcome: resumeData?.approved === false ? 'dismissed' : hasUsableAnswer ? 'answered' : 'skipped',
+            answered_count: answers.length - skippedCount,
+            skipped_count: skippedCount,
+        });
+        return { ...previous, answers };
+    }
+    if (phase.kind === 'channel') {
+        const channels = { ...(previous.channels ?? {}) };
+        channels[phase.integrationType] = resumeData?.approved ? 'connected' : 'skipped';
+        if (resumeData?.approved) {
+            deps.track(telemetry_1.TELEMETRY_EVENT.AGENTS.BUILDER_ADDED_TRIGGER, {
+                trigger_type: phase.integrationType,
+            });
+        }
+        return { ...previous, channels };
+    }
+    const all = await deps.credentialProvider.list();
+    const credentials = { ...(previous.credentials ?? {}) };
+    for (const slot of phase.slots) {
+        const key = slot.credentialSlot ?? slot.credentialType;
+        const credentialId = resumeData?.credentials?.[slot.credentialType];
+        deps.track(telemetry_1.TELEMETRY_EVENT.AGENTS.USER_PROVIDED_CREDENTIAL, {
+            credential_type: slot.credentialType,
+            outcome: credentialId ? 'provided' : 'skipped',
+        });
+        credentials[key] = credentialId
+            ? {
+                id: credentialId,
+                name: credentialsOfType(all, slot.credentialType).find((c) => c.id === credentialId)?.name ??
+                    credentialId,
+            }
+            : 'skipped';
+    }
+    return { ...previous, credentials };
+}
+async function checkChannelPublishability(phase, remainingPhases, collected, deps) {
+    if (phase.kind !== 'channel')
+        return undefined;
+    const publishBlockedIssues = await deps.getPublishBlockers();
+    if (publishBlockedIssues.length === 0)
+        return undefined;
+    const channels = { ...(collected.channels ?? {}) };
+    for (const blockedPhase of [phase, ...remainingPhases]) {
+        if (blockedPhase.kind === 'channel')
+            channels[blockedPhase.integrationType] = 'blocked';
+    }
+    return { completed: true, ...collected, channels, publishBlockedIssues };
+}
+async function suspendForPhase(params) {
+    const { phase, remainingPhases, collected, totalPhases, phaseNumber, questions, deps, ctx } = params;
+    const finishSetupChain = {
+        currentPhase: phase,
+        remainingPhases,
+        collected,
+        totalPhases,
+    };
+    const message = `Finish setup (${phaseNumber}/${totalPhases})`;
+    if (phase.kind === 'questions') {
+        deps.track(telemetry_1.TELEMETRY_EVENT.AGENTS.BUILDER_ASKED_QUESTIONS, {
+            question_count: (questions ?? []).length,
+            question_types: [...new Set((questions ?? []).map((q) => q.type))].sort(),
+        });
+        return await ctx.suspend({
+            requestId: (0, nanoid_1.nanoid)(),
+            message,
+            severity: 'info',
+            inputType: 'questions',
+            questions: questions ?? [],
+            finishSetupChain,
+        });
+    }
+    if (phase.kind === 'channel') {
+        return await ctx.suspend({
+            requestId: (0, nanoid_1.nanoid)(),
+            message: `Set up the ${phase.integrationType} channel`,
+            severity: 'info',
+            channelConfig: { integrationType: phase.integrationType, agentId: deps.agentId },
+            projectId: deps.projectId,
+            finishSetupChain,
+        });
+    }
+    const all = await deps.credentialProvider.list();
+    const seenTypes = new Set();
+    const credentialRequests = [];
+    for (const slot of phase.slots) {
+        if (seenTypes.has(slot.credentialType))
+            continue;
+        seenTypes.add(slot.credentialType);
+        deps.track(telemetry_1.TELEMETRY_EVENT.AGENTS.BUILDER_REQUESTED_CREDENTIAL, {
+            credential_type: slot.credentialType,
+        });
+        credentialRequests.push({
+            credentialType: slot.credentialType,
+            reason: slot.purpose,
+            existingCredentials: credentialsOfType(all, slot.credentialType),
+        });
+    }
+    return await ctx.suspend({
+        requestId: (0, nanoid_1.nanoid)(),
+        message,
+        severity: 'info',
+        credentialRequests,
+        credentialFlow: { stage: 'generic' },
+        finishSetupChain,
+    });
+}
+async function startPlan(input, ctx, deps) {
+    const { phases, collected } = await computeInitialPlan(input, deps);
+    if (phases.length === 0) {
+        return { completed: true, ...collected };
+    }
+    const [currentPhase, ...remainingPhases] = phases;
+    const blocked = await checkChannelPublishability(currentPhase, remainingPhases, collected, deps);
+    if (blocked)
+        return blocked;
+    return await suspendForPhase({
+        phase: currentPhase,
+        remainingPhases,
+        collected,
+        totalPhases: phases.length,
+        phaseNumber: 1,
+        questions: input.questions,
+        deps,
+        ctx,
+    });
+}
+async function resumePlan(input, ctx, deps) {
+    const chain = ctx.suspendPayload.finishSetupChain;
+    const collected = await mergeResumeIntoCollected(chain.currentPhase, ctx.resumeData, chain.collected, deps);
+    if (chain.remainingPhases.length === 0) {
+        return { completed: true, ...collected };
+    }
+    const [nextPhase, ...restPhases] = chain.remainingPhases;
+    const blocked = await checkChannelPublishability(nextPhase, restPhases, collected, deps);
+    if (blocked)
+        return blocked;
+    return await suspendForPhase({
+        phase: nextPhase,
+        remainingPhases: restPhases,
+        collected,
+        totalPhases: chain.totalPhases,
+        phaseNumber: chain.totalPhases - restPhases.length,
+        questions: input.questions,
+        deps,
+        ctx,
+    });
+}
+function buildFinishSetupTool(deps) {
+    return new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.FINISH_SETUP)
+        .description('Collect everything still needed to finish the initial build in ONE guided flow: open ' +
+        'questions (including the model choice), credential slots, and chat-channel ' +
+        'connections. Call it at most once, only in the trailing step of an initial build ' +
+        'when only blocked tasks remain, and never together with another interactive tool. ' +
+        'It shows the question and credential cards back-to-back without returning control ' +
+        'between them, then one card per requested channel (always last, since connecting a ' +
+        'channel needs credentials to already be resolved) — but a channel card shows ' +
+        'in-chain only when the agent is already publishable when its phase is reached. Pass ' +
+        '`channels` with a returned `type` from list_integration_types, one entry per channel ' +
+        'to connect; do not infer channel names. Connecting a channel publishes the agent, ' +
+        'and answers/credentials collected by this call are NOT applied to the config ' +
+        'mid-flow — so if the agent still has publish-blocking issues once a channel phase ' +
+        'is reached (expected whenever this same call is still collecting the model or a ' +
+        'required credential), that ' +
+        'phase\'s card is never shown — its outcome is `"blocked"` instead of `"connected"`/' +
+        '`"skipped"`, and the result carries `publishBlockedIssues`. Resolve those issues first ' +
+        '(patch in the credentials/model this same call already collected), then call ' +
+        'configure_channel directly for each blocked channel. Returns ' +
+        '{ completed, answers, credentials, channels, publishBlockedIssues } (plus configMutated/agentId refresh metadata when completed): resolve the model ' +
+        'answer with resolve_llm, copy returned credential ids into the config, and verify MCP ' +
+        'servers with them. Auto-resolves credential slots that match an existing single ' +
+        'credential or the connected channel credential.')
+        .input(finishSetupInputSchema)
+        .suspend(finishSetupSuspendSchema)
+        .resume(finishSetupResumeSchema)
+        .handler(async (input, ctx) => {
+        if (ctx.suspendPayload) {
+            return await resumePlan(input, ctx, deps);
+        }
+        return await startPlan(input, ctx, deps);
+    })
+        .build();
+}
+//# sourceMappingURL=finish-setup.tool.js.map

package/dist/modules/agents/builder/interactive/finish-setup.tool.js.map

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

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

@@ -1,4 +1,5 @@
 export { buildAskCredentialTool, buildAskEmbeddingCredentialTool } from './ask-credential.tool';
 export { buildAskQuestionsTool } from './ask-questions.tool';
 export { buildConfigureChannelTool } from './configure-channel.tool';
+export { buildFinishSetupTool } from './finish-setup.tool';
 export { buildResolveLlmTool } from './resolve-llm.tool';

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildResolveLlmTool = exports.buildConfigureChannelTool = exports.buildAskQuestionsTool = exports.buildAskEmbeddingCredentialTool = exports.buildAskCredentialTool = void 0;
+exports.buildResolveLlmTool = exports.buildFinishSetupTool = exports.buildConfigureChannelTool = exports.buildAskQuestionsTool = exports.buildAskEmbeddingCredentialTool = exports.buildAskCredentialTool = void 0;
 var ask_credential_tool_1 = require("./ask-credential.tool");
 Object.defineProperty(exports, "buildAskCredentialTool", { enumerable: true, get: function () { return ask_credential_tool_1.buildAskCredentialTool; } });
 Object.defineProperty(exports, "buildAskEmbeddingCredentialTool", { enumerable: true, get: function () { return ask_credential_tool_1.buildAskEmbeddingCredentialTool; } });
@@ -8,6 +8,8 @@ var ask_questions_tool_1 = require("./ask-questions.tool");
 Object.defineProperty(exports, "buildAskQuestionsTool", { enumerable: true, get: function () { return ask_questions_tool_1.buildAskQuestionsTool; } });
 var configure_channel_tool_1 = require("./configure-channel.tool");
 Object.defineProperty(exports, "buildConfigureChannelTool", { enumerable: true, get: function () { return configure_channel_tool_1.buildConfigureChannelTool; } });
+var finish_setup_tool_1 = require("./finish-setup.tool");
+Object.defineProperty(exports, "buildFinishSetupTool", { enumerable: true, get: function () { return finish_setup_tool_1.buildFinishSetupTool; } });
 var resolve_llm_tool_1 = require("./resolve-llm.tool");
 Object.defineProperty(exports, "buildResolveLlmTool", { enumerable: true, get: function () { return resolve_llm_tool_1.buildResolveLlmTool; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/interactive/index.ts"],"names":[],"mappings":";;;AAAA,6DAAgG;AAAvF,6HAAA,sBAAsB,OAAA;AAAE,sIAAA,+BAA+B,OAAA;AAChE,2DAA6D;AAApD,2HAAA,qBAAqB,OAAA;AAC9B,mEAAqE;AAA5D,mIAAA,yBAAyB,OAAA;AAClC,uDAAyD;AAAhD,uHAAA,mBAAmB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/interactive/index.ts"],"names":[],"mappings":";;;AAAA,6DAAgG;AAAvF,6HAAA,sBAAsB,OAAA;AAAE,sIAAA,+BAA+B,OAAA;AAChE,2DAA6D;AAApD,2HAAA,qBAAqB,OAAA;AAC9B,mEAAqE;AAA5D,mIAAA,yBAAyB,OAAA;AAClC,yDAA2D;AAAlD,yHAAA,oBAAoB,OAAA;AAC7B,uDAAyD;AAAhD,uHAAA,mBAAmB,OAAA"}

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

@@ -5,8 +5,16 @@ export interface ModelLookup {
         value: string;
     }>>;
 }
+export interface FreeCreditsProvisioner {
+    isEligible(): boolean | Promise<boolean>;
+    claim(): Promise<{
+        credentialId: string;
+        credentialName: string;
+    }>;
+}
 export interface ResolveLlmToolDeps {
     credentialProvider: CredentialProvider;
     modelLookup: ModelLookup;
+    freeCredits: FreeCreditsProvisioner;
 }
 export declare function buildResolveLlmTool(deps: ResolveLlmToolDeps): BuiltTool;

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

@@ -5,7 +5,26 @@ const tool_1 = require("@n8n/agents/tool");
 const model_discovery_1 = require("@n8n/ai-utilities/model-discovery");
 const zod_1 = require("zod");
 const builder_tool_names_1 = require("../builder-tool-names");
-const llm_provider_defaults_1 = require("./llm-provider-defaults");
+const llm_provider_defaults_1 = require("../../llm-provider-defaults");
+const FREE_CREDITS_MODEL = 'gpt-5-mini';
+async function tryClaimFreeCredits(freeCredits) {
+    try {
+        if (!(await freeCredits.isEligible()))
+            return null;
+        const { credentialId, credentialName } = await freeCredits.claim();
+        return {
+            ok: true,
+            provider: 'openai',
+            model: FREE_CREDITS_MODEL,
+            credentialId,
+            credentialName,
+            claimedFreeOpenAiCredits: true,
+        };
+    }
+    catch {
+        return null;
+    }
+}
 function findProviderDefault(provider) {
     const requestedProvider = provider.trim();
     return Object.entries(llm_provider_defaults_1.LLM_PROVIDER_DEFAULTS).find(([, defaults]) => defaults.provider === requestedProvider);
@@ -57,13 +76,23 @@ async function resolveModelAgainstLookup(credential, defaults, requestedModel, m
 function buildResolveLlmTool(deps) {
     return new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.RESOLVE_LLM)
         .description('Resolve the agent main LLM without showing a picker. ' +
-        'Only call this when the user explicitly names a provider or model — do NOT call it ' +
-        'at the start of a conversation or proactively for fresh agents. ' +
+        'For fresh agents, call it once, silently, before the first config write to detect existing ' +
+        'credentials — with provider/model when the user named them, otherwise without arguments. ' +
+        'Also call it whenever the user names or changes a provider or model. ' +
         'If provider is given, resolves only that provider; if model is omitted, uses the ' +
         'provider default model. For "Anthropic via OpenRouter", pass provider="openrouter" ' +
         'and omit model unless the user named a concrete OpenRouter model id. Returns ok=false ' +
-        'when credentials are missing, unsupported, or ambiguous; use ask_questions to let the ' +
-        'user choose, then call resolve_llm again with the choice.')
+        'when credentials are missing, unsupported, or ambiguous — during an initial build, do not ' +
+        'ask; keep building with model "" and include the model choice in the trailing ' +
+        'finish_setup call, then call resolve_llm again with the answer. For a model ' +
+        'change on an existing agent, ask immediately and keep the current model and credential until the new one resolves. ' +
+        'When no matching credential exists and the user is eligible for free OpenAI credits, the tool ' +
+        'claims them automatically and resolves to openai/gpt-5-mini — the result carries ' +
+        'claimedFreeOpenAiCredits: true; tell the user free OpenAI credits were set up. When multiple ' +
+        'providers each have one credential, the tool auto-picks the recommended provider — the result ' +
+        'carries autoPicked: true and otherProviders; state the pick as changeable, do not ask to confirm it. ' +
+        'When the user picks between multiple credentials of one provider, pass the picked credentialId ' +
+        'from the earlier ambiguous result.')
         .input(zod_1.z.object({
         provider: zod_1.z
             .string()
@@ -73,10 +102,34 @@ function buildResolveLlmTool(deps) {
             .string()
             .optional()
             .describe('Requested model without the selected provider prefix. For OpenRouter use the routed id, e.g. "anthropic/claude-sonnet-4.6".'),
+        credentialId: zod_1.z
+            .string()
+            .optional()
+            .describe('Credential id picked by the user from an earlier ambiguous resolve_llm result.'),
     }))
-        .handler(async ({ provider, model }) => {
+        .handler(async ({ provider, model, credentialId, }) => {
         const all = await deps.credentialProvider.list();
         const llmCredentials = all.filter((credential) => llm_provider_defaults_1.LLM_PROVIDER_DEFAULTS[credential.type]);
+        if (credentialId) {
+            const credential = llmCredentials.find((c) => c.id === credentialId);
+            if (!credential) {
+                return {
+                    ok: false,
+                    reason: 'unknown_credential',
+                    credentialId,
+                    credentials: llmCredentials.map((c) => ({
+                        id: c.id,
+                        name: c.name,
+                        type: c.type,
+                    })),
+                };
+            }
+            const defaults = llm_provider_defaults_1.LLM_PROVIDER_DEFAULTS[credential.type];
+            if (model?.trim()) {
+                return await resolveModelAgainstLookup(credential, defaults, model, deps.modelLookup);
+            }
+            return toLlmResolution(credential, defaults);
+        }
         if (provider) {
             const providerEntry = findProviderDefault(provider);
             if (!providerEntry) {
@@ -96,6 +149,13 @@ function buildResolveLlmTool(deps) {
                 }
                 return toLlmResolution(credential, defaults);
             }
+            if (matchingCredentials.length === 0 &&
+                defaults.provider === 'openai' &&
+                !model?.trim()) {
+                const claimed = await tryClaimFreeCredits(deps.freeCredits);
+                if (claimed)
+                    return claimed;
+            }
             return {
                 ok: false,
                 reason: matchingCredentials.length === 0
@@ -117,6 +177,27 @@ function buildResolveLlmTool(deps) {
             }
             return toLlmResolution(credential, defaults);
         }
+        if (llmCredentials.length === 0 && !model?.trim()) {
+            const claimed = await tryClaimFreeCredits(deps.freeCredits);
+            if (claimed)
+                return claimed;
+        }
+        if (llmCredentials.length > 1 && !model?.trim()) {
+            const byProvider = new Map();
+            for (const credential of llmCredentials) {
+                const providerName = llm_provider_defaults_1.LLM_PROVIDER_DEFAULTS[credential.type].provider;
+                byProvider.set(providerName, [...(byProvider.get(providerName) ?? []), credential]);
+            }
+            const topProvider = llm_provider_defaults_1.LLM_PROVIDER_PRIORITY.find((candidate) => byProvider.has(candidate));
+            const topCredentials = topProvider ? byProvider.get(topProvider) : undefined;
+            if (topProvider && topCredentials?.length === 1) {
+                return {
+                    ...toLlmResolution(topCredentials[0], llm_provider_defaults_1.LLM_PROVIDER_DEFAULTS[topCredentials[0].type]),
+                    autoPicked: true,
+                    otherProviders: [...byProvider.keys()].filter((other) => other !== topProvider),
+                };
+            }
+        }
         return {
             ok: false,
             reason: llmCredentials.length === 0

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

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

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

@@ -36,17 +36,18 @@ ${(0, config_rules_prompt_1.getSchemaReferenceSection)()}
 
 ### Recipes
 
-#### Create Or Replace A Fresh Runnable Agent
+#### Create A Fresh Agent Draft
 
-- Requires \`name\`, \`model\`, \`credential\`, and \`instructions\`.
+- Requires \`name\` and \`instructions\`.
+- Use the model and credential from \`resolve_llm\` when resolved; while LLM
+  setup is pending, write \`model: ""\` and omit \`credential\`.
 - Keep \`tools\` and \`skills\` arrays if present.
 
 Good minimal shape:
 \`\`\`json
 {
   "name": "Support assistant",
-  "model": "openrouter/openai/gpt-5.5",
-  "credential": "<main-llm-credential-id>",
+  "model": "",
   "instructions": "Help the user with support questions.",
   "tools": [],
   "skills": []
@@ -141,7 +142,7 @@ Bad: replacing \`config\` while dropping unrelated settings
 - Removing an integration means deleting its entry from \`integrations[]\`; do
   not call \`configure_channel\` for removal.
 - Model-only changes must preserve existing Brave or SearXNG \`config.webSearch\`.
-- Empty, placeholder, or guessed \`instructions\` values are rejected; ask for details instead.
+- Empty or placeholder \`instructions\` values are rejected; derive real instructions from the stated goal instead.
 
 ### Verify
 

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

@@ -1 +1 @@
-{"version":3,"file":"config-mutation.prompt.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/prompts/config-mutation.prompt.ts"],"names":[],"mappings":";;;AAAA,+DAAyF;AAEzF;IACC,OAAO;;;;;;;;;;;;;;;;;;;EAmBN,IAAA,2CAAqB,GAAE;;EAEvB,IAAA,+CAAyB,GAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EAqI+C,CAAC;AAC7E,CAAC"}
+{"version":3,"file":"config-mutation.prompt.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/prompts/config-mutation.prompt.ts"],"names":[],"mappings":";;;AAAA,+DAAyF;AAEzF;IACC,OAAO;;;;;;;;;;;;;;;;;;;EAmBN,IAAA,2CAAqB,GAAE;;EAEvB,IAAA,+CAAyB,GAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EAsI+C,CAAC;AAC7E,CAAC"}

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

@@ -39,15 +39,15 @@ const BuilderPromptMemoryConfigSchema = zod_1.z.object({
     ])
         .optional(),
 });
-const BuilderPromptAgentJsonConfigSchema = api_types_1.RunnableAgentJsonConfigSchema.extend({
+const BuilderPromptAgentJsonConfigSchema = api_types_1.AgentJsonConfigBaseSchema.extend({
     memory: BuilderPromptMemoryConfigSchema.optional(),
 });
 function getConfigRulesSection() {
     return `\
 #### Agent Config Rules
 
-- \`model\` must be "provider/model-name".
-- \`credential\` must be the id returned by \`resolve_llm\`.
+- \`model\` must be "provider/model-name", or \`""\` while LLM setup is pending.
+- A non-empty \`credential\` must be the id returned by \`resolve_llm\`.
 - Sub-agent configuration lives at top level under \`subAgents\`. Load
   \`agent-builder-sub-agents\` before adding refs or changing
   \`subAgents.maxChildren\`.
@@ -59,8 +59,9 @@ function getConfigRulesSection() {
   \`"1h"\`) when the user asks to tune cache duration; OpenAI has no
   sub-config.
 - \`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.`;
+- Fresh agents need real \`instructions\` before config is written. \`model\`
+  may be \`""\` and \`credential\` omitted in a draft while LLM setup is
+  pending; fill both from a \`resolve_llm\` result before publishing.`;
 }
 function getSchemaReferenceSection() {
     const zodSchema = BuilderPromptAgentJsonConfigSchema;

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":";;;;AAAA,8CAAiF;AAGjF,6BAAwB;AACxB,2DAAqD;AAErD,qFAAmF;AAEnF,MAAM,oCAAoC,GAAG,OAAC,CAAC,MAAM,CAAC;IACrD,KAAK,EAAE,4BAAgB;IACvB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACpC,CAAC,CAAC;AAEH,MAAM,+BAA+B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACzB,mBAAmB,EAAE,OAAC;SACpB,MAAM,CAAC;QACP,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC/B,aAAa,EAAE,oCAAoC,CAAC,QAAQ,EAAE;QAC9D,cAAc,EAAE,oCAAoC,CAAC,QAAQ,EAAE;QAC/D,uBAAuB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC3D,wBAAwB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC5D,iBAAiB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QACrD,uBAAuB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC3D,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;KAC7C,CAAC;SACD,QAAQ,EAAE;IACZ,cAAc,EAAE,OAAC;SACf,kBAAkB,CAAC,SAAS,EAAE;QAC9B,OAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,OAAC,CAAC,MAAM,CAAC;YACR,OAAO,EAAE,OAAC,CAAC,OAAO,CAAC,IAAI,CAAC;YACxB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7B,cAAc,EAAE,oCAAoC,CAAC,QAAQ,EAAE;YAC/D,cAAc,EAAE,oCAAoC,CAAC,QAAQ,EAAE;YAC/D,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;YACjD,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;SAC5D,CAAC;KACF,CAAC;SACD,QAAQ,EAAE;CACZ,CAAC,CAAC;AAEH,MAAM,kCAAkC,GAAG,yCAA6B,CAAC,MAAM,CAAC;IAC/E,MAAM,EAAE,+BAA+B,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC;AAEH;IACC,OAAO;;;;;;;;;;;;;;;;;4BAiBoB,CAAC;AAC7B,CAAC;AAED;IACC,MAAM,SAAS,GAA2B,kCAAkC,CAAC;IAC7E,MAAM,cAAc,GAAG,IAAA,gDAAuB,EAAC,IAAA,oCAAe,EAAC,SAAS,CAAgB,CAAC,CAAC;IAC1F,OAAO;;;;EAIN,cAAc;OACT,CAAC;AACR,CAAC"}
+{"version":3,"file":"config-rules.prompt.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/prompts/config-rules.prompt.ts"],"names":[],"mappings":";;;;AAAA,8CAA6E;AAG7E,6BAAwB;AACxB,2DAAqD;AAErD,qFAAmF;AAEnF,MAAM,oCAAoC,GAAG,OAAC,CAAC,MAAM,CAAC;IACrD,KAAK,EAAE,4BAAgB;IACvB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACpC,CAAC,CAAC;AAEH,MAAM,+BAA+B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACzB,mBAAmB,EAAE,OAAC;SACpB,MAAM,CAAC;QACP,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC/B,aAAa,EAAE,oCAAoC,CAAC,QAAQ,EAAE;QAC9D,cAAc,EAAE,oCAAoC,CAAC,QAAQ,EAAE;QAC/D,uBAAuB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC3D,wBAAwB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC5D,iBAAiB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QACrD,uBAAuB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC3D,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;KAC7C,CAAC;SACD,QAAQ,EAAE;IACZ,cAAc,EAAE,OAAC;SACf,kBAAkB,CAAC,SAAS,EAAE;QAC9B,OAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,OAAC,CAAC,MAAM,CAAC;YACR,OAAO,EAAE,OAAC,CAAC,OAAO,CAAC,IAAI,CAAC;YACxB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7B,cAAc,EAAE,oCAAoC,CAAC,QAAQ,EAAE;YAC/D,cAAc,EAAE,oCAAoC,CAAC,QAAQ,EAAE;YAC/D,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;YACjD,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;SAC5D,CAAC;KACF,CAAC;SACD,QAAQ,EAAE;CACZ,CAAC,CAAC;AAEH,MAAM,kCAAkC,GAAG,qCAAyB,CAAC,MAAM,CAAC;IAC3E,MAAM,EAAE,+BAA+B,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC;AAEH;IACC,OAAO;;;;;;;;;;;;;;;;;;sEAkB8D,CAAC;AACvE,CAAC;AAED;IACC,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"}