@codemation/core-nodes 1.0.0 → 1.0.2

package/dist/index.js

@@ -1,4 +1,4 @@
-import { AgentConfigInspector, AgentConnectionNodeCollector, AgentGuardrailDefaults, AgentMessageConfigNormalizer, CallableToolConfig, CodemationTelemetryAttributeNames, CodemationTelemetryMetricNames, ConnectionInvocationIdFactory, ConnectionNodeIdFactory, CoreTokens, DefinedNodeRegistry, GenAiTelemetryAttributeNames, ItemExprResolver, ItemsInputNormalizer, NodeBackedToolConfig, NodeOutputNormalizer, RetryPolicy, RunnableOutputBehaviorResolver, WorkflowBuilder, chatModel, emitPorts, getOriginIndexFromItem, inject, injectable, isPortsEmission, node } from "@codemation/core";
+import { AgentConfigInspector, AgentConnectionNodeCollector, AgentGuardrailDefaults, AgentMessageConfigNormalizer, CallableToolConfig, ChildExecutionScopeFactory, CodemationTelemetryAttributeNames, CodemationTelemetryMetricNames, ConnectionInvocationIdFactory, ConnectionNodeIdFactory, CoreTokens, DefinedNodeRegistry, GenAiTelemetryAttributeNames, ItemExprResolver, ItemsInputNormalizer, NodeBackedToolConfig, NodeOutputNormalizer, RetryPolicy, RunnableOutputBehaviorResolver, WorkflowBuilder, chatModel, emitPorts, getOriginIndexFromItem, inject, injectable, isPortsEmission, node } from "@codemation/core";
 import { createOpenAI } from "@ai-sdk/openai";
 import { CredentialResolverFactory } from "@codemation/core/bootstrap";
 import { Output, generateText, jsonSchema } from "ai";
@@ -2856,7 +2856,7 @@ let AgentToolExecutionCoordinator = class AgentToolExecutionCoordinator$1 {
 	async executePlannedToolCall(args) {
 		const { plannedToolCall, ctx } = args;
 		const toolCallInputsByPort = AgentToolCallPortMap.fromInput(plannedToolCall.toolCall.input ?? {});
-		const invocationId = ConnectionInvocationIdFactory.create();
+		const invocationId = plannedToolCall.invocationId;
 		const startedAt = /* @__PURE__ */ new Date();
 		const span = ctx.telemetry.startChildSpan({
 			name: "agent.tool.call",
@@ -2864,7 +2864,10 @@ let AgentToolExecutionCoordinator = class AgentToolExecutionCoordinator$1 {
 			startedAt,
 			attributes: {
 				[CodemationTelemetryAttributeNames.connectionInvocationId]: invocationId,
-				[CodemationTelemetryAttributeNames.toolName]: plannedToolCall.binding.config.name
+				[CodemationTelemetryAttributeNames.toolName]: plannedToolCall.binding.config.name,
+				...ctx.iterationId ? { [CodemationTelemetryAttributeNames.iterationId]: ctx.iterationId } : {},
+				...typeof ctx.itemIndex === "number" ? { [CodemationTelemetryAttributeNames.iterationIndex]: ctx.itemIndex } : {},
+				...ctx.parentInvocationId ? { [CodemationTelemetryAttributeNames.parentInvocationId]: ctx.parentInvocationId } : {}
 			}
 		});
 		await ctx.nodeState?.markRunning({
@@ -2872,8 +2875,23 @@ let AgentToolExecutionCoordinator = class AgentToolExecutionCoordinator$1 {
 			activationId: ctx.activationId,
 			inputsByPort: toolCallInputsByPort
 		});
+		await ctx.nodeState?.appendConnectionInvocation({
+			invocationId,
+			connectionNodeId: plannedToolCall.nodeId,
+			parentAgentNodeId: ctx.nodeId,
+			parentAgentActivationId: ctx.activationId,
+			status: "running",
+			managedInput: this.toJsonValue(plannedToolCall.toolCall.input),
+			queuedAt: startedAt.toISOString(),
+			startedAt: startedAt.toISOString(),
+			iterationId: ctx.iterationId,
+			parentInvocationId: ctx.parentInvocationId
+		});
 		try {
-			const result = await plannedToolCall.binding.execute(plannedToolCall.toolCall.input ?? {});
+			const result = await plannedToolCall.binding.execute(plannedToolCall.toolCall.input ?? {}, {
+				parentSpan: span,
+				parentInvocationId: invocationId
+			});
 			const serialized = typeof result === "string" ? result : JSON.stringify(result);
 			const finishedAt = /* @__PURE__ */ new Date();
 			await ctx.nodeState?.markCompleted({
@@ -2906,7 +2924,9 @@ let AgentToolExecutionCoordinator = class AgentToolExecutionCoordinator$1 {
 				managedOutput: this.toJsonValue(result),
 				queuedAt: startedAt.toISOString(),
 				startedAt: startedAt.toISOString(),
-				finishedAt: finishedAt.toISOString()
+				finishedAt: finishedAt.toISOString(),
+				iterationId: ctx.iterationId,
+				parentInvocationId: ctx.parentInvocationId
 			});
 			return {
 				toolName: plannedToolCall.binding.config.name,
@@ -3047,7 +3067,9 @@ let AgentToolExecutionCoordinator = class AgentToolExecutionCoordinator$1 {
 			},
 			queuedAt: args.startedAt.toISOString(),
 			startedAt: args.startedAt.toISOString(),
-			finishedAt: finishedAt.toISOString()
+			finishedAt: finishedAt.toISOString(),
+			iterationId: args.ctx.iterationId,
+			parentInvocationId: args.ctx.parentInvocationId
 		});
 	}
 	createRepairPayload(args) {
@@ -3108,13 +3130,14 @@ AgentToolExecutionCoordinator = __decorate([
 
 //#endregion
 //#region src/nodes/NodeBackedToolRuntime.ts
-var _ref$1, _ref2$1, _ref3$1;
+var _ref$1, _ref2$1, _ref3$1, _ref4$1;
 let NodeBackedToolRuntime = class NodeBackedToolRuntime$1 {
-	constructor(nodeResolver, itemExprResolver, outputNormalizer, outputBehaviorResolver) {
+	constructor(nodeResolver, itemExprResolver, outputNormalizer, outputBehaviorResolver, childExecutionScopeFactory) {
 		this.nodeResolver = nodeResolver;
 		this.itemExprResolver = itemExprResolver;
 		this.outputNormalizer = outputNormalizer;
 		this.outputBehaviorResolver = outputBehaviorResolver;
+		this.childExecutionScopeFactory = childExecutionScopeFactory;
 	}
 	async execute(config$1, args) {
 		const nodeInput = config$1.toNodeItem({
@@ -3125,10 +3148,7 @@ let NodeBackedToolRuntime = class NodeBackedToolRuntime$1 {
 			ctx: args.ctx,
 			node: config$1.node
 		});
-		const nodeCtx = {
-			...args.ctx,
-			config: config$1.node
-		};
+		const nodeCtx = this.resolveNodeCtx(config$1, args);
 		const resolvedNode = this.nodeResolver.resolve(config$1.node.type);
 		const outputs = await this.executeResolvedNode(resolvedNode, nodeInput, nodeCtx);
 		return config$1.toToolOutput({
@@ -3141,6 +3161,35 @@ let NodeBackedToolRuntime = class NodeBackedToolRuntime$1 {
 			outputs
 		});
 	}
+	/**
+	* Returns a re-rooted child ctx for nested-agent tools (so their LLM/tool connection ids derive
+	* from the tool connection node, telemetry parents under the tool-call span, and connection
+	* invocations carry `parentInvocationId`). Plain runnable tools (non-agent) keep the orchestrator
+	* ctx with only `config` swapped — no nesting concern.
+	*
+	* The caller (`AIAgentNode.createItemScopedTools`) already wraps the orchestrator ctx via
+	* `ConnectionCredentialExecutionContextFactory.forConnectionNode`, so `args.ctx.nodeId` is the
+	* tool's own connection node id (e.g. `AIAgentNode:2__conn__tool__searchInMail`). We pass that
+	* through as the sub-agent's `nodeId`; deriving another `toolConnectionNodeId(args.ctx.nodeId,
+	* config.name)` here would prepend a duplicate `__conn__tool__<name>` segment and exponentially
+	* deepen ids on each invocation, which also breaks credential resolution because user-provided
+	* bindings sit on the single-level connection node id.
+	*/
+	resolveNodeCtx(config$1, args) {
+		const isNestedAgent = AgentConfigInspector.isAgentNodeConfig(config$1.node);
+		const hooks = args.hooks;
+		if (!isNestedAgent || !hooks?.parentSpan || !hooks.parentInvocationId) return {
+			...args.ctx,
+			config: config$1.node
+		};
+		return this.childExecutionScopeFactory.forSubAgent({
+			parentCtx: args.ctx,
+			childNodeId: args.ctx.nodeId,
+			childConfig: config$1.node,
+			parentInvocationId: hooks.parentInvocationId,
+			parentSpan: hooks.parentSpan
+		});
+	}
 	async executeResolvedNode(resolvedNode, nodeInput, ctx) {
 		if (this.isMultiInputNode(resolvedNode)) return await resolvedNode.executeMulti({ in: [nodeInput] }, ctx);
 		if (this.isRunnableNode(resolvedNode)) {
@@ -3178,11 +3227,13 @@ NodeBackedToolRuntime = __decorate([
 	__decorateParam(1, inject(ItemExprResolver)),
 	__decorateParam(2, inject(NodeOutputNormalizer)),
 	__decorateParam(3, inject(RunnableOutputBehaviorResolver)),
+	__decorateParam(4, inject(ChildExecutionScopeFactory)),
 	__decorateMetadata("design:paramtypes", [
 		Object,
 		typeof (_ref$1 = typeof ItemExprResolver !== "undefined" && ItemExprResolver) === "function" ? _ref$1 : Object,
 		typeof (_ref2$1 = typeof NodeOutputNormalizer !== "undefined" && NodeOutputNormalizer) === "function" ? _ref2$1 : Object,
-		typeof (_ref3$1 = typeof RunnableOutputBehaviorResolver !== "undefined" && RunnableOutputBehaviorResolver) === "function" ? _ref3$1 : Object
+		typeof (_ref3$1 = typeof RunnableOutputBehaviorResolver !== "undefined" && RunnableOutputBehaviorResolver) === "function" ? _ref3$1 : Object,
+		typeof (_ref4$1 = typeof ChildExecutionScopeFactory !== "undefined" && ChildExecutionScopeFactory) === "function" ? _ref4$1 : Object
 	])
 ], NodeBackedToolRuntime);
 
@@ -3385,7 +3436,7 @@ let AIAgentNode = class AIAgentNode$1 {
 			return {
 				config: entry.config,
 				inputSchema: entry.runtime.inputSchema,
-				execute: async (input) => {
+				execute: async (input, hooks) => {
 					const validated = entry.runtime.inputSchema.parse(input);
 					return await entry.runtime.execute({
 						config: entry.config,
@@ -3393,7 +3444,8 @@ let AIAgentNode = class AIAgentNode$1 {
 						ctx: toolCredentialContext,
 						item,
 						itemIndex,
-						items
+						items,
+						hooks
 					});
 				}
 			};
@@ -3443,11 +3495,36 @@ let AIAgentNode = class AIAgentNode$1 {
 			activationId: ctx.activationId,
 			inputsByPort: itemInputsByPort
 		});
+		await ctx.nodeState?.appendConnectionInvocation({
+			invocationId,
+			connectionNodeId: languageModelConnectionNodeId,
+			parentAgentNodeId: ctx.nodeId,
+			parentAgentActivationId: ctx.activationId,
+			status: "queued",
+			managedInput: summarizedInput,
+			queuedAt: startedAt.toISOString(),
+			iterationId: ctx.iterationId,
+			itemIndex: ctx.itemIndex,
+			parentInvocationId: ctx.parentInvocationId
+		});
 		await ctx.nodeState?.markRunning({
 			nodeId: languageModelConnectionNodeId,
 			activationId: ctx.activationId,
 			inputsByPort: itemInputsByPort
 		});
+		await ctx.nodeState?.appendConnectionInvocation({
+			invocationId,
+			connectionNodeId: languageModelConnectionNodeId,
+			parentAgentNodeId: ctx.nodeId,
+			parentAgentActivationId: ctx.activationId,
+			status: "running",
+			managedInput: summarizedInput,
+			queuedAt: startedAt.toISOString(),
+			startedAt: startedAt.toISOString(),
+			iterationId: ctx.iterationId,
+			itemIndex: ctx.itemIndex,
+			parentInvocationId: ctx.parentInvocationId
+		});
 		try {
 			const tools = this.buildToolSet(itemScopedTools);
 			const callOptions = this.resolveCallOptions(model, guardrails.modelInvocationOptions);
@@ -3463,11 +3540,12 @@ let AIAgentNode = class AIAgentNode$1 {
 			});
 			const turnResult = this.extractTurnResult(result);
 			const finishedAt = /* @__PURE__ */ new Date();
+			const managedOutput = this.summarizeTurnOutput(turnResult);
 			await ctx.nodeState?.markCompleted({
 				nodeId: languageModelConnectionNodeId,
 				activationId: ctx.activationId,
 				inputsByPort: itemInputsByPort,
-				outputs: AgentOutputFactory.fromUnknown({ content: turnResult.text })
+				outputs: AgentOutputFactory.fromUnknown(managedOutput)
 			});
 			await span.attachArtifact({
 				kind: "ai.messages",
@@ -3491,10 +3569,13 @@ let AIAgentNode = class AIAgentNode$1 {
 				parentAgentActivationId: ctx.activationId,
 				status: "completed",
 				managedInput: summarizedInput,
-				managedOutput: turnResult.text,
+				managedOutput,
 				queuedAt: startedAt.toISOString(),
 				startedAt: startedAt.toISOString(),
-				finishedAt: finishedAt.toISOString()
+				finishedAt: finishedAt.toISOString(),
+				iterationId: ctx.iterationId,
+				itemIndex: ctx.itemIndex,
+				parentInvocationId: ctx.parentInvocationId
 			});
 			return turnResult;
 		} catch (error) {
@@ -3530,11 +3611,36 @@ let AIAgentNode = class AIAgentNode$1 {
 			activationId: ctx.activationId,
 			inputsByPort: itemInputsByPort
 		});
+		await ctx.nodeState?.appendConnectionInvocation({
+			invocationId,
+			connectionNodeId: languageModelConnectionNodeId,
+			parentAgentNodeId: ctx.nodeId,
+			parentAgentActivationId: ctx.activationId,
+			status: "queued",
+			managedInput: summarizedInput,
+			queuedAt: startedAt.toISOString(),
+			iterationId: ctx.iterationId,
+			itemIndex: ctx.itemIndex,
+			parentInvocationId: ctx.parentInvocationId
+		});
 		await ctx.nodeState?.markRunning({
 			nodeId: languageModelConnectionNodeId,
 			activationId: ctx.activationId,
 			inputsByPort: itemInputsByPort
 		});
+		await ctx.nodeState?.appendConnectionInvocation({
+			invocationId,
+			connectionNodeId: languageModelConnectionNodeId,
+			parentAgentNodeId: ctx.nodeId,
+			parentAgentActivationId: ctx.activationId,
+			status: "running",
+			managedInput: summarizedInput,
+			queuedAt: startedAt.toISOString(),
+			startedAt: startedAt.toISOString(),
+			iterationId: ctx.iterationId,
+			itemIndex: ctx.itemIndex,
+			parentInvocationId: ctx.parentInvocationId
+		});
 		try {
 			const callOptions = this.resolveCallOptions(model, guardrails.modelInvocationOptions);
 			const outputSchema = structuredOptions?.strict && !this.isZodSchema(schema) ? Output.object({ schema: jsonSchema(schema) }) : Output.object({ schema });
@@ -3580,7 +3686,10 @@ let AIAgentNode = class AIAgentNode$1 {
 				managedOutput: this.resultToJsonValue(result.experimental_output),
 				queuedAt: startedAt.toISOString(),
 				startedAt: startedAt.toISOString(),
-				finishedAt: finishedAt.toISOString()
+				finishedAt: finishedAt.toISOString(),
+				iterationId: ctx.iterationId,
+				itemIndex: ctx.itemIndex,
+				parentInvocationId: ctx.parentInvocationId
 			});
 			return result.experimental_output;
 		} catch (error) {
@@ -3611,6 +3720,24 @@ let AIAgentNode = class AIAgentNode$1 {
 			providerOptions: overrides?.providerOptions ?? defaults.providerOptions
 		};
 	}
+	/**
+	* Build a no-code-friendly output payload for an LLM round.
+	*
+	* Always includes `content` (matching the canvas snapshot shape used elsewhere) and adds a
+	* `toolCalls` array when the round produced tool calls so the execution inspector surfaces the
+	* planned calls instead of just an empty `""` for tool-only rounds.
+	*/
+	summarizeTurnOutput(turnResult) {
+		if (turnResult.toolCalls.length === 0) return { content: turnResult.text };
+		const toolCalls = turnResult.toolCalls.map((toolCall) => ({
+			name: toolCall.name,
+			args: this.resultToJsonValue(toolCall.input) ?? null
+		}));
+		return {
+			content: turnResult.text,
+			toolCalls
+		};
+	}
 	extractTurnResult(result) {
 		const usage = this.extractUsageFromResult(result);
 		const text = result.text;
@@ -3654,7 +3781,10 @@ let AIAgentNode = class AIAgentNode$1 {
 			attributes: {
 				[CodemationTelemetryAttributeNames.connectionInvocationId]: invocationId,
 				[GenAiTelemetryAttributeNames.operationName]: "chat",
-				[GenAiTelemetryAttributeNames.requestModel]: this.resolveChatModelName(ctx.config.chatModel)
+				[GenAiTelemetryAttributeNames.requestModel]: this.resolveChatModelName(ctx.config.chatModel),
+				...ctx.iterationId ? { [CodemationTelemetryAttributeNames.iterationId]: ctx.iterationId } : {},
+				...typeof ctx.itemIndex === "number" ? { [CodemationTelemetryAttributeNames.iterationIndex]: ctx.itemIndex } : {},
+				...ctx.parentInvocationId ? { [CodemationTelemetryAttributeNames.parentInvocationId]: ctx.parentInvocationId } : {}
 			}
 		});
 	}
@@ -3704,11 +3834,26 @@ let AIAgentNode = class AIAgentNode$1 {
 		return chatModel$1.modelName ?? chatModel$1.name;
 	}
 	async markQueuedTools(plannedToolCalls, ctx) {
-		for (const plannedToolCall of plannedToolCalls) await ctx.nodeState?.markQueued({
-			nodeId: plannedToolCall.nodeId,
-			activationId: ctx.activationId,
-			inputsByPort: AgentToolCallPortMap.fromInput(plannedToolCall.toolCall.input ?? {})
-		});
+		const queuedAt = (/* @__PURE__ */ new Date()).toISOString();
+		for (const plannedToolCall of plannedToolCalls) {
+			await ctx.nodeState?.markQueued({
+				nodeId: plannedToolCall.nodeId,
+				activationId: ctx.activationId,
+				inputsByPort: AgentToolCallPortMap.fromInput(plannedToolCall.toolCall.input ?? {})
+			});
+			await ctx.nodeState?.appendConnectionInvocation({
+				invocationId: plannedToolCall.invocationId,
+				connectionNodeId: plannedToolCall.nodeId,
+				parentAgentNodeId: ctx.nodeId,
+				parentAgentActivationId: ctx.activationId,
+				status: "queued",
+				managedInput: this.resultToJsonValue(plannedToolCall.toolCall.input),
+				queuedAt,
+				iterationId: ctx.iterationId,
+				itemIndex: ctx.itemIndex,
+				parentInvocationId: ctx.parentInvocationId
+			});
+		}
 	}
 	planToolCalls(bindings, toolCalls, parentNodeId) {
 		const invocationCountByToolName = /* @__PURE__ */ new Map();
@@ -3721,7 +3866,8 @@ let AIAgentNode = class AIAgentNode$1 {
 				binding,
 				toolCall,
 				invocationIndex,
-				nodeId: ConnectionNodeIdFactory.toolConnectionNodeId(parentNodeId, binding.config.name)
+				nodeId: ConnectionNodeIdFactory.toolConnectionNodeId(parentNodeId, binding.config.name),
+				invocationId: ConnectionInvocationIdFactory.create()
 			};
 		});
 	}
@@ -3749,7 +3895,10 @@ let AIAgentNode = class AIAgentNode$1 {
 			},
 			queuedAt: args.startedAt.toISOString(),
 			startedAt: args.startedAt.toISOString(),
-			finishedAt: finishedAt.toISOString()
+			finishedAt: finishedAt.toISOString(),
+			iterationId: args.ctx.iterationId,
+			itemIndex: args.ctx.itemIndex,
+			parentInvocationId: args.ctx.parentInvocationId
 		});
 		return effectiveError;
 	}
@@ -4022,6 +4171,7 @@ var HttpRequest = class {
 	kind = "node";
 	type = HttpRequestNode;
 	execution = { hint: "local" };
+	icon = "lucide:globe";
 	constructor(name, args = {}, retryPolicy = RetryPolicy.defaultForHttp) {
 		this.name = name;
 		this.args = args;
@@ -4063,7 +4213,7 @@ var Aggregate = class {
 	type = AggregateNode;
 	execution = { hint: "local" };
 	keepBinaries = true;
-	icon = "lucide:layers";
+	icon = "builtin:aggregate-rows";
 	constructor(name, aggregate, id) {
 		this.name = name;
 		this.aggregate = aggregate;
@@ -4158,7 +4308,7 @@ var If = class {
 	kind = "node";
 	type = IfNode;
 	execution = { hint: "local" };
-	icon = "lucide:split";
+	icon = "lucide:split@rot=90";
 	declaredOutputPorts = ["true", "false"];
 	constructor(name, predicate, id) {
 		this.name = name;
@@ -4223,7 +4373,7 @@ var Split = class {
 	* Mirrors {@link MapData}'s empty-output behavior.
 	*/
 	continueWhenEmptyOutput = true;
-	icon = "lucide:ungroup";
+	icon = "builtin:split-rows";
 	constructor(name, getElements, id) {
 		this.name = name;
 		this.getElements = getElements;
@@ -4294,6 +4444,7 @@ var MapData = class {
 	execution = { hint: "local" };
 	/** Zero mapped items should still allow downstream nodes to run. */
 	continueWhenEmptyOutput = true;
+	icon = "lucide:square-pen";
 	keepBinaries;
 	constructor(name, map, options = {}) {
 		this.name = name;
@@ -4363,7 +4514,7 @@ MergeNode = __decorate([node({ packageName: "@codemation/core-nodes" })], MergeN
 var Merge = class {
 	kind = "node";
 	type = MergeNode;
-	icon = "lucide:git-merge";
+	icon = "lucide:merge@rot=90";
 	constructor(name, cfg = { mode: "passThrough" }, id) {
 		this.name = name;
 		this.cfg = cfg;
@@ -4388,6 +4539,7 @@ var NoOp = class {
 	kind = "node";
 	type = NoOpNode;
 	execution = { hint: "local" };
+	icon = "lucide:circle-dashed";
 	constructor(name = "NoOp", id) {
 		this.name = name;
 		this.id = id;
@@ -4493,6 +4645,7 @@ var Wait = class {
 	execution = { hint: "local" };
 	/** Pass-through empty batches should still advance to downstream nodes. */
 	continueWhenEmptyOutput = true;
+	icon = "lucide:hourglass";
 	constructor(name, milliseconds, id) {
 		this.name = name;
 		this.milliseconds = milliseconds;
@@ -4543,7 +4696,7 @@ WebhookTriggerNode = __decorate([node({ packageName: "@codemation/core-nodes" })
 var WebhookTrigger = class WebhookTrigger {
 	kind = "trigger";
 	type = WebhookTriggerNode;
-	icon = "lucide:globe";
+	icon = "lucide:webhook";
 	constructor(name, args, handler = WebhookTrigger.defaultHandler, id) {
 		this.name = name;
 		this.args = args;