@codemation/core-nodes 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # @codemation/core-nodes
 
+## 1.0.2
+
+### Patch Changes
+
+- [`ed75183`](https://github.com/MadeRelevant/codemation/commit/ed75183f51ae71b06aa2e57ae4fc48ce9db2e4ce) - Establish "per Item per Call" identity end-to-end so the workflow run inspector reports, visualizes, and dashboards multi-item AI agents correctly.
+
+  Previously, an orchestrator agent that processed N items emitted one flat list of LLM rounds and tool calls — the bottom execution tree, the right-panel agent timeline, cost dashboards, and the realtime event stream all collapsed iterations into one bucket, making sub-agent fan-outs (and parallel item processing in general) unreadable.
+
+  **What changed**
+  - **Engine** (`@codemation/core`): `NodeExecutor` mints a `NodeIterationId` per item inside per-item runnable activations and stamps it (with `itemIndex`) onto `NodeExecutionContext`. Connection invocations, telemetry spans (`gen_ai.chat.completion`, `agent.tool.call`), metric points (`codemation.cost.estimated`, `codemation.agent.turns`, `codemation.agent.tool_calls`), and run events all carry the per-item identity. New `ChildExecutionScopeFactory` re-roots `NodeExecutionContext` for sub-agents so credentials and iteration ids resolve correctly across the orchestrator → tool → sub-agent boundary.
+  - **Sub-agent credentials** (`@codemation/core-nodes`): `NodeBackedToolRuntime.resolveNodeCtx` no longer re-wraps `args.ctx.nodeId` with `ConnectionNodeIdFactory.toolConnectionNodeId` — the caller already pre-wraps it. The previous double-nesting produced exponentially deep node ids (`AIAgentNode:2__conn__tool__conn__searchInMail__conn__tool__conn__searchInMail__conn__llm`) that didn't match user-bound credential slots. Sub-agent OpenAI / API-key slots resolve again.
+  - **Realtime events**: new `connectionInvocationStarted` / `connectionInvocationCompleted` / `connectionInvocationFailed` events carry the full `ConnectionInvocationRecord` (incl. `iterationId`, `itemIndex`, `parentInvocationId`) and surgical reducers update the run cache without waiting for a coarse `runSaved` snapshot. Run-query polling dropped from 250 ms → 5 s now that WebSocket events drive most updates.
+  - **Persistence** (`@codemation/host`): Prisma `ExecutionInstance` model gains `iteration_id`, `item_index`, `parent_invocation_id` columns + index (sqlite + postgres migrations); `PrismaWorkflowRunRepository` round-trips them on read/save and via `ExecutionInstanceDto`. Without this the cold reload of a finished run silently flattens the per-item tree because `runSaved` events stream through Prisma. Telemetry tables already carried these columns from Phase 4; both sides now agree.
+  - **Iteration projection / cost queries** (`@codemation/host`): new `RunIterationProjectionFactory` projects `RunIterationRecord`s from connection invocations + iteration cost metrics and `GetIterationCostQueryHandler` serves per-iteration cost rollups for dashboards.
+  - **Inspector view model** (`@codemation/next-host`): `NodeInspectorTelemetryPresenter` groups LLM and tool spans by `iterationId` into "Item N" accordion entries (single-item agents fall back to flat layout). New `FocusedInvocationModelFactory` powers item-level prev/next navigation when a specific invocation is selected — the breadcrumb shows "Item X of Y" and nav targets the first invocation of adjacent items. Tool spans now interleave chronologically with LLM rounds (request → tools → response) instead of LLM rounds first then orphan tools at the bottom.
+  - **Bottom execution tree** (`@codemation/next-host`): new `ExecutionTreeItemGroupInjector` injects synthetic "Item N" parent rows between an agent and its connection invocations when the agent processed 2+ items. Single-item activations are left untouched; sub-agent invocations whose `parentInvocationId` already points at a tool-call row stay nested under the orchestrator's specific tool call.
+  - **Sub-agent credential boundary**: `ChildExecutionScopeFactory.forSubAgent` ensures sub-agent `NodeExecutionContext` keeps the parent invocation id and span context intact so trace nesting and credential resolution agree on the connection-node id.
+  - **Tests**: new unit + UI suites for each layer (sub-agent scope, item-group injector, focused invocation model, agent timeline per-item grouping, chronological ordering, Prisma iterationId round trip, item-aware properties panel, connection-invocation event publisher) and a runnable `apps/test-dev` sample (`agentSubAgentToolFanout`) that exercises the orchestrator → sub-agent fan-out across 2 items end-to-end.
+
+- Updated dependencies [[`ed75183`](https://github.com/MadeRelevant/codemation/commit/ed75183f51ae71b06aa2e57ae4fc48ce9db2e4ce)]:
+  - @codemation/core@1.0.1
+
+## 1.0.1
+
+### Patch Changes
+
+- [#95](https://github.com/MadeRelevant/codemation/pull/95) [`328c975`](https://github.com/MadeRelevant/codemation/commit/328c9759d45b711c177ea9a360ed4960ffdf5ffa) Thanks [@cblokland90](https://github.com/cblokland90)! - Workflow-canvas icon system redesign: LTR-oriented control-flow icons, pixel-perfect Split / Aggregate SVGs, and a single icon renderer shared by the canvas and the execution tree panel.
+
+  **Why**
+
+  The canvas reads left-to-right, but Lucide's `split`, `merge`, and `git-*` family are oriented vertically (top-to-bottom git-graph convention), so `If` and `Merge` nodes rendered 90° off from the flow direction. The execution-tree panel also ran a parallel icon-rendering path that only understood Lucide names — every time a plugin node set an icon as `builtin:<id>`, `si:<slug>`, or a URL, the tree panel silently fell back to a type-substring-guessed Lucide glyph (e.g. `"wait".includes("ai")` → the agent Bot icon). That duplication is gone.
+
+  **What changed**
+  - **Rotation suffix**: `NodeConfigBase.icon` now accepts an optional `@rot=<0|90|180|270>` tail modifier on any icon token (`lucide:`, `builtin:`, `si:`, or URL). Parsed by a strict tail regex so URLs with `@` (for example `http://user@host/icon.svg`) are unaffected, and non-orthogonal angles are rejected so glyphs stay pixel-crisp.
+  - **LTR control-flow icons**:
+    - `If`: `lucide:split@rot=90` — Y-fork with the single leg on the left and two arms fanning right.
+    - `Merge`: `lucide:merge@rot=90` — chevron pointing right, two arms merging from the left.
+  - **Pixel-perfect builtin SVGs** shipped under `packages/next-host/public/canvas-icons/builtin/`:
+    - `builtin:split-rows`: 1 source square on the left, tree trunk / spine, 3 output lines on the right.
+    - `builtin:aggregate-rows`: mirror — 3 input lines on the left converging through a spine into 1 summary square on the right.
+    - Stroke-based SVGs (matching Lucide stroke weight next to them on the canvas).
+  - **`@codemation/core-nodes` built-in node icon updates** that plug into the above: `If` (rotated split), `Merge` (rotated merge), `Split` (`builtin:split-rows`), `Aggregate` (`builtin:aggregate-rows`), `Wait` (`lucide:hourglass`), `MapData` (`lucide:square-pen`), `HttpRequest` (`lucide:globe`), `WebhookTrigger` (`lucide:webhook`), `NoOp` (`lucide:circle-dashed`).
+  - **One renderer, role-only fallback**: `WorkflowExecutionInspectorTreePanelContent` now renders `<WorkflowCanvasNodeIcon />` so `builtin:`, `si:`, URLs, and `@rot=…` resolve identically in the execution tree panel and on the canvas. `WorkflowNodeIconResolver.resolveFallback` shrank from 11 branches of type-substring guessing to 4 role mappings (`agent` / `nestedAgent` → `Bot`, `languageModel` → `Brain`, `tool` → `Wrench`, else → `Boxes`). Plugin nodes that forget to set an icon now get a generic `Boxes` — a clear visual signal rather than a silent substring mismatch.
+  - **New test file** `test/canvas/workflowCanvasNodeIcon.test.tsx` pins 12 behaviours across the rotation parser and the role-only fallback, including a regression case that the pre-fix `"wait".includes("ai")` mis-mapping is impossible now.
+
 ## 1.0.0
 
 ### Major Changes

package/dist/index.cjs

@@ -2883,7 +2883,7 @@ let AgentToolExecutionCoordinator = class AgentToolExecutionCoordinator$1 {
 	async executePlannedToolCall(args) {
 		const { plannedToolCall, ctx } = args;
 		const toolCallInputsByPort = AgentToolCallPortMap.fromInput(plannedToolCall.toolCall.input ?? {});
-		const invocationId = __codemation_core.ConnectionInvocationIdFactory.create();
+		const invocationId = plannedToolCall.invocationId;
 		const startedAt = /* @__PURE__ */ new Date();
 		const span = ctx.telemetry.startChildSpan({
 			name: "agent.tool.call",
@@ -2891,7 +2891,10 @@ let AgentToolExecutionCoordinator = class AgentToolExecutionCoordinator$1 {
 			startedAt,
 			attributes: {
 				[__codemation_core.CodemationTelemetryAttributeNames.connectionInvocationId]: invocationId,
-				[__codemation_core.CodemationTelemetryAttributeNames.toolName]: plannedToolCall.binding.config.name
+				[__codemation_core.CodemationTelemetryAttributeNames.toolName]: plannedToolCall.binding.config.name,
+				...ctx.iterationId ? { [__codemation_core.CodemationTelemetryAttributeNames.iterationId]: ctx.iterationId } : {},
+				...typeof ctx.itemIndex === "number" ? { [__codemation_core.CodemationTelemetryAttributeNames.iterationIndex]: ctx.itemIndex } : {},
+				...ctx.parentInvocationId ? { [__codemation_core.CodemationTelemetryAttributeNames.parentInvocationId]: ctx.parentInvocationId } : {}
 			}
 		});
 		await ctx.nodeState?.markRunning({
@@ -2899,8 +2902,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({
@@ -2933,7 +2951,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,
@@ -3074,7 +3094,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) {
@@ -3135,13 +3157,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({
@@ -3152,10 +3175,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({
@@ -3168,6 +3188,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 = __codemation_core.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)) {
@@ -3205,11 +3254,13 @@ NodeBackedToolRuntime = __decorate([
 	__decorateParam(1, (0, __codemation_core.inject)(__codemation_core.ItemExprResolver)),
 	__decorateParam(2, (0, __codemation_core.inject)(__codemation_core.NodeOutputNormalizer)),
 	__decorateParam(3, (0, __codemation_core.inject)(__codemation_core.RunnableOutputBehaviorResolver)),
+	__decorateParam(4, (0, __codemation_core.inject)(__codemation_core.ChildExecutionScopeFactory)),
 	__decorateMetadata("design:paramtypes", [
 		Object,
 		typeof (_ref$1 = typeof __codemation_core.ItemExprResolver !== "undefined" && __codemation_core.ItemExprResolver) === "function" ? _ref$1 : Object,
 		typeof (_ref2$1 = typeof __codemation_core.NodeOutputNormalizer !== "undefined" && __codemation_core.NodeOutputNormalizer) === "function" ? _ref2$1 : Object,
-		typeof (_ref3$1 = typeof __codemation_core.RunnableOutputBehaviorResolver !== "undefined" && __codemation_core.RunnableOutputBehaviorResolver) === "function" ? _ref3$1 : Object
+		typeof (_ref3$1 = typeof __codemation_core.RunnableOutputBehaviorResolver !== "undefined" && __codemation_core.RunnableOutputBehaviorResolver) === "function" ? _ref3$1 : Object,
+		typeof (_ref4$1 = typeof __codemation_core.ChildExecutionScopeFactory !== "undefined" && __codemation_core.ChildExecutionScopeFactory) === "function" ? _ref4$1 : Object
 	])
 ], NodeBackedToolRuntime);
 
@@ -3412,7 +3463,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,
@@ -3420,7 +3471,8 @@ let AIAgentNode = class AIAgentNode$1 {
 						ctx: toolCredentialContext,
 						item,
 						itemIndex,
-						items
+						items,
+						hooks
 					});
 				}
 			};
@@ -3470,11 +3522,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);
@@ -3490,11 +3567,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",
@@ -3518,10 +3596,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) {
@@ -3557,11 +3638,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) ? ai.Output.object({ schema: (0, ai.jsonSchema)(schema) }) : ai.Output.object({ schema });
@@ -3607,7 +3713,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) {
@@ -3638,6 +3747,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;
@@ -3681,7 +3808,10 @@ let AIAgentNode = class AIAgentNode$1 {
 			attributes: {
 				[__codemation_core.CodemationTelemetryAttributeNames.connectionInvocationId]: invocationId,
 				[__codemation_core.GenAiTelemetryAttributeNames.operationName]: "chat",
-				[__codemation_core.GenAiTelemetryAttributeNames.requestModel]: this.resolveChatModelName(ctx.config.chatModel)
+				[__codemation_core.GenAiTelemetryAttributeNames.requestModel]: this.resolveChatModelName(ctx.config.chatModel),
+				...ctx.iterationId ? { [__codemation_core.CodemationTelemetryAttributeNames.iterationId]: ctx.iterationId } : {},
+				...typeof ctx.itemIndex === "number" ? { [__codemation_core.CodemationTelemetryAttributeNames.iterationIndex]: ctx.itemIndex } : {},
+				...ctx.parentInvocationId ? { [__codemation_core.CodemationTelemetryAttributeNames.parentInvocationId]: ctx.parentInvocationId } : {}
 			}
 		});
 	}
@@ -3731,11 +3861,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();
@@ -3748,7 +3893,8 @@ let AIAgentNode = class AIAgentNode$1 {
 				binding,
 				toolCall,
 				invocationIndex,
-				nodeId: __codemation_core.ConnectionNodeIdFactory.toolConnectionNodeId(parentNodeId, binding.config.name)
+				nodeId: __codemation_core.ConnectionNodeIdFactory.toolConnectionNodeId(parentNodeId, binding.config.name),
+				invocationId: __codemation_core.ConnectionInvocationIdFactory.create()
 			};
 		});
 	}
@@ -3776,7 +3922,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;
 	}
@@ -4049,6 +4198,7 @@ var HttpRequest = class {
 	kind = "node";
 	type = HttpRequestNode;
 	execution = { hint: "local" };
+	icon = "lucide:globe";
 	constructor(name, args = {}, retryPolicy = __codemation_core.RetryPolicy.defaultForHttp) {
 		this.name = name;
 		this.args = args;
@@ -4090,7 +4240,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;
@@ -4185,7 +4335,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;
@@ -4250,7 +4400,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;
@@ -4321,6 +4471,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;
@@ -4390,7 +4541,7 @@ MergeNode = __decorate([(0, __codemation_core.node)({ packageName: "@codemation/
 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;
@@ -4415,6 +4566,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;
@@ -4520,6 +4672,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;
@@ -4570,7 +4723,7 @@ WebhookTriggerNode = __decorate([(0, __codemation_core.node)({ packageName: "@co
 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;