n8n 2.35.4 → 2.36.2

package/dist/modules/agents/builder/agents-builder-prompts.js

@@ -14,7 +14,11 @@ exports.TARGET_AGENT_SECTION = `\
 You are the builder agent, not the target agent.
 The target agent is the AI agent you are configuring for the user. Changes to
 config, tools, memory, integrations, and target-agent skills affect the target
-agent, not your own builder behavior.`;
+agent, not your own builder behavior.
+
+Keep the target agent instructions lightweight: identity, overall purpose, and rules that apply to every operation. Put each distinct or conditional function in its own focused target-agent skill — for example, creating tickets, reviewing images, and generating reports should be separate skills rather than one large instructions block. Infer the right skill boundaries, then create missing skills or update existing ones as part of the build even when the user never calls it a skill. Load \`agent-builder-target-skills\` whenever you design or change how the target agent performs a function.
+
+Scheduled runs inherit these instructions and can use the configured skills. Keep each task objective focused on its run-specific outcome, context, delivery, constraints, and success criteria. Never copy universal instructions or reusable skill procedures into it.`;
 exports.PREREQUISITES_SECTION = `\
 ## Prerequisites you cannot create
 
@@ -163,17 +167,23 @@ exports.WORKFLOW_SECTION = `\
    with the full plan first — even short ones. Mark tasks that cannot
    proceed without user input as \`blocked\`, stating exactly what is
    missing.
-2. For fresh agents, call \`resolve_llm\` once, silently. If it resolves —
-   including an auto-picked provider or newly provisioned free OpenAI
+2. For fresh agents, call \`read_config\` first. If \`model\` and \`credential\` are
+   already set (the system auto-selected a sensible default at creation), keep
+   them and mention the choice as changeable in your summary — do not call
+   \`resolve_llm\`. If \`model\` is empty, call \`resolve_llm\` once, silently. If it
+   resolves — including an auto-picked provider or newly provisioned free OpenAI
    credits — use the result and mention the choice in your summary. If it
    reports missing or ambiguous credentials, mark the model
    task \`blocked\` and keep building: write the config with \`model: ""\` and
    no \`credential\`.
-3. Draft real target-agent \`instructions\` and write the config early; never
+3. Draft lightweight target-agent \`instructions\` containing its identity,
+   overall purpose, and universal rules, then write the config early; never
    write empty placeholders, and never wait for setup answers before writing
    instructions, tools, skills, or tasks.
 4. Load relevant runtime skills before specialized discovery or asset work.
-5. Perform discovery and create any requested tools, skills, or tasks.
+5. Perform discovery and create or update the tools, focused skills, and tasks
+   required by the target agent's functions, whether or not the user named
+   those artifact types explicitly.
 6. Follow Config Freshness immediately before every config mutation.
 7. When both skill and task batches are fully specified, call \`create_skills\`
    and \`create_tasks\` in the same assistant response. Do not combine either
@@ -194,8 +204,10 @@ exports.FEW_SHOT_FLOWS_SECTION = `\
 ## Example flows
 
 ### New agent: "Build me an agent teammates can @mention in Slack to triage messages"
-1. \`write_todos\` with the plan. \`resolve_llm({})\` once, silently; if it
-   reports missing credentials, mark the model task \`blocked\`.
+1. \`write_todos\` with the plan. \`read_config()\` first — if a model and
+   credential are already set (system auto-selected default), keep them and
+   mention the choice as changeable; otherwise \`resolve_llm({})\` once,
+   silently; if it reports missing credentials, mark the model task \`blocked\`.
 2. \`read_config()\`.
 3. \`write_config(...)\` with the instructions, and the resolved model and
    credential — or \`model: ""\` and no \`credential\` while the model task
@@ -229,7 +241,7 @@ exports.FEW_SHOT_FLOWS_SECTION = `\
 4. \`patch_config(...)\` replacing \`/model\` and \`/credential\`.
 
 ### Add an explicitly requested n8n node tool to an existing agent
-1. Load \`agent-builder-external-services\`, then call \`search_nodes\` and
+1. Load \`agent-builder-node-tools\`, then call \`search_nodes\` and
    \`get_node_types\`; the explicit n8n-node request does not need
    \`resolve_integration\`.
 2. \`ask_credential\` for every required slot.
@@ -237,7 +249,7 @@ exports.FEW_SHOT_FLOWS_SECTION = `\
 4. \`patch_config(...)\` adding the node tool to \`/tools/-\`.
 
 ### Add an explicitly requested n8n node tool when credential setup is skipped
-1. Load \`agent-builder-external-services\`, then call \`search_nodes\` and
+1. Load \`agent-builder-node-tools\`, then call \`search_nodes\` and
    \`get_node_types\`.
 2. \`ask_credential(...)\` -> \`{ skipped: true }\`.
 3. \`read_config()\`.
@@ -284,8 +296,8 @@ follow-up for the credential.
    and follow the returned kind:
    - \`kind: "mcp"\`: follow the skill's MCP Servers section — verify and wire
      the MCP server.
-   - \`kind: "node"\`: follow the skill's Node Tools section, use the returned
-     node results with \`get_node_types\`, and ask for every required credential.
+   - \`kind: "node"\`: load \`agent-builder-node-tools\`, use the returned node
+     results with \`get_node_types\`, and ask for every required credential.
 5. In this non-chat branch only, \`read_config()\`, then \`patch_config(...)\` or
    \`write_config(...)\` with the resolved capability.
 

package/dist/modules/agents/builder/agents-builder-prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents-builder-prompts.js","sourceRoot":"","sources":["../../../../src/modules/agents/builder/agents-builder-prompts.ts"],"names":[],"mappings":";;;;;AAAA,6EAA2E;AAC3E,yEAAuE;AACvE,yEAAuE;AACvE,2DAAwD;AACxD,yDAAsD;AAEzC,QAAA,oBAAoB,GAAG;;;;;;sCAME,CAAC;AAE1B,QAAA,qBAAqB,GAAG;;;;;8NAKyL,CAAC;AAE/N,oCAA2C,gBAAwB;IAClE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;kDAyB0C,gBAAgB;;;6BAGrC,gBAAgB;;;;;;gFAMmC,CAAC;AACjF,CAAC;AAEY,QAAA,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA2Dd,CAAC;AAEf,QAAA,6BAA6B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BA4BnB,CAAC;AACd,QAAA,sBAAsB,GAAG;;;;;;;;MAQhC,CAAC;AAEM,QAAA,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAiClB,CAAC;AAEF,QAAA,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iFAsG2C,CAAC;AAOlF,4BAAmC,GAAyB;IAC3D,MAAM,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,GAAG,GAAG,CAAC;IAE9D,MAAM,QAAQ,GAAG;QAChB,6IAA6I;QAC7I,QAAA,oBAAoB;QACpB,QAAA,qBAAqB;QACrB,0BAA0B,CAAC,gBAAgB,CAAC;QAC5C,IAAA,gDAAuB,GAAE;QACzB,IAAA,4CAAqB,EAAC,2BAA2B,CAAC;QAClD,6BAAa;QACb,2BAAY;QACZ,QAAA,yBAAyB;QACzB,4CAAqB;QACrB,QAAA,6BAA6B;QAC7B,QAAA,gBAAgB;QAChB,QAAA,sBAAsB;QACtB,QAAA,sBAAsB;KACtB,CAAC;IAEF,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"agents-builder-prompts.js","sourceRoot":"","sources":["../../../../src/modules/agents/builder/agents-builder-prompts.ts"],"names":[],"mappings":";;;;;AAAA,6EAA2E;AAC3E,yEAAuE;AACvE,yEAAuE;AACvE,2DAAwD;AACxD,yDAAsD;AAEzC,QAAA,oBAAoB,GAAG;;;;;;;;;;yQAUqO,CAAC;AAE7P,QAAA,qBAAqB,GAAG;;;;;8NAKyL,CAAC;AAE/N,oCAA2C,gBAAwB;IAClE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;kDAyB0C,gBAAgB;;;6BAGrC,gBAAgB;;;;;;gFAMmC,CAAC;AACjF,CAAC;AAEY,QAAA,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA2Dd,CAAC;AAEf,QAAA,6BAA6B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BA4BnB,CAAC;AACd,QAAA,sBAAsB,GAAG;;;;;;;;MAQhC,CAAC;AAEM,QAAA,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAuClB,CAAC;AAEF,QAAA,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iFAwG2C,CAAC;AAOlF,4BAAmC,GAAyB;IAC3D,MAAM,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,GAAG,GAAG,CAAC;IAE9D,MAAM,QAAQ,GAAG;QAChB,6IAA6I;QAC7I,QAAA,oBAAoB;QACpB,QAAA,qBAAqB;QACrB,0BAA0B,CAAC,gBAAgB,CAAC;QAC5C,IAAA,gDAAuB,GAAE;QACzB,IAAA,4CAAqB,EAAC,2BAA2B,CAAC;QAClD,6BAAa;QACb,2BAAY;QACZ,QAAA,yBAAyB;QACzB,4CAAqB;QACrB,QAAA,6BAA6B;QAC7B,QAAA,gBAAgB;QAChB,QAAA,sBAAsB;QACtB,QAAA,sBAAsB;KACtB,CAAC;IAEF,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/modules/agents/builder/agents-builder-settings.service.d.ts

@@ -2,6 +2,7 @@ import type { ModelConfig } from '@n8n/agents';
 import { type AgentBuilderAdminSettingsResponse, type AgentBuilderAdminSettingsUpdateRequest } from '@n8n/api-types';
 import { Logger } from '@n8n/backend-common';
 import { OutboundHttp } from '@n8n/backend-network';
+import { GlobalConfig } from '@n8n/config';
 import type { User } from '@n8n/db';
 import { SettingsRepository } from '@n8n/db';
 import { CredentialsFinderService } from '../../../credentials/credentials-finder.service';
@@ -20,11 +21,12 @@ export declare class AgentsBuilderSettingsService {
     private readonly logger;
     private readonly settingsRepository;
     private readonly aiService;
+    private readonly globalConfig;
     private readonly credentialsService;
     private readonly credentialsFinderService;
     private readonly outboundHttp;
     private cached;
-    constructor(logger: Logger, settingsRepository: SettingsRepository, aiService: AiService, credentialsService: CredentialsService, credentialsFinderService: CredentialsFinderService, outboundHttp: OutboundHttp);
+    constructor(logger: Logger, settingsRepository: SettingsRepository, aiService: AiService, globalConfig: GlobalConfig, credentialsService: CredentialsService, credentialsFinderService: CredentialsFinderService, outboundHttp: OutboundHttp);
     private loadSettings;
     private persist;
     getAdminSettings(): Promise<AgentBuilderAdminSettingsResponse>;

package/dist/modules/agents/builder/agents-builder-settings.service.js

@@ -13,6 +13,7 @@ exports.AgentsBuilderSettingsService = void 0;
 const api_types_1 = require("@n8n/api-types");
 const backend_common_1 = require("@n8n/backend-common");
 const backend_network_1 = require("@n8n/backend-network");
+const config_1 = require("@n8n/config");
 const db_1 = require("@n8n/db");
 const di_1 = require("@n8n/di");
 const n8n_workflow_1 = require("n8n-workflow");
@@ -23,7 +24,7 @@ const credentials_service_1 = require("../../../credentials/credentials.service"
 const unprocessable_error_1 = require("../../../errors/response-errors/unprocessable.error");
 const ai_service_1 = require("../../../services/ai.service");
 const proxy_token_manager_1 = require("../../../services/proxy-token-manager");
-const ai_proxy_fetch_1 = require("../../../utils/ai-proxy-fetch");
+const ai_proxy_language_model_1 = require("../../../utils/ai-proxy-language-model");
 const errors_1 = require("./errors");
 const credential_field_mapping_1 = require("../json-config/credential-field-mapping");
 const SETTINGS_KEY = 'agentBuilder.settings';
@@ -32,11 +33,24 @@ function readEnvAnthropicKey() {
     const key = process.env.N8N_AI_ANTHROPIC_KEY ?? process.env.ANTHROPIC_API_KEY;
     return key && key.length > 0 ? key : null;
 }
+function readEnvInstanceAiModelConfig() {
+    const model = process.env.N8N_INSTANCE_AI_MODEL?.trim();
+    const apiKey = process.env.N8N_INSTANCE_AI_MODEL_API_KEY?.trim();
+    if (!model || !model.includes('/') || !apiKey)
+        return null;
+    const modelUrl = process.env.N8N_INSTANCE_AI_MODEL_URL?.trim();
+    const id = model;
+    if (modelUrl) {
+        return { id, url: modelUrl, apiKey };
+    }
+    return { id, apiKey };
+}
 let AgentsBuilderSettingsService = class AgentsBuilderSettingsService {
-    constructor(logger, settingsRepository, aiService, credentialsService, credentialsFinderService, outboundHttp) {
+    constructor(logger, settingsRepository, aiService, globalConfig, credentialsService, credentialsFinderService, outboundHttp) {
         this.logger = logger;
         this.settingsRepository = settingsRepository;
         this.aiService = aiService;
+        this.globalConfig = globalConfig;
         this.credentialsService = credentialsService;
         this.credentialsFinderService = credentialsFinderService;
         this.outboundHttp = outboundHttp;
@@ -77,13 +91,18 @@ let AgentsBuilderSettingsService = class AgentsBuilderSettingsService {
         const settings = await this.loadSettings();
         if (settings.mode === 'custom') {
             const fromCredential = await this.tryResolveCustomCredential(settings);
-            if (fromCredential)
+            if (fromCredential) {
                 return { config: fromCredential, isProxied: false };
+            }
             this.logger.warn('Agent builder custom credential could not be resolved; falling back to default', { credentialId: settings.credentialId });
         }
         if (this.aiService.isProxyEnabled()) {
             return await this.resolveProxyModel(user);
         }
+        const instanceAiEnv = readEnvInstanceAiModelConfig();
+        if (instanceAiEnv) {
+            return { config: instanceAiEnv, isProxied: false };
+        }
         const envKey = readEnvAnthropicKey();
         if (envKey) {
             return {
@@ -104,7 +123,7 @@ let AgentsBuilderSettingsService = class AgentsBuilderSettingsService {
             });
             return null;
         }
-        const credential = await this.credentialsFinderService.findCredentialById(settings.credentialId);
+        const credential = await this.credentialsFinderService.findById(settings.credentialId);
         if (!credential)
             return null;
         const data = await this.credentialsService.decrypt(credential, true);
@@ -115,35 +134,25 @@ let AgentsBuilderSettingsService = class AgentsBuilderSettingsService {
     async resolveProxyModel(user) {
         const client = await this.aiService.getClient();
         const proxyBaseUrl = client.getApiProxyBaseUrl().replace(/\/$/, '');
-        const baseURL = proxyBaseUrl + '/anthropic/v1';
+        const configuredModelId = this.globalConfig.instanceAi.model.trim();
+        const isExactKimi = (0, api_types_1.isMoonshotaiKimiK3ModelId)(configuredModelId);
+        const modelId = isExactKimi ? configuredModelId : api_types_1.AGENT_BUILDER_DEFAULT_MODEL;
         const tokenManager = new proxy_token_manager_1.ProxyTokenManager(async () => {
             return await client.getBuilderApiProxyToken({ id: user.id }, { userMessageId: (0, nanoid_1.nanoid)() });
         });
-        const proxyHeaders = (0, api_types_1.buildProxyHeaders)({
+        const proxyHeaders = {
             feature: 'agent-builder',
             n8nVersion: constants_1.N8N_VERSION,
+        };
+        const model = await (0, ai_proxy_language_model_1.createProxyLanguageModel)({
+            proxyBaseUrl,
+            modelId,
+            tokenManager,
+            feature: proxyHeaders.feature,
+            n8nVersion: proxyHeaders.n8nVersion,
+            outboundHttp: this.outboundHttp,
         });
-        const { createAnthropic } = await import('@ai-sdk/anthropic');
-        const proxyFetch = (0, ai_proxy_fetch_1.createAiProxyFetch)(this.outboundHttp);
-        const provider = createAnthropic({
-            baseURL,
-            apiKey: 'proxy-managed',
-            fetch: async (input, init) => {
-                const headers = new Headers(init?.headers);
-                const auth = await tokenManager.getAuthHeaders();
-                for (const [k, v] of Object.entries(auth)) {
-                    headers.set(k, v);
-                }
-                for (const [k, v] of Object.entries(proxyHeaders)) {
-                    headers.set(k, v);
-                }
-                return await proxyFetch(input, { ...init, headers });
-            },
-        });
-        const model = provider(api_types_1.AGENT_BUILDER_DEFAULT_MODEL);
-        if (!model) {
-            throw new n8n_workflow_1.UnexpectedError('Failed to instantiate Anthropic proxy model');
-        }
+        const tracingHeaders = (0, api_types_1.buildProxyHeaders)(proxyHeaders);
         return {
             config: model,
             isProxied: true,
@@ -151,7 +160,7 @@ let AgentsBuilderSettingsService = class AgentsBuilderSettingsService {
                 apiUrl: proxyBaseUrl + '/langsmith',
                 getAuthHeaders: async () => ({
                     ...(await tokenManager.getAuthHeaders()),
-                    ...proxyHeaders,
+                    ...tracingHeaders,
                 }),
             },
         };
@@ -160,6 +169,6 @@ let AgentsBuilderSettingsService = class AgentsBuilderSettingsService {
 exports.AgentsBuilderSettingsService = AgentsBuilderSettingsService;
 exports.AgentsBuilderSettingsService = AgentsBuilderSettingsService = __decorate([
     (0, di_1.Service)(),
-    __metadata("design:paramtypes", [backend_common_1.Logger, db_1.SettingsRepository, ai_service_1.AiService, credentials_service_1.CredentialsService, credentials_finder_service_1.CredentialsFinderService, backend_network_1.OutboundHttp])
+    __metadata("design:paramtypes", [backend_common_1.Logger, db_1.SettingsRepository, ai_service_1.AiService, config_1.GlobalConfig, credentials_service_1.CredentialsService, credentials_finder_service_1.CredentialsFinderService, backend_network_1.OutboundHttp])
 ], AgentsBuilderSettingsService);
 //# sourceMappingURL=agents-builder-settings.service.js.map

package/dist/modules/agents/builder/agents-builder-settings.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents-builder-settings.service.js","sourceRoot":"","sources":["../../../../src/modules/agents/builder/agents-builder-settings.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agents-builder-settings.service.js","sourceRoot":"","sources":["../../../../src/modules/agents/builder/agents-builder-settings.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,8CAQwB;AACxB,wDAA6C;AAC7C,0DAAoD;AACpD,wCAA2C;AAE3C,gCAA6C;AAC7C,gCAAkC;AAClC,+CAAyC;AACzC,mCAAgC;AAEhC,2CAA0C;AAC1C,yFAAoF;AACpF,2EAAuE;AACvE,sFAAyF;AACzF,sDAAkD;AAClD,wEAAmE;AACnE,6EAA2E;AAE3E,qCAAqD;AACrD,sFAIiD;AAEjD,MAAM,YAAY,GAAG,uBAAuB,CAAC;AAE7C,MAAM,gBAAgB,GAA8B,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAGxE,SAAS,mBAAmB;IAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC9E,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3C,CAAC;AAOD,SAAS,4BAA4B;IACpC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,EAAE,CAAC;IACxD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,6BAA6B,EAAE,IAAI,EAAE,CAAC;IACjE,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAE3D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,IAAI,EAAE,CAAC;IAC/D,MAAM,EAAE,GAAG,KAA8B,CAAC;IAC1C,IAAI,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACtC,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;AACvB,CAAC;AAyBM,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;IAIxC,YACkB,MAAc,EACd,kBAAsC,EACtC,SAAoB,EACpB,YAA0B,EAC1B,kBAAsC,EACtC,wBAAkD,EAClD,YAA0B;QAN1B,WAAM,GAAN,MAAM,CAAQ;QACd,uBAAkB,GAAlB,kBAAkB,CAAoB;QACtC,cAAS,GAAT,SAAS,CAAW;QACpB,iBAAY,GAAZ,YAAY,CAAc;QAC1B,uBAAkB,GAAlB,kBAAkB,CAAoB;QACtC,6BAAwB,GAAxB,wBAAwB,CAA0B;QAClD,iBAAY,GAAZ,YAAY,CAAc;QATpC,WAAM,GAAqC,IAAI,CAAC;IAUrD,CAAC;IAGI,KAAK,CAAC,YAAY;QACzB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC;QACpC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAClE,IAAI,CAAC,GAAG,EAAE,CAAC;YACV,IAAI,CAAC,MAAM,GAAG,gBAAgB,CAAC;YAC/B,OAAO,IAAI,CAAC,MAAM,CAAC;QACpB,CAAC;QAGD,MAAM,GAAG,GAAG,IAAA,wBAAS,EAAU,GAAG,CAAC,KAAK,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;QACxE,MAAM,WAAW,GAAG,2CAA+B,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACnE,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC;QACxE,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,QAAmC;QACxD,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,CACnC;YACC,GAAG,EAAE,YAAY;YACjB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;YAC/B,aAAa,EAAE,IAAI;SACnB,EACD,CAAC,KAAK,CAAC,CACP,CAAC;QACF,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;IACxB,CAAC;IAGD,KAAK,CAAC,gBAAgB;QACrB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC3C,OAAO,EAAE,QAAQ,EAAE,CAAC;IACrB,CAAC;IAWD,KAAK,CAAC,mBAAmB,CAAC,OAA+C;QACxE,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAA,mDAAwB,EAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9E,MAAM,IAAI,+CAAyB,CAClC,yBAAyB,OAAO,CAAC,QAAQ,iBAAiB,oDAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChG,CAAC;QACH,CAAC;QACD,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAYD,KAAK,CAAC,kBAAkB,CAAC,IAAU;QAClC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAE3C,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChC,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAAC,QAAQ,CAAC,CAAC;YACvE,IAAI,cAAc,EAAE,CAAC;gBACpB,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YACrD,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,IAAI,CACf,gFAAgF,EAChF,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,CACvC,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,EAAE,CAAC;YACrC,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,aAAa,GAAG,4BAA4B,EAAE,CAAC;QACrD,IAAI,aAAa,EAAE,CAAC;YACnB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QACpD,CAAC;QAED,MAAM,MAAM,GAAG,mBAAmB,EAAE,CAAC;QACrC,IAAI,MAAM,EAAE,CAAC;YACZ,OAAO;gBACN,MAAM,EAAE;oBACP,EAAE,EAAE,aAAa,uCAA2B,EAAE;oBAC9C,MAAM,EAAE,MAAM;iBACd;gBACD,SAAS,EAAE,KAAK;aAChB,CAAC;QACH,CAAC;QAED,MAAM,IAAI,kCAAyB,EAAE,CAAC;IACvC,CAAC;IAEO,KAAK,CAAC,0BAA0B,CACvC,QAAgE;QAEhE,IAAI,CAAC,IAAA,mDAAwB,EAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wDAAwD,EAAE;gBAC1E,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,YAAY,EAAE,QAAQ,CAAC,YAAY;aACnC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACb,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACvF,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QAE7B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAIrE,MAAM,MAAM,GAAG,IAAA,mDAAwB,EAAC,QAAQ,CAAC,QAAQ,EAAE,IAA0B,CAAC,CAAC;QAEvF,MAAM,EAAE,GAAG,GAAG,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACxD,OAAO,EAAE,EAAE,EAAE,GAAG,MAAM,EAAiB,CAAC;IACzC,CAAC;IAOO,KAAK,CAAC,iBAAiB,CAAC,IAAU;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QAChD,MAAM,YAAY,GAAG,MAAM,CAAC,kBAAkB,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpE,MAAM,iBAAiB,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACpE,MAAM,WAAW,GAAG,IAAA,qCAAyB,EAAC,iBAAiB,CAAC,CAAC;QACjE,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,uCAA2B,CAAC;QAE9E,MAAM,YAAY,GAAG,IAAI,uCAAiB,CAAC,KAAK,IAAI,EAAE;YACrD,OAAO,MAAM,MAAM,CAAC,uBAAuB,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,aAAa,EAAE,IAAA,eAAM,GAAE,EAAE,CAAC,CAAC;QAC3F,CAAC,CAAC,CAAC;QACH,MAAM,YAAY,GAAG;YACpB,OAAO,EAAE,eAAwB;YACjC,UAAU,EAAE,uBAAW;SACvB,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,IAAA,kDAAwB,EAAC;YAC5C,YAAY;YACZ,OAAO;YACP,YAAY;YACZ,OAAO,EAAE,YAAY,CAAC,OAAO;YAC7B,UAAU,EAAE,YAAY,CAAC,UAAU;YACnC,YAAY,EAAE,IAAI,CAAC,YAAY;SAC/B,CAAC,CAAC;QACH,MAAM,cAAc,GAAG,IAAA,6BAAiB,EAAC,YAAY,CAAC,CAAC;QACvD,OAAO;YACN,MAAM,EAAE,KAAK;YACb,SAAS,EAAE,IAAI;YACf,kBAAkB,EAAE;gBACnB,MAAM,EAAE,YAAY,GAAG,YAAY;gBACnC,cAAc,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;oBAC5B,GAAG,CAAC,MAAM,YAAY,CAAC,cAAc,EAAE,CAAC;oBACxC,GAAG,cAAc;iBACjB,CAAC;aACF;SACD,CAAC;IACH,CAAC;CACD,CAAA;;uCAlLY,4BAA4B;IADxC,IAAA,YAAO,GAAE;qCAMiB,uBAAM,EACM,uBAAkB,EAC3B,sBAAS,EACN,qBAAY,EACN,wCAAkB,EACZ,qDAAwB,EACpC,8BAAY;GAXhC,4BAA4B,CAkLxC"}

package/dist/modules/agents/builder/agents-builder-tools.service.js

@@ -75,6 +75,54 @@ const createSkillInputSchema = zod_1.z
         .describe('Markdown-only supporting files under references/... paths. References are not automatically loaded; instructions must say exactly when to load each reference by path.'),
 })
     .strict();
+const readSkillInputSchema = zod_1.z
+    .object({
+    skillId: zod_1.z.string().min(1).describe('Persisted target-agent skill id to read.'),
+    referencePaths: zod_1.z
+        .array(zod_1.z.string().min(1))
+        .max(api_types_1.AGENT_SKILL_REFERENCE_MAX_COUNT)
+        .optional()
+        .describe('Optional reference paths whose content is needed. Omit to receive paths and UTF-8 byte sizes only.'),
+})
+    .strict();
+const updateSkillFieldsSchema = zod_1.z
+    .object({
+    name: api_types_1.agentSkillSchema.shape.name.optional(),
+    description: api_types_1.agentSkillSchema.shape.description.optional(),
+    instructions: api_types_1.agentSkillSchema.shape.instructions.optional(),
+    allowedTools: api_types_1.agentSkillSchema.shape.allowedTools.unwrap().min(1).nullable().optional(),
+    references: api_types_1.agentSkillSchema.shape.references
+        .unwrap()
+        .refine((references) => references.length > 0, 'Pass null to clear references.')
+        .nullable()
+        .optional(),
+})
+    .strict()
+    .refine((updates) => Object.keys(updates).length > 0, {
+    message: 'At least one skill field must be supplied.',
+});
+const updateSkillInputSchema = zod_1.z
+    .object({
+    skillId: zod_1.z.string().min(1).describe('Persisted target-agent skill id to update.'),
+    updates: updateSkillFieldsSchema.describe('Only the fields to change. Pass null for allowedTools or references to remove that field; empty arrays are invalid.'),
+})
+    .strict();
+const updateTaskFieldsSchema = zod_1.z
+    .object({
+    name: api_types_1.agentTaskSchema.shape.name.optional(),
+    objective: api_types_1.agentTaskSchema.shape.objective.optional().describe(task_objective_template_1.TASK_OBJECTIVE_GUIDANCE),
+    cronExpression: api_types_1.agentTaskSchema.shape.cronExpression.optional(),
+})
+    .strict()
+    .refine((updates) => Object.keys(updates).length > 0, {
+    message: 'At least one task field must be supplied.',
+});
+const updateTaskInputSchema = zod_1.z
+    .object({
+    taskId: zod_1.z.string().min(1).describe('Persisted target-agent task id to update.'),
+    updates: updateTaskFieldsSchema.describe('Only the task fields to change.'),
+})
+    .strict();
 function snapshotFromConfig(config) {
     return {
         config,
@@ -598,6 +646,7 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
             }),
             (0, interactive_1.buildAskCredentialTool)({
                 credentialProvider,
+                projectId,
                 isCredentialTypeKnown: (credentialType) => this.credentialTypes.recognizes(credentialType),
                 listIntegrationCredentialIds: async () => {
                     const agent = await this.agentsService.findById(agentId, projectId);
@@ -609,6 +658,7 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
             }),
             (0, interactive_1.buildAskEmbeddingCredentialTool)({
                 credentialProvider,
+                projectId,
                 isCredentialTypeKnown: (credentialType) => this.credentialTypes.recognizes(credentialType),
                 isAssistantProxyEnabled: () => this.aiService.isProxyEnabled(),
                 track,
@@ -735,6 +785,157 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
             }
         })
             .build();
+        const readSkillTool = new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.READ_SKILL)
+            .description('Read an existing target-agent skill by id. The response includes its instructions, but ' +
+            'references are returned as { path, sizeBytes } metadata by default to keep context small. ' +
+            'Pass only the referencePaths whose content you need. Returns { ok: true, id, skill } or ' +
+            '{ ok: false, errors }.')
+            .input(readSkillInputSchema)
+            .handler(async ({ skillId, referencePaths = [] }) => {
+            try {
+                const skill = await this.agentSkillsService.getSkill(agentId, projectId, skillId);
+                const { references, ...body } = skill;
+                const requestedPaths = new Set(referencePaths);
+                const knownPaths = new Set(references?.map((reference) => reference.path) ?? []);
+                const missingPaths = referencePaths.filter((path) => !knownPaths.has(path));
+                if (missingPaths.length > 0) {
+                    return {
+                        ok: false,
+                        errors: [
+                            {
+                                message: `Reference path${missingPaths.length === 1 ? '' : 's'} not found: ${missingPaths.join(', ')}`,
+                            },
+                        ],
+                    };
+                }
+                return {
+                    ok: true,
+                    id: skillId,
+                    skill: {
+                        ...body,
+                        ...(references
+                            ? {
+                                references: references.map((reference) => ({
+                                    path: reference.path,
+                                    sizeBytes: new TextEncoder().encode(reference.content).byteLength,
+                                    ...(requestedPaths.has(reference.path) ? { content: reference.content } : {}),
+                                })),
+                            }
+                            : {}),
+                    },
+                };
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    errors: [{ message: e instanceof Error ? e.message : String(e) }],
+                };
+            }
+        })
+            .build();
+        const listSkillsTool = new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.LIST_SKILLS)
+            .description('List lightweight metadata for persisted target-agent skills. Use this to identify which ' +
+            'existing skill owns a capability before reading or creating a skill. Returns ' +
+            '{ ok: true, skills: [{ id, name, description }] } or { ok: false, errors }.')
+            .input(zod_1.z.object({}).strict())
+            .handler(async () => {
+            try {
+                const skills = await this.agentSkillsService.listSkills(agentId, projectId);
+                return {
+                    ok: true,
+                    skills: Object.entries(skills).map(([id, skill]) => ({
+                        id,
+                        name: skill.name,
+                        description: skill.description,
+                    })),
+                };
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    errors: [{ message: e instanceof Error ? e.message : String(e) }],
+                };
+            }
+        })
+            .build();
+        const updateSkillTool = new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.UPDATE_SKILL)
+            .description('Update selected fields of an existing target-agent skill in place, preserving its id and ' +
+            'agent config reference. Pass null for allowedTools to remove the tool restriction, or null ' +
+            'for references to remove all references; empty arrays are invalid. Returns ' +
+            '{ ok: true, id, name, configMutated: true, agentId } or { ok: false, errors }.')
+            .input(updateSkillInputSchema)
+            .handler(async ({ skillId, updates }) => {
+            const { allowedTools, references, ...requiredUpdates } = updates;
+            const normalizedUpdates = {
+                ...requiredUpdates,
+                ...(allowedTools !== undefined ? { allowedTools: allowedTools ?? undefined } : {}),
+                ...(references !== undefined ? { references: references ?? undefined } : {}),
+            };
+            try {
+                const updated = await this.agentSkillsService.updateSkill(agentId, projectId, skillId, normalizedUpdates, { user, modifiedBy: 'builder' });
+                return { ok: true, id: updated.id, name: updated.skill.name };
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    errors: [{ message: e instanceof Error ? e.message : String(e) }],
+                };
+            }
+        })
+            .build();
+        const listTasksTool = new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.LIST_TASKS)
+            .description('List the target agent scheduled tasks, including each persisted body and whether its ' +
+            'current config reference is enabled. Use this to identify a task before updating it. Returns ' +
+            '{ ok: true, tasks: [{ id, name, objective, cronExpression, enabled }] } or ' +
+            '{ ok: false, errors }.')
+            .input(zod_1.z.object({}).strict())
+            .handler(async () => {
+            try {
+                const agent = await this.agentsService.findById(agentId, projectId);
+                if (!agent)
+                    throw new Error('Agent not found');
+                const tasks = await this.agentTaskService.list(agentId);
+                const enabledByTaskId = new Map(((0, agent_config_composition_1.composeJsonConfig)(agent)?.tasks ?? []).map((task) => [task.id, task.enabled]));
+                return {
+                    ok: true,
+                    tasks: tasks.map(({ id, name, objective, cronExpression }) => ({
+                        id,
+                        name,
+                        objective,
+                        cronExpression,
+                        enabled: enabledByTaskId.get(id) ?? false,
+                    })),
+                };
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    errors: [{ message: e instanceof Error ? e.message : String(e) }],
+                };
+            }
+        })
+            .build();
+        const updateTaskTool = new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.UPDATE_TASK)
+            .description('Update selected body fields of an existing target-agent scheduled task in place, preserving ' +
+            'its id and config reference. Returns { ok: true, id, name, configMutated: true, agentId } ' +
+            'or { ok: false, errors }.')
+            .input(updateTaskInputSchema)
+            .handler(async ({ taskId, updates }) => {
+            try {
+                const updated = await this.agentTaskService.update(agentId, projectId, taskId, updates, {
+                    user,
+                    modifiedBy: 'builder',
+                });
+                return { ok: true, id: updated.id, name: updated.name };
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    errors: [{ message: e instanceof Error ? e.message : String(e) }],
+                };
+            }
+        })
+            .build();
         const createTasksTool = new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.CREATE_TASKS)
             .description('Create one or more recurring scheduled tasks for the target agent (name + objective + cron ' +
             'schedule per task) in a single call. Pass every task you currently know how to write in one ' +
@@ -747,8 +948,9 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
             .systemInstruction('Never create a task with a vague, broad, or placeholder objective, an objective missing any ' +
             'required section, or an unclear schedule. Each objective must follow the required structured ' +
             'Markdown template (Objective, Context, Steps, Output, Constraints, Success criteria) with every ' +
-            'section filled in with concrete content — it is the exact, self-contained message the agent ' +
-            "receives on each unattended run. If anything is ambiguous, derive it from the user's goal as " +
+            'section filled in with concrete, run-specific content. Agent Instructions still apply and ' +
+            'configured Skills remain available during scheduled runs, so never repeat universal rules or ' +
+            "copy reusable procedures into an objective. If anything is ambiguous, derive it from the user's goal as " +
             'stated assumptions listed in your summary; ask the user clarifying questions with ask_questions ' +
             'only when even a reasonable assumption is impossible, before calling ' +
             'create_tasks. A task can only use tools the agent already has: if any step in an objective ' +
@@ -802,7 +1004,12 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
         return [
             buildCustomToolTool,
             createSkillsTool,
+            listSkillsTool,
+            readSkillTool,
+            this.withConfigMutationMarker(updateSkillTool, agentId),
             this.withConfigMutationMarker(createTasksTool, agentId),
+            listTasksTool,
+            this.withConfigMutationMarker(updateTaskTool, agentId),
             listWorkflowsTool,
             (0, get_resource_locator_options_tool_1.buildGetResourceLocatorOptionsTool)({
                 dynamicNodeParametersService: this.dynamicNodeParametersService,