@codemation/core-nodes 0.10.1 → 0.12.0

package/dist/index.js

@@ -1,9 +1,7 @@
 import { AgentConfigInspector, AgentConnectionNodeCollector, AgentGuardrailDefaults, AgentMessageConfigNormalizer, CallableToolConfig, ChildExecutionScopeFactory, CodemationTelemetryAttributeNames, CodemationTelemetryMetricNames, ConnectionInvocationIdFactory, ConnectionNodeIdFactory, CoreTokens, DefinedNodeRegistry, GenAiTelemetryAttributeNames, InboxChannelResolverToken, ItemExprResolver, ItemsInputNormalizer, NodeBackedToolConfig, NodeOutputNormalizer, RetryPolicy, RunnableOutputBehaviorResolver, SuspensionRequest, WorkflowBuilder, chatModel, defineCredential, defineHumanApprovalNode, defineNode, emitPorts, getOriginIndexFromItem, inject, injectable, isPortsEmission, node } from "@codemation/core";
 import dns from "node:dns/promises";
-import { createOpenAI } from "@ai-sdk/openai";
 import { CredentialResolverFactory } from "@codemation/core/bootstrap";
 import { createHash, createHmac, randomBytes } from "node:crypto";
-import { Output, generateText, jsonSchema } from "ai";
 import { Cron } from "croner";
 
 //#region src/credentials/ApiKeyCredentialType.ts
@@ -495,10 +493,13 @@ var HttpRequestExecutor = class {
 var HttpBodyBuilder = class {
 	async build(spec, item, ctx) {
 		if (!spec || spec.kind === "none") return;
-		if (spec.kind === "json") return {
-			body: JSON.stringify(spec.data),
-			contentType: "application/json"
-		};
+		if (spec.kind === "json") {
+			if (typeof spec.data === "string") throw new Error("HttpRequest body kind:\"json\" expects a serializable object for \"data\", but received a string. Pass the object directly (e.g. { a: 1 }), not a pre-stringified JSON string (JSON.stringify(...)).");
+			return {
+				body: JSON.stringify(spec.data),
+				contentType: "application/json"
+			};
+		}
 		if (spec.kind === "form") {
 			const params = new URLSearchParams();
 			for (const [key, value] of Object.entries(spec.data)) params.append(key, value);
@@ -671,6 +672,7 @@ function __decorate(decorators, target, key, desc) {
 let OpenAIChatModelFactory = class OpenAIChatModelFactory$1 {
 	async create(args) {
 		const session = await args.ctx.getCredential(args.config.credentialSlotKey);
+		const { createOpenAI } = await import("@ai-sdk/openai");
 		return {
 			languageModel: createOpenAI({
 				apiKey: session.apiKey,
@@ -4415,27 +4417,24 @@ function buildHmacAuthHeader(workspaceId, pairingSecret, method, url, body, over
 //#endregion
 //#region src/chatModels/CodemationChatModelFactory.ts
 let CodemationChatModelFactory = class CodemationChatModelFactory$1 {
-	create(args) {
+	async create(args) {
 		const gatewayUrl = process.env["LLM_GATEWAY_URL"];
 		if (!gatewayUrl) throw new Error("Codemation managed AI not available in this environment (LLM_GATEWAY_URL is not set).");
 		const workspaceId = process.env["WORKSPACE_ID"];
 		const pairingSecret = process.env["WORKSPACE_PAIRING_SECRET"];
 		if (!workspaceId || !pairingSecret) throw new Error("Codemation managed AI not available in this environment (workspace pairing is not configured).");
 		const hmacFetch = managedHmacFetchFactory(workspaceId, pairingSecret);
-		const languageModel = createOpenAI({
-			baseURL: `${gatewayUrl}/v1`,
-			apiKey: "codemation-managed",
-			fetch: hmacFetch
-		}).chat(args.config.model);
-		return Promise.resolve({
-			languageModel,
-			modelName: args.config.model,
+		const { createAnthropic } = await import("@ai-sdk/anthropic");
+		return {
+			languageModel: createAnthropic({
+				baseURL: `${gatewayUrl}/v1`,
+				apiKey: "codemation-managed",
+				fetch: hmacFetch
+			})(args.config.complexity),
+			modelName: args.config.complexity,
 			provider: "codemation-managed",
-			defaultCallOptions: {
-				maxOutputTokens: args.config.options?.maxTokens,
-				temperature: args.config.options?.temperature
-			}
-		});
+			defaultCallOptions: { maxOutputTokens: args.config.options?.maxTokens }
+		};
 	}
 };
 CodemationChatModelFactory = __decorate([chatModel({ packageName: "@codemation/core-nodes" })], CodemationChatModelFactory);
@@ -4447,11 +4446,11 @@ var CodemationChatModelConfig = class {
 	presentation;
 	provider = "codemation-managed";
 	modelName;
-	constructor(name, model, presentationIn, options) {
+	constructor(name, complexity, presentationIn, options) {
 		this.name = name;
-		this.model = model;
+		this.complexity = complexity;
 		this.options = options;
-		this.modelName = model;
+		this.modelName = complexity;
 		this.presentation = presentationIn ?? {
 			icon: "lucide:bot",
 			label: name
@@ -4459,28 +4458,6 @@ var CodemationChatModelConfig = class {
 	}
 };
 
-//#endregion
-//#region src/chatModels/ManagedModelFetcher.ts
-/**
-* Fetches the active platform-managed model allowlist from the CP.
-* Reads CONTROL_PLANE_URL from the workspace process env.
-* Returns an empty array if the env var is absent or the fetch fails.
-* Cache the result per session — the allowlist changes infrequently.
-*/
-var ManagedModelFetcher = class {
-	async fetch() {
-		const cpUrl = process.env["CONTROL_PLANE_URL"];
-		if (!cpUrl) return [];
-		try {
-			const res = await globalThis.fetch(`${cpUrl}/api/llm/managed-models`);
-			if (!res.ok) return [];
-			return await res.json();
-		} catch {
-			return [];
-		}
-	}
-};
-
 //#endregion
 //#region src/nodes/AgentMessageFactory.ts
 /**
@@ -5849,6 +5826,63 @@ AgentToolExecutionCoordinator = __decorate([
 	__decorateMetadata("design:paramtypes", [typeof (_ref$2 = typeof AgentToolErrorClassifier !== "undefined" && AgentToolErrorClassifier) === "function" ? _ref$2 : Object, typeof (_ref2$2 = typeof AgentToolRepairPolicy !== "undefined" && AgentToolRepairPolicy) === "function" ? _ref2$2 : Object])
 ], AgentToolExecutionCoordinator);
 
+//#endregion
+//#region src/nodes/AgentBinaryContentFactory.ts
+/**
+* Turns resolved file binaries into native AI SDK multimodal content parts and merges them into the
+* agent prompt. Images (`image/*`) become {@link ImagePart}s; every other type (PDFs, office docs,
+* CSV, JSON, …) becomes a {@link FilePart}. The provider maps these to its wire-level `image` /
+* `document` blocks; an unsupported file type surfaces as a provider error at runtime.
+*
+* Parts are appended to the LAST user message so the binary travels alongside the author's prompt
+* text (preserving any untrusted-source preamble that already wrapped that text). When no user
+* message exists, a new user message carrying only the binaries is appended.
+*/
+var AgentBinaryContentFactory = class AgentBinaryContentFactory {
+	static toContentPart(binary) {
+		if (binary.mediaType.startsWith("image/")) return {
+			type: "image",
+			image: binary.base64,
+			mediaType: binary.mediaType
+		};
+		return {
+			type: "file",
+			data: binary.base64,
+			mediaType: binary.mediaType,
+			...binary.filename ? { filename: binary.filename } : {}
+		};
+	}
+	static withBinaries(messages, binaries) {
+		if (binaries.length === 0) return messages;
+		const parts = binaries.map((binary) => AgentBinaryContentFactory.toContentPart(binary));
+		const lastUserIndex = AgentBinaryContentFactory.lastUserMessageIndex(messages);
+		if (lastUserIndex === -1) {
+			const appended = {
+				role: "user",
+				content: parts
+			};
+			return [...messages, appended];
+		}
+		const next = [...messages];
+		next[lastUserIndex] = AgentBinaryContentFactory.appendPartsToUserMessage(messages[lastUserIndex], parts);
+		return next;
+	}
+	static lastUserMessageIndex(messages) {
+		for (let index = messages.length - 1; index >= 0; index--) if (messages[index]?.role === "user") return index;
+		return -1;
+	}
+	static appendPartsToUserMessage(message, parts) {
+		const existing = typeof message.content === "string" ? message.content.length > 0 ? [{
+			type: "text",
+			text: message.content
+		}] : [] : message.content;
+		return {
+			...message,
+			content: [...existing, ...parts]
+		};
+	}
+};
+
 //#endregion
 //#region src/nodes/NodeBackedToolRuntime.ts
 var _ref$1, _ref2$1, _ref3$1, _ref4$1;
@@ -6047,11 +6081,18 @@ var DeferredMetaToolStrategy = class {
 	mcpEntries = [];
 	toolsByServerId = /* @__PURE__ */ new Map();
 	foundToolIds = /* @__PURE__ */ new Set();
+	/**
+	* `jsonSchema` from the `ai` SDK, loaded lazily in {@link initialize} so the SDK
+	* (~28MB RSS) stays off the boot path. `initialize` always runs before the sync
+	* `getToolsForTurn` → `buildFindToolsDefinition` path, so this is set before use.
+	*/
+	jsonSchema;
 	constructor(bm25, warnFn) {
 		this.bm25 = bm25;
 		this.warnFn = warnFn;
 	}
 	async initialize(input) {
+		this.jsonSchema = (await import("ai")).jsonSchema;
 		this.nodeBackedTools = { ...input.nodeBackedTools };
 		const pinnedIds = input.pinnedMcpTools ?? [];
 		if (pinnedIds.length > PINNED_TOOLS_HARD_LIMIT) throw new Error(`Agent config error: pinnedMcpTools count (${pinnedIds.length}) exceeds hard limit of ${PINNED_TOOLS_HARD_LIMIT}.`);
@@ -6139,25 +6180,26 @@ var DeferredMetaToolStrategy = class {
 		return [...this.foundToolIds];
 	}
 	buildFindToolsDefinition() {
+		const inputSchemaRecord = {
+			type: "object",
+			properties: {
+				query: {
+					type: "string",
+					description: "Natural language description of what you want to do."
+				},
+				limit: {
+					type: "integer",
+					minimum: 1,
+					maximum: 10,
+					description: `Maximum number of tools to return (default ${FIND_TOOLS_DEFAULT_LIMIT}).`
+				}
+			},
+			required: ["query"],
+			additionalProperties: false
+		};
 		return {
 			description: "Search for tools available from connected MCP servers. After this call, the tools listed in the result will be callable on your very next turn. Use this when you need a capability not visible in your current tool list. Do not attempt to call a tool name you have not seen yet — use find_tools to discover it first.",
-			inputSchema: jsonSchema({
-				type: "object",
-				properties: {
-					query: {
-						type: "string",
-						description: "Natural language description of what you want to do."
-					},
-					limit: {
-						type: "integer",
-						minimum: 1,
-						maximum: 10,
-						description: `Maximum number of tools to return (default ${FIND_TOOLS_DEFAULT_LIMIT}).`
-					}
-				},
-				required: ["query"],
-				additionalProperties: false
-			})
+			inputSchema: this.jsonSchema(inputSchemaRecord)
 		};
 	}
 };
@@ -6191,6 +6233,13 @@ let AIAgentNode = class AIAgentNode$1 {
 	inputSchema = unknown();
 	connectionCredentialExecutionContextFactory;
 	preparedByExecutionContext = /* @__PURE__ */ new WeakMap();
+	/**
+	* The `ai` SDK, loaded lazily in {@link execute} so the SDK (~28MB RSS) stays
+	* off the boot path — non-AI workflows never load it. Every path runs through
+	* `execute` → `ensureAiSdk` before any sync helper touches `this.aiSdk`.
+	*/
+	aiSdk;
+	aiSdkPromise = null;
 	constructor(nodeResolver, credentialSessions, nodeBackedToolRuntime, executionHelpers, structuredOutputRunner, toolExecutionCoordinator, toolLoadingStrategyFactory, agentMcpIntegration) {
 		this.nodeResolver = nodeResolver;
 		this.nodeBackedToolRuntime = nodeBackedToolRuntime;
@@ -6203,6 +6252,7 @@ let AIAgentNode = class AIAgentNode$1 {
 	}
 	async execute(args) {
 		const { ctx } = args;
+		await this.ensureAiSdk();
 		if (ctx.resumeContext) return this.executeResumed(args, ctx.resumeContext);
 		const prepared = await this.getOrPrepareExecution(ctx);
 		const itemWithMappedJson = {
@@ -6211,6 +6261,10 @@ let AIAgentNode = class AIAgentNode$1 {
 		};
 		return (await this.runAgentForItem(prepared, itemWithMappedJson, args.itemIndex, args.items)).json;
 	}
+	/** Load the `ai` SDK once per node instance (cached promise guards concurrent items). */
+	async ensureAiSdk() {
+		this.aiSdk = await (this.aiSdkPromise ??= import("ai"));
+	}
 	/**
 	* Resume path: re-enters the agent loop after a HITL suspension.
 	* Reconstructs the conversation from the checkpoint, injects the human decision
@@ -6353,7 +6407,7 @@ let AIAgentNode = class AIAgentNode$1 {
 		const { ctx } = prepared;
 		const itemInputsByPort = AgentItemPortMap.fromItem(item);
 		const itemScopedTools = this.createItemScopedTools(prepared.resolvedTools, ctx, item, itemIndex, items);
-		const conversation = [...this.createPromptMessages(item, itemIndex, items, ctx)];
+		const conversation = [...await this.createPromptMessages(item, itemIndex, items, ctx)];
 		if (ctx.config.outputSchema && itemScopedTools.length === 0) {
 			const structuredOutput = await this.structuredOutputRunner.resolve({
 				model: prepared.model,
@@ -6540,14 +6594,17 @@ let AIAgentNode = class AIAgentNode$1 {
 		});
 	}
 	/**
-	* Detects whether a tool config is backed by a `defineHumanApprovalNode` marker
-	* and returns the HITL behavior config, or `undefined` when not a HITL tool.
+	* Resolves the HITL behavior for a tool binding, or `undefined` when it is not a HITL tool.
+	* A binding is HITL if either the backing node carries a `defineHumanApprovalNode` marker or the
+	* binding sets a per-binding `onRejected` via `asTool(..., { onRejected })`. The per-binding value
+	* wins over the node marker, so two tools backed by the same node can reject differently.
 	*/
 	resolveHumanApprovalBehavior(config$1) {
 		if (!this.isNodeBackedToolConfig(config$1)) return void 0;
 		const marker = config$1.node.humanApprovalToolBehavior;
-		if (marker === void 0) return void 0;
-		return { onRejected: marker.onRejected ?? "return" };
+		const perBinding = config$1.onRejected;
+		if (marker === void 0 && perBinding === void 0) return void 0;
+		return { onRejected: perBinding ?? marker?.onRejected ?? "return" };
 	}
 	/**
 	* Invoke a text turn using the merged tool set from item-scoped tools (coordinator-managed)
@@ -6594,7 +6651,7 @@ let AIAgentNode = class AIAgentNode$1 {
 			const description = this.resolveHumanApprovalBehavior(entry.config) !== void 0 ? `${baseDescription} ${HITL_SOLO_CONSTRAINT_SENTENCE}` : baseDescription;
 			toolSet[entry.config.name] = {
 				description,
-				inputSchema: jsonSchema(schemaRecord)
+				inputSchema: this.aiSdk.jsonSchema(schemaRecord)
 			};
 		}
 		return toolSet;
@@ -6625,7 +6682,7 @@ let AIAgentNode = class AIAgentNode$1 {
 			const description = entry.humanApproval !== void 0 && baseDescription !== void 0 ? `${baseDescription} ${HITL_SOLO_CONSTRAINT_SENTENCE}` : entry.humanApproval !== void 0 ? HITL_SOLO_CONSTRAINT_SENTENCE : baseDescription;
 			toolSet[entry.config.name] = {
 				description,
-				inputSchema: jsonSchema(schemaRecord)
+				inputSchema: this.aiSdk.jsonSchema(schemaRecord)
 			};
 		}
 		return toolSet;
@@ -6677,7 +6734,7 @@ let AIAgentNode = class AIAgentNode$1 {
 		});
 		try {
 			const callOptions = this.resolveCallOptions(model, guardrails.modelInvocationOptions);
-			const result = await generateText({
+			const result = await this.aiSdk.generateText({
 				model: model.languageModel,
 				messages: [...messages],
 				tools,
@@ -6796,8 +6853,8 @@ let AIAgentNode = class AIAgentNode$1 {
 				schemaName: structuredOptions?.schemaName ?? "structured_output",
 				requireObjectRoot: true
 			}) : schema;
-			const outputSchema = Output.object({ schema: jsonSchema(schemaRecord) });
-			const result = await generateText({
+			const outputSchema = this.aiSdk.Output.object({ schema: this.aiSdk.jsonSchema(schemaRecord) });
+			const result = await this.aiSdk.generateText({
 				model: model.languageModel,
 				messages: [...messages],
 				experimental_output: outputSchema,
@@ -7068,7 +7125,7 @@ let AIAgentNode = class AIAgentNode$1 {
 		const json = JSON.stringify(value);
 		return JSON.parse(json);
 	}
-	createPromptMessages(item, itemIndex, items, ctx) {
+	async createPromptMessages(item, itemIndex, items, ctx) {
 		const messages = AgentMessageConfigNormalizer.resolveFromInputOrConfig(item.json, ctx.config, {
 			item,
 			itemIndex,
@@ -7076,7 +7133,47 @@ let AIAgentNode = class AIAgentNode$1 {
 			ctx
 		});
 		const wrapped = this.wrapUntrustedSourceMessages(messages, item, ctx.config);
-		return AgentMessageFactory.createPromptMessages(wrapped);
+		const promptMessages = AgentMessageFactory.createPromptMessages(wrapped);
+		if (ctx.config.passBinariesToModel === false) return promptMessages;
+		const attachments = this.selectBinaryAttachments(item, itemIndex, items, ctx);
+		const binaries = await this.resolveInlineBinaries(attachments, ctx);
+		return AgentBinaryContentFactory.withBinaries(promptMessages, binaries);
+	}
+	/**
+	* Picks which attachments feed the passdown. When the author supplies `config.binaries`
+	* (a static array or a per-item function — e.g. to forward binaries from an earlier node),
+	* those replace the current item's attachments; otherwise the current item's `item.binary`
+	* is used.
+	*/
+	selectBinaryAttachments(item, itemIndex, items, ctx) {
+		const manual = ctx.config.binaries;
+		if (manual !== void 0) return typeof manual === "function" ? manual({
+			item,
+			itemIndex,
+			items,
+			ctx
+		}) : manual;
+		return item.binary ? Object.values(item.binary) : [];
+	}
+	/**
+	* Reads every attachment through `ctx.binary` (storage-backed, by reference — never base64 on
+	* `item.json`) and resolves it to inline base64 so the agent can pass it to the chat model as a
+	* native multimodal block. Images become image blocks; every other type (PDF, office docs, CSV,
+	* JSON, …) becomes a file block — we don't filter by media type, so any binary can be fed to the
+	* model. If the provider rejects an unsupported type the error surfaces at runtime, and the
+	* workflow can filter the binary upstream.
+	*/
+	async resolveInlineBinaries(attachments, ctx) {
+		const resolved = [];
+		for (const attachment of attachments) {
+			const bytes = await ctx.binary.getBytes(attachment);
+			resolved.push({
+				mediaType: attachment.mimeType,
+				base64: Buffer.from(bytes).toString("base64"),
+				...attachment.filename ? { filename: attachment.filename } : {}
+			});
+		}
+		return resolved;
 	}
 	/**
 	* When `item.json.__source` matches an entry in `config.untrustedSources`
@@ -7190,6 +7287,7 @@ var AIAgent = class {
 	chatModel;
 	tools;
 	id;
+	description;
 	retryPolicy;
 	guardrails;
 	inputSchema;
@@ -7197,12 +7295,15 @@ var AIAgent = class {
 	mcpServers;
 	pinnedMcpTools;
 	untrustedSources;
+	passBinariesToModel;
+	binaries;
 	constructor(options) {
 		this.name = options.name;
 		this.messages = options.messages;
 		this.chatModel = options.chatModel;
 		this.tools = options.tools ?? [];
 		this.id = options.id;
+		this.description = options.description;
 		this.retryPolicy = options.retryPolicy ?? RetryPolicy.defaultForAiAgent;
 		this.guardrails = options.guardrails;
 		this.inputSchema = options.inputSchema;
@@ -7210,6 +7311,8 @@ var AIAgent = class {
 		this.mcpServers = options.mcpServers;
 		this.pinnedMcpTools = options.pinnedMcpTools;
 		this.untrustedSources = options.untrustedSources;
+		this.passBinariesToModel = options.passBinariesToModel;
+		this.binaries = options.binaries;
 	}
 	inspectorSummary() {
 		const rows = [];
@@ -7280,12 +7383,14 @@ var Assertion = class {
 	icon;
 	name;
 	id;
+	description;
 	emitsAssertions = true;
 	assertions;
 	constructor(options) {
 		this.name = options.name ?? "Assertion";
 		this.id = options.id;
 		this.icon = options.icon ?? "lucide:check-circle";
+		this.description = options.description;
 		this.assertions = options.assertions;
 	}
 	inspectorSummary() {
@@ -7337,6 +7442,7 @@ var Callback = class Callback {
 	icon = "lucide:braces";
 	emptyBatchExecution = "runOnce";
 	id;
+	description;
 	retryPolicy;
 	nodeErrorHandler;
 	declaredOutputPorts;
@@ -7348,6 +7454,7 @@ var Callback = class Callback {
 			id: idOrOptions
 		} : idOrOptions;
 		this.id = resolvedOptions?.id;
+		this.description = resolvedOptions?.description;
 		this.retryPolicy = resolvedOptions?.retryPolicy;
 		this.nodeErrorHandler = resolvedOptions?.nodeErrorHandler;
 		this.declaredOutputPorts = resolvedOptions?.declaredOutputPorts;
@@ -7549,10 +7656,12 @@ var HttpRequest = class {
 	type = HttpRequestNode;
 	execution = { hint: "local" };
 	icon = "lucide:globe";
+	description;
 	constructor(name, args = {}, retryPolicy = RetryPolicy.defaultForHttp) {
 		this.name = name;
 		this.args = args;
 		this.retryPolicy = retryPolicy;
+		this.description = args.description;
 	}
 	get id() {
 		return this.args.id;
@@ -7647,10 +7756,14 @@ var Aggregate = class {
 	execution = { hint: "local" };
 	keepBinaries = true;
 	icon = "builtin:aggregate-rows";
-	constructor(name, aggregate, id) {
+	id;
+	description;
+	constructor(name, aggregate, idOrOptions) {
 		this.name = name;
 		this.aggregate = aggregate;
-		this.id = id;
+		const options = typeof idOrOptions === "string" ? { id: idOrOptions } : idOrOptions;
+		this.id = options?.id;
+		this.description = options?.description;
 	}
 	inspectorSummary() {
 		const fnName = this.aggregate.name;
@@ -7681,10 +7794,14 @@ var Filter = class {
 	type = FilterNode;
 	execution = { hint: "local" };
 	icon = "lucide:filter";
-	constructor(name, predicate, id) {
+	id;
+	description;
+	constructor(name, predicate, idOrOptions) {
 		this.name = name;
 		this.predicate = predicate;
-		this.id = id;
+		const options = typeof idOrOptions === "string" ? { id: idOrOptions } : idOrOptions;
+		this.id = options?.id;
+		this.description = options?.description;
 	}
 	inspectorSummary() {
 		const fnName = this.predicate.name;
@@ -7759,10 +7876,14 @@ var If = class {
 	execution = { hint: "local" };
 	icon = "lucide:split@rot=90";
 	declaredOutputPorts = ["true", "false"];
-	constructor(name, predicate, id) {
+	id;
+	description;
+	constructor(name, predicate, idOrOptions) {
 		this.name = name;
 		this.predicate = predicate;
-		this.id = id;
+		const options = typeof idOrOptions === "string" ? { id: idOrOptions } : idOrOptions;
+		this.id = options?.id;
+		this.description = options?.description;
 	}
 	inspectorSummary() {
 		const fnName = this.predicate.name;
@@ -7802,9 +7923,12 @@ var IsTestRun = class {
 	declaredOutputPorts = ["true", "false"];
 	name;
 	id;
-	constructor(name = "Is test run?", id) {
+	description;
+	constructor(name = "Is test run?", idOrOptions) {
 		this.name = name;
-		this.id = id;
+		const options = typeof idOrOptions === "string" ? { id: idOrOptions } : idOrOptions;
+		this.id = options?.id;
+		this.description = options?.description;
 	}
 };
 
@@ -7833,11 +7957,15 @@ var Switch = class {
 	execution = { hint: "local" };
 	icon = "lucide:git-branch-plus";
 	declaredOutputPorts;
-	constructor(name, cfg, id) {
+	id;
+	description;
+	constructor(name, cfg, idOrOptions) {
 		this.name = name;
 		this.cfg = cfg;
-		this.id = id;
 		this.declaredOutputPorts = [...new Set([...cfg.cases, cfg.defaultCase])].sort();
+		const options = typeof idOrOptions === "string" ? { id: idOrOptions } : idOrOptions;
+		this.id = options?.id;
+		this.description = options?.description;
 	}
 	inspectorSummary() {
 		const rows = [{
@@ -7876,10 +8004,14 @@ var Split = class {
 	*/
 	continueWhenEmptyOutput = true;
 	icon = "builtin:split-rows";
-	constructor(name, getElements, id) {
+	id;
+	description;
+	constructor(name, getElements, idOrOptions) {
 		this.name = name;
 		this.getElements = getElements;
-		this.id = id;
+		const options = typeof idOrOptions === "string" ? { id: idOrOptions } : idOrOptions;
+		this.id = options?.id;
+		this.description = options?.description;
 	}
 	inspectorSummary() {
 		const fnName = this.getElements.name;
@@ -7937,14 +8069,17 @@ var CronTrigger = class {
 	type = CronTriggerNode;
 	icon = "lucide:clock";
 	id;
-	constructor(name, args, id) {
+	description;
+	constructor(name, args, idOrOptions) {
 		this.name = name;
 		this.args = args;
 		new Cron(args.schedule, {
 			paused: true,
 			timezone: args.timezone
 		});
-		this.id = id;
+		const options = typeof idOrOptions === "string" ? { id: idOrOptions } : idOrOptions;
+		this.id = options?.id;
+		this.description = options?.description;
 	}
 	get schedule() {
 		return this.args.schedule;
@@ -7998,20 +8133,21 @@ var ManualTrigger = class ManualTrigger {
 	icon = "lucide:play";
 	defaultItems;
 	id;
+	description;
 	/** Manual runs often emit an empty batch; still schedule downstream by default. */
 	continueWhenEmptyOutput = true;
-	constructor(name = "Manual trigger", defaultItemsOrId, id) {
+	constructor(name = "Manual trigger", defaultItemsOrId, idOrOptions) {
 		this.name = name;
 		this.defaultItems = ManualTrigger.resolveDefaultItems(defaultItemsOrId);
-		this.id = ManualTrigger.resolveId(defaultItemsOrId, id);
+		const trailing = idOrOptions ?? (typeof defaultItemsOrId === "string" ? defaultItemsOrId : void 0);
+		const options = typeof trailing === "string" ? { id: trailing } : trailing ?? {};
+		this.id = options.id;
+		this.description = options.description;
 	}
 	static resolveDefaultItems(value) {
 		if (typeof value === "string" || value === void 0) return;
 		return this.itemsInputNormalizer.normalize(value);
 	}
-	static resolveId(value, id) {
-		return typeof value === "string" ? value : id;
-	}
 	inspectorSummary() {
 		const rows = [{
 			label: "Trigger",
@@ -8057,11 +8193,13 @@ var MapData = class {
 	continueWhenEmptyOutput = true;
 	icon = "lucide:square-pen";
 	keepBinaries;
+	description;
 	constructor(name, map, options = {}) {
 		this.name = name;
 		this.map = map;
 		this.options = options;
 		this.keepBinaries = options.keepBinaries ?? true;
+		this.description = options.description;
 	}
 	get id() {
 		return this.options.id;
@@ -8134,10 +8272,14 @@ var Merge = class {
 	kind = "node";
 	type = MergeNode;
 	icon = "lucide:merge@rot=90";
-	constructor(name, cfg = { mode: "passThrough" }, id) {
+	id;
+	description;
+	constructor(name, cfg = { mode: "passThrough" }, idOrOptions) {
 		this.name = name;
 		this.cfg = cfg;
-		this.id = id;
+		const options = typeof idOrOptions === "string" ? { id: idOrOptions } : idOrOptions;
+		this.id = options?.id;
+		this.description = options?.description;
 	}
 	inspectorSummary() {
 		const rows = [{
@@ -8170,9 +8312,13 @@ var NoOp = class {
 	type = NoOpNode;
 	execution = { hint: "local" };
 	icon = "lucide:circle-dashed";
-	constructor(name = "NoOp", id) {
+	id;
+	description;
+	constructor(name = "NoOp", idOrOptions) {
 		this.name = name;
-		this.id = id;
+		const options = typeof idOrOptions === "string" ? { id: idOrOptions } : idOrOptions;
+		this.id = options?.id;
+		this.description = options?.description;
 	}
 };
 
@@ -8238,12 +8384,16 @@ var SubWorkflow = class {
 	kind = "node";
 	type = SubWorkflowNode;
 	icon = "lucide:workflow";
-	constructor(name, workflowId, upstreamRefs, startAt, id) {
+	id;
+	description;
+	constructor(name, workflowId, upstreamRefs, startAt, idOrOptions) {
 		this.name = name;
 		this.workflowId = workflowId;
 		this.upstreamRefs = upstreamRefs;
 		this.startAt = startAt;
-		this.id = id;
+		const options = typeof idOrOptions === "string" ? { id: idOrOptions } : idOrOptions;
+		this.id = options?.id;
+		this.description = options?.description;
 	}
 	inspectorSummary() {
 		const rows = [{
@@ -8353,10 +8503,14 @@ var Wait = class {
 	/** Pass-through empty batches should still advance to downstream nodes. */
 	continueWhenEmptyOutput = true;
 	icon = "lucide:hourglass";
-	constructor(name, milliseconds, id) {
+	id;
+	description;
+	constructor(name, milliseconds, idOrOptions) {
 		this.name = name;
 		this.milliseconds = milliseconds;
-		this.id = id;
+		const options = typeof idOrOptions === "string" ? { id: idOrOptions } : idOrOptions;
+		this.id = options?.id;
+		this.description = options?.description;
 	}
 	inspectorSummary() {
 		const seconds = this.milliseconds / 1e3;
@@ -8411,11 +8565,15 @@ var WebhookTrigger = class WebhookTrigger {
 	kind = "trigger";
 	type = WebhookTriggerNode;
 	icon = "lucide:globe";
-	constructor(name, args, handler = WebhookTrigger.defaultHandler, id) {
+	id;
+	description;
+	constructor(name, args, handler = WebhookTrigger.defaultHandler, idOrOptions) {
 		this.name = name;
 		this.args = args;
 		this.handler = handler;
-		this.id = id;
+		const options = typeof idOrOptions === "string" ? { id: idOrOptions } : idOrOptions;
+		this.id = options?.id;
+		this.description = options?.description;
 	}
 	get endpointKey() {
 		return this.args.endpointKey;
@@ -8472,11 +8630,21 @@ function createWorkflowBuilder(meta$2) {
 
 //#endregion
 //#region src/workflowAuthoring/WorkflowChatModelFactory.types.ts
+const VALID_COMPLEXITY = new Set([
+	"low",
+	"medium",
+	"high",
+	"xhigh"
+]);
 var WorkflowChatModelFactory = class {
 	static create(model) {
 		if (typeof model !== "string") return model;
 		const [provider, resolvedModel] = model.includes(":") ? model.split(":", 2) : ["openai", model];
-		if (provider === "codemation-managed") return new CodemationChatModelConfig("Codemation Managed", resolvedModel ?? "");
+		if (provider === "codemation-managed") {
+			const complexity = resolvedModel ?? "medium";
+			if (!VALID_COMPLEXITY.has(complexity)) throw new Error(`Invalid managed complexity "${complexity}". Must be one of: low, medium, high, xhigh.`);
+			return new CodemationChatModelConfig("Codemation Managed", complexity);
+		}
 		if (provider !== "openai") throw new Error(`Unsupported workflow().agent() model provider "${provider}".`);
 		return new OpenAIChatModelConfig("OpenAI", resolvedModel);
 	}
@@ -9113,5 +9281,5 @@ const codemationDocumentScannerNode = defineNode({
 });
 
 //#endregion
-export { AIAgent, AIAgentConnectionWorkflowExpander, AIAgentExecutionHelpersFactory, AIAgentNode, AgentItemPortMap, AgentMessageFactory, AgentOutputFactory, AgentStructuredOutputRepairPromptFactory, AgentStructuredOutputRunner, AgentToolCallPortMap, AgentToolErrorClassifier, AgentToolExecutionCoordinator, AgentToolRepairExhaustedError, AgentToolRepairPolicy, Aggregate, AggregateNode, Assertion, AssertionNode, BM25Index, Callback, CallbackNode, CallbackResultNormalizer, CodemationChatModelConfig, CodemationChatModelFactory, ConnectionCredentialExecutionContextFactory, ConnectionCredentialNode, ConnectionCredentialNodeConfig, ConnectionCredentialNodeConfigFactory, CronTrigger, CronTriggerNode, DeferredMetaToolStrategy, DeferredMetaToolStrategyFactory, Filter, FilterNode, HTTP_REQUEST_ACCEPTED_CREDENTIAL_TYPES, HttpRequest, HttpRequestNode, If, IfNode, IsTestRun, IsTestRunNode, ManagedModelFetcher, ManualTrigger, ManualTriggerNode, MapData, MapDataNode, Merge, MergeNode, NoOp, NoOpNode, OpenAIChatModelConfig, OpenAIChatModelFactory, OpenAiChatModelPresets, OpenAiStrictJsonSchemaFactory, SSRFBlockedError, Split, SplitNode, SsrfGuard, SubWorkflow, SubWorkflowNode, Switch, SwitchNode, TestTrigger, TestTriggerNode, Wait, WaitDuration, WaitNode, WebhookRespondNowAndContinueError, WebhookRespondNowError, WebhookTrigger, WebhookTriggerNode, WorkflowAuthoringBuilder, WorkflowBranchBuilder, WorkflowChain, apiKeyCredentialType, basicAuthCredentialType, bearerTokenCredentialType, codemationDocumentScannerNode, collectionDeleteNode, collectionFindOneNode, collectionGetNode, collectionInsertNode, collectionListNode, collectionUpdateNode, createWorkflowBuilder, defineRestNode, inboxApproval, oauth2ClientCredentialsType, openAiChatModelPresets, registerCoreNodes, workflow };
+export { AIAgent, AIAgentConnectionWorkflowExpander, AIAgentExecutionHelpersFactory, AIAgentNode, AgentItemPortMap, AgentMessageFactory, AgentOutputFactory, AgentStructuredOutputRepairPromptFactory, AgentStructuredOutputRunner, AgentToolCallPortMap, AgentToolErrorClassifier, AgentToolExecutionCoordinator, AgentToolRepairExhaustedError, AgentToolRepairPolicy, Aggregate, AggregateNode, Assertion, AssertionNode, BM25Index, Callback, CallbackNode, CallbackResultNormalizer, CodemationChatModelConfig, CodemationChatModelFactory, ConnectionCredentialExecutionContextFactory, ConnectionCredentialNode, ConnectionCredentialNodeConfig, ConnectionCredentialNodeConfigFactory, CronTrigger, CronTriggerNode, DeferredMetaToolStrategy, DeferredMetaToolStrategyFactory, Filter, FilterNode, HTTP_REQUEST_ACCEPTED_CREDENTIAL_TYPES, HttpRequest, HttpRequestNode, If, IfNode, IsTestRun, IsTestRunNode, ManualTrigger, ManualTriggerNode, MapData, MapDataNode, Merge, MergeNode, NoOp, NoOpNode, OpenAIChatModelConfig, OpenAIChatModelFactory, OpenAiChatModelPresets, OpenAiStrictJsonSchemaFactory, SSRFBlockedError, Split, SplitNode, SsrfGuard, SubWorkflow, SubWorkflowNode, Switch, SwitchNode, TestTrigger, TestTriggerNode, Wait, WaitDuration, WaitNode, WebhookRespondNowAndContinueError, WebhookRespondNowError, WebhookTrigger, WebhookTriggerNode, WorkflowAuthoringBuilder, WorkflowBranchBuilder, WorkflowChain, apiKeyCredentialType, basicAuthCredentialType, bearerTokenCredentialType, codemationDocumentScannerNode, collectionDeleteNode, collectionFindOneNode, collectionGetNode, collectionInsertNode, collectionListNode, collectionUpdateNode, createWorkflowBuilder, defineRestNode, inboxApproval, oauth2ClientCredentialsType, openAiChatModelPresets, registerCoreNodes, workflow };
 //# sourceMappingURL=index.js.map