@codemation/core 1.0.0 → 1.0.1

package/dist/{runtime-DWKfb0BI.cjs → runtime-B3Og-_St.cjs}

@@ -282,6 +282,29 @@ var ConnectionNodeIdFactory = class {
 	}
 };
 
+//#endregion
+//#region src/workflow/definition/NodeIterationIdFactory.ts
+/**
+* Unique ids for one per-item iteration of a runnable node's execute loop.
+*
+* Activations are per-batch (one scheduled execution of a node, possibly with N items).
+* Iterations refine that to one identifier per item-index inside the batch loop, so per-item
+* connection invocations and telemetry can be grouped without time-window heuristics.
+*/
+var NodeIterationIdFactory = class {
+	static create() {
+		return `iter_${(0, node_crypto.randomUUID)()}`;
+	}
+	/** Deterministic id for tests when a stable sequence is needed. */
+	static createForTest(seed, sequence) {
+		return `iter_${seed}_${sequence}`;
+	}
+	/** Deterministic id derived from a connection node id (for sub-agent / tool-call scopes). */
+	static createForConnection(connectionNodeId, sequence) {
+		return `iter_${connectionNodeId}_${sequence}`;
+	}
+};
+
 //#endregion
 //#region src/workflow/definition/WorkflowExecutableNodeClassifier.ts
 /**
@@ -342,6 +365,40 @@ var WorkflowExecutableNodeClassifierFactory = class {
 	}
 };
 
+//#endregion
+//#region src/events/ConnectionInvocationEventPublisher.ts
+/**
+* Publishes per-invocation lifecycle records onto the run {@link RunEventBus}.
+*
+* Surgical, per-invocation events let the UI update the right-side inspector
+* timeline as each LLM round / tool call transitions through `running` → `completed`
+* (or `failed`) without depending on a coarse `runSaved` poll.
+*/
+var ConnectionInvocationEventPublisher = class {
+	constructor(eventBus, parent) {
+		this.eventBus = eventBus;
+		this.parent = parent;
+	}
+	async publish(record) {
+		if (!this.eventBus) return;
+		const kind = this.kindFor(record);
+		if (!kind) return;
+		await this.eventBus.publish({
+			kind,
+			runId: record.runId,
+			workflowId: record.workflowId,
+			parent: this.parent,
+			at: record.updatedAt,
+			record
+		});
+	}
+	kindFor(record) {
+		if (record.status === "running" || record.status === "queued") return "connectionInvocationStarted";
+		if (record.status === "completed") return "connectionInvocationCompleted";
+		if (record.status === "failed") return "connectionInvocationFailed";
+	}
+};
+
 //#endregion
 //#region src/events/NodeEventPublisher.ts
 /** Publishes node lifecycle snapshots onto the run {@link RunEventBus}. */
@@ -362,6 +419,15 @@ var NodeEventPublisher = class {
 	}
 };
 
+//#endregion
+//#region \0@oxc-project+runtime@0.95.0/helpers/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
 //#endregion
 //#region src/binaries/DefaultNodeBinaryAttachmentServiceFactory.ts
 var DefaultNodeBinaryAttachmentService = class DefaultNodeBinaryAttachmentService {
@@ -660,6 +726,54 @@ var ActivationEnqueueService = class {
 	}
 };
 
+//#endregion
+//#region \0@oxc-project+runtime@0.95.0/helpers/decorateMetadata.js
+function __decorateMetadata(k, v) {
+	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.95.0/helpers/decorateParam.js
+function __decorateParam(paramIndex, decorator) {
+	return function(target, key) {
+		decorator(target, key, paramIndex);
+	};
+}
+
+//#endregion
+//#region src/execution/ChildExecutionScopeFactory.ts
+let ChildExecutionScopeFactory = class ChildExecutionScopeFactory$1 {
+	constructor(activationIdFactory) {
+		this.activationIdFactory = activationIdFactory;
+	}
+	forSubAgent(args) {
+		const childActivationId = this.activationIdFactory.makeActivationId();
+		const childTelemetry = args.parentSpan.asNodeTelemetry({
+			nodeId: args.childNodeId,
+			activationId: childActivationId
+		});
+		const childBinary = args.parentCtx.binary.forNode({
+			nodeId: args.childNodeId,
+			activationId: childActivationId
+		});
+		return {
+			...args.parentCtx,
+			nodeId: args.childNodeId,
+			activationId: childActivationId,
+			config: args.childConfig,
+			telemetry: childTelemetry,
+			binary: childBinary,
+			parentInvocationId: args.parentInvocationId,
+			iterationId: void 0
+		};
+	}
+};
+ChildExecutionScopeFactory = __decorate([
+	(0, tsyringe.injectable)(),
+	__decorateParam(0, (0, tsyringe.inject)(CoreTokens.ActivationIdFactory)),
+	__decorateMetadata("design:paramtypes", [Object])
+], ChildExecutionScopeFactory);
+
 //#endregion
 //#region src/contracts/itemMeta.ts
 /**
@@ -960,31 +1074,54 @@ var NoOpTelemetryArtifactReference = class {
 
 //#endregion
 //#region src/contracts/NoOpTelemetrySpanScope.ts
+/**
+* Standalone no-op {@link NodeExecutionTelemetry} value used as the return for `asNodeTelemetry`.
+*
+* Defined here (instead of in `NoOpNodeExecutionTelemetry.ts`) so that {@link NoOpTelemetrySpanScope}
+* can return it without importing the other module — both no-ops share this leaf.
+*/
+const noOpNodeExecutionTelemetry = {
+	traceId: "00000000000000000000000000000000",
+	spanId: "0000000000000000",
+	addSpanEvent(_) {},
+	recordMetric(_) {},
+	attachArtifact(_) {
+		return NoOpTelemetryArtifactReference.value;
+	},
+	end(_ = {}) {},
+	asNodeTelemetry(_) {
+		return noOpNodeExecutionTelemetry;
+	},
+	forNode(_) {
+		return noOpNodeExecutionTelemetry;
+	},
+	startChildSpan(_) {
+		return noOpTelemetrySpanScope;
+	}
+};
+const noOpTelemetrySpanScope = {
+	traceId: "00000000000000000000000000000000",
+	spanId: "0000000000000000",
+	addSpanEvent(_) {},
+	recordMetric(_) {},
+	attachArtifact(_) {
+		return NoOpTelemetryArtifactReference.value;
+	},
+	end(_ = {}) {},
+	asNodeTelemetry(_) {
+		return noOpNodeExecutionTelemetry;
+	}
+};
 var NoOpTelemetrySpanScope = class {
-	static value = {
-		traceId: "00000000000000000000000000000000",
-		spanId: "0000000000000000",
-		addSpanEvent(_) {},
-		recordMetric(_) {},
-		attachArtifact(_) {
-			return NoOpTelemetryArtifactReference.value;
-		},
-		end(_ = {}) {}
-	};
+	static value = noOpTelemetrySpanScope;
+	/** Internal: the shared no-op {@link NodeExecutionTelemetry} that {@link NoOpNodeExecutionTelemetry} re-exposes. */
+	static nodeExecutionTelemetryValue = noOpNodeExecutionTelemetry;
 };
 
 //#endregion
 //#region src/contracts/NoOpNodeExecutionTelemetry.ts
-var NoOpNodeExecutionTelemetry = class NoOpNodeExecutionTelemetry {
-	static value = {
-		...NoOpTelemetrySpanScope.value,
-		forNode(_) {
-			return NoOpNodeExecutionTelemetry.value;
-		},
-		startChildSpan(_) {
-			return NoOpTelemetrySpanScope.value;
-		}
-	};
+var NoOpNodeExecutionTelemetry = class {
+	static value = NoOpTelemetrySpanScope.nodeExecutionTelemetryValue;
 };
 
 //#endregion
@@ -1025,6 +1162,12 @@ var CodemationTelemetryAttributeNames = class {
 	static connectionInvocationId = "codemation.connection.invocation_id";
 	static toolName = "codemation.tool.name";
 	static traceParentRunId = "codemation.parent.run.id";
+	/** Per-item iteration that emitted this span/metric. Set on spans recorded inside a runnable per-item loop. */
+	static iterationId = "codemation.iteration.id";
+	/** Item index (0-based) of the iteration. */
+	static iterationIndex = "codemation.iteration.index";
+	/** Set when this span/metric was recorded under a sub-agent triggered by an outer LLM/tool call. */
+	static parentInvocationId = "codemation.parent.invocation_id";
 };
 
 //#endregion
@@ -1118,6 +1261,13 @@ var ExecutionTelemetryCostTrackingDecoratorFactory = class {
 					telemetry: nodeTelemetry,
 					costTracking: args.costTracking.forScope(nodeTelemetry)
 				});
+			},
+			asNodeTelemetry: (rescope) => {
+				const nodeTelemetry = args.telemetry.asNodeTelemetry(rescope);
+				return this.decorateNodeExecutionTelemetry({
+					telemetry: nodeTelemetry,
+					costTracking: args.costTracking.forScope(nodeTelemetry)
+				});
 			}
 		};
 	}
@@ -1129,7 +1279,14 @@ var ExecutionTelemetryCostTrackingDecoratorFactory = class {
 			addSpanEvent: (event) => args.scope.addSpanEvent(event),
 			recordMetric: (metric) => args.scope.recordMetric(metric),
 			attachArtifact: (artifact) => args.scope.attachArtifact(artifact),
-			end: (endArgs) => args.scope.end(endArgs)
+			end: (endArgs) => args.scope.end(endArgs),
+			asNodeTelemetry: (rescope) => {
+				const nodeTelemetry = args.scope.asNodeTelemetry(rescope);
+				return this.decorateNodeExecutionTelemetry({
+					telemetry: nodeTelemetry,
+					costTracking: args.costTracking.forScope(nodeTelemetry)
+				});
+			}
 		};
 	}
 };
@@ -1600,13 +1757,17 @@ var NodeExecutor = class {
 			const parsed = inputSchema.parse(item.json);
 			const runnableCtx = request.ctx;
 			const resolvedCtx = await this.itemExprResolver.resolveConfigForItem(runnableCtx, item, i, inputBatch);
-			const ctx = this.pickExecutionContext(runnableCtx, resolvedCtx);
+			const iterationCtx = {
+				...this.pickExecutionContext(runnableCtx, resolvedCtx),
+				iterationId: NodeIterationIdFactory.create(),
+				itemIndex: i
+			};
 			const args = {
 				input: parsed,
 				item,
 				itemIndex: i,
 				items: inputBatch,
-				ctx
+				ctx: iterationCtx
 			};
 			const raw = await Promise.resolve(node$1.execute(args));
 			const normalized = this.outputNormalizer.normalizeExecuteResult({
@@ -2025,12 +2186,13 @@ var NodeInstanceFactoryFactory = class {
 //#region src/execution/NodeRunStateWriter.ts
 var NodeRunStateWriter = class {
 	chain = Promise.resolve();
-	constructor(workflowExecutionRepository, runId, workflowId, parent, publishNodeEvent) {
+	constructor(workflowExecutionRepository, runId, workflowId, parent, publishNodeEvent, publishConnectionInvocationEvent) {
 		this.workflowExecutionRepository = workflowExecutionRepository;
 		this.runId = runId;
 		this.workflowId = workflowId;
 		this.parent = parent;
 		this.publishNodeEvent = publishNodeEvent;
+		this.publishConnectionInvocationEvent = publishConnectionInvocationEvent;
 	}
 	markQueued(args) {
 		return this.enqueue(async () => {
@@ -2127,12 +2289,16 @@ var NodeRunStateWriter = class {
 				queuedAt: args.queuedAt,
 				startedAt: args.startedAt,
 				finishedAt: args.finishedAt,
-				updatedAt
+				updatedAt,
+				iterationId: args.iterationId,
+				itemIndex: args.itemIndex,
+				parentInvocationId: args.parentInvocationId
 			};
 			await this.workflowExecutionRepository.save({
 				...state,
 				connectionInvocations: [...state.connectionInvocations ?? [], record]
 			});
+			if (this.publishConnectionInvocationEvent) await this.publishConnectionInvocationEvent(record);
 		});
 	}
 	enqueue(work) {
@@ -2159,13 +2325,17 @@ var NodeRunStateWriter = class {
 //#endregion
 //#region src/execution/NodeRunStateWriterFactory.ts
 var NodeRunStateWriterFactory = class {
-	constructor(workflowExecutionRepository, nodeEventPublisher) {
+	constructor(workflowExecutionRepository, nodeEventPublisher, eventBus) {
 		this.workflowExecutionRepository = workflowExecutionRepository;
 		this.nodeEventPublisher = nodeEventPublisher;
+		this.eventBus = eventBus;
 	}
 	create(runId, workflowId, parent) {
+		const connectionInvocationEventPublisher = new ConnectionInvocationEventPublisher(this.eventBus, parent);
 		return new NodeRunStateWriter(this.workflowExecutionRepository, runId, workflowId, parent, async (kind, snapshot) => {
 			await this.nodeEventPublisher.publish(kind, snapshot);
+		}, async (record) => {
+			await connectionInvocationEventPublisher.publish(record);
 		});
 	}
 };
@@ -4986,7 +5156,7 @@ var EngineFactory = class {
 		const waiters = new EngineWaiters();
 		const credentialResolverFactory = new CredentialResolverFactory(deps.credentialSessions);
 		const nodeEventPublisher = new NodeEventPublisher(deps.eventBus);
-		const nodeStatePublisherFactory = new NodeRunStateWriterFactory(deps.workflowExecutionRepository, nodeEventPublisher);
+		const nodeStatePublisherFactory = new NodeRunStateWriterFactory(deps.workflowExecutionRepository, nodeEventPublisher, deps.eventBus);
 		const planningFactory = new EngineWorkflowPlanningFactory(deps.workflowNodeInstanceFactory);
 		const executionLimitsPolicy = deps.executionLimitsPolicy ?? new EngineExecutionLimitsPolicy();
 		const workflowSnapshotCodec = deps.workflowSnapshotCodec ?? new WorkflowSnapshotCodec(deps.tokenRegistry);
@@ -5309,6 +5479,12 @@ Object.defineProperty(exports, 'CatalogBackedCostTrackingTelemetryFactory', {
     return CatalogBackedCostTrackingTelemetryFactory;
   }
 });
+Object.defineProperty(exports, 'ChildExecutionScopeFactory', {
+  enumerable: true,
+  get: function () {
+    return ChildExecutionScopeFactory;
+  }
+});
 Object.defineProperty(exports, 'CodemationTelemetryAttributeNames', {
   enumerable: true,
   get: function () {
@@ -5327,6 +5503,12 @@ Object.defineProperty(exports, 'ConfigDrivenOffloadPolicy', {
     return ConfigDrivenOffloadPolicy;
   }
 });
+Object.defineProperty(exports, 'ConnectionInvocationEventPublisher', {
+  enumerable: true,
+  get: function () {
+    return ConnectionInvocationEventPublisher;
+  }
+});
 Object.defineProperty(exports, 'ConnectionNodeIdFactory', {
   enumerable: true,
   get: function () {
@@ -5579,6 +5761,12 @@ Object.defineProperty(exports, 'NodeInstanceFactoryFactory', {
     return NodeInstanceFactoryFactory;
   }
 });
+Object.defineProperty(exports, 'NodeIterationIdFactory', {
+  enumerable: true,
+  get: function () {
+    return NodeIterationIdFactory;
+  }
+});
 Object.defineProperty(exports, 'NodeOutputNormalizer', {
   enumerable: true,
   get: function () {
@@ -5705,6 +5893,12 @@ Object.defineProperty(exports, 'WorkflowStoragePolicyEvaluator', {
     return WorkflowStoragePolicyEvaluator;
   }
 });
+Object.defineProperty(exports, '__decorate', {
+  enumerable: true,
+  get: function () {
+    return __decorate;
+  }
+});
 Object.defineProperty(exports, '__toESM', {
   enumerable: true,
   get: function () {
@@ -5795,4 +5989,4 @@ Object.defineProperty(exports, 'tool', {
     return tool;
   }
 });
-//# sourceMappingURL=runtime-DWKfb0BI.cjs.map
+//# sourceMappingURL=runtime-B3Og-_St.cjs.map