@codemation/core 0.8.1 → 1.0.1

package/dist/{runtime-DUW6tIJ1.js → runtime-284ok0cm.js}

@@ -1,7 +1,7 @@
 import "reflect-metadata";
 import { container as container$1, delay, inject, injectAll, injectable, instanceCachingFactory, instancePerContainerCachingFactory, predicateAwareClassFactory, registry, singleton } from "tsyringe";
 import { ZodError, z } from "zod";
-import { createHash } from "node:crypto";
+import { createHash, randomUUID } from "node:crypto";
 import { ReadableStream } from "node:stream/web";
 
 //#region src/di/CoreTokens.ts
@@ -255,6 +255,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_${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
 /**
@@ -315,6 +338,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}. */
@@ -335,6 +392,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 {
@@ -633,6 +699,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([
+	injectable(),
+	__decorateParam(0, inject(CoreTokens.ActivationIdFactory)),
+	__decorateMetadata("design:paramtypes", [Object])
+], ChildExecutionScopeFactory);
+
 //#endregion
 //#region src/contracts/itemMeta.ts
 /**
@@ -933,31 +1047,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
@@ -998,6 +1135,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
@@ -1091,6 +1234,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)
+				});
 			}
 		};
 	}
@@ -1102,7 +1252,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)
+				});
+			}
 		};
 	}
 };
@@ -1573,13 +1730,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({
@@ -1998,12 +2159,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 () => {
@@ -2100,12 +2262,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) {
@@ -2132,13 +2298,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);
 		});
 	}
 };
@@ -3599,7 +3769,7 @@ var RunStartService = class {
 		return {
 			outputsByNode: { ...currentState?.outputsByNode ?? {} },
 			nodeSnapshotsByNodeId: { ...currentState?.nodeSnapshotsByNodeId ?? {} },
-			connectionInvocations: currentState?.connectionInvocations ? [...currentState.connectionInvocations] : void 0,
+			connectionInvocations: [],
 			mutableState: mutableState ?? currentState?.mutableState
 		};
 	}
@@ -4959,7 +5129,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);
@@ -5270,5 +5440,5 @@ var WorkflowRepositoryWebhookTriggerMatcherFactory = class {
 };
 
 //#endregion
-export { CostTrackingTelemetryMetricNames as $, NodeExecutor as A, inject as At, nodeRef as B, StaticCostCatalog as C, tool as Ct, PersistedWorkflowTokenRegistry as D, PersistedRuntimeTypeNameResolver as Dt, WorkflowSnapshotCodec as E, StackTraceCallSitePathResolver as Et, InProcessRetryRunner as F, predicateAwareClassFactory as Ft, NoOpExecutionTelemetryFactory as G, CodemationTelemetryMetricNames as H, CatalogBackedCostTrackingTelemetryFactory as I, registry as It, NoOpTelemetrySpanScope as J, NoOpExecutionTelemetry as K, DefaultExecutionContextFactory as L, singleton as Lt, RunnableOutputBehaviorResolver as M, injectable as Mt, NodeOutputNormalizer as N, instanceCachingFactory as Nt, MissingRuntimeTriggerToken as O, container$1 as Ot, ItemExprResolver as P, instancePerContainerCachingFactory as Pt, CostTrackingTelemetryAttributeNames as Q, AllWorkflowsActiveWorkflowActivationPolicy as R, CoreTokens as Rt, RunPolicySnapshotFactory as S, node as St, NodeInstanceFactory as T, PersistedRuntimeTypeMetadataStore as Tt, GenAiTelemetryAttributeNames as U, RunFinishedAtFactory as V, CodemationTelemetryAttributeNames as W, NoOpCostTrackingTelemetryFactory as X, NoOpTelemetryArtifactReference as Y, NoOpCostTrackingTelemetry as Z, LocalOnlyScheduler as _, itemExpr as _t, InMemoryLiveWorkflowRepository as a, isPortsEmission as at, DefaultDrivingScheduler as b, chatModel as bt, EngineFactory as c, CredentialResolverFactory as ct, InMemoryBinaryStorage as d, UnavailableBinaryStorage as dt, CredentialUnboundError as et, WorkflowStoragePolicyEvaluator as f, NodeEventPublisher as ft, EngineExecutionLimitsPolicy as g, isItemExpr as gt, ENGINE_EXECUTION_LIMITS_DEFAULTS as h, ConnectionNodeIdFactory as ht, RunIntentService as i, emitPorts as it, InProcessRetryRunnerFactory as j, injectAll as jt, NodeExecutorFactory as k, delay as kt, Engine as l, getOriginIndexFromItem as lt, RunTerminalPersistenceCoordinator as m, WorkflowExecutableNodeClassifier as mt, WorkflowRepositoryWebhookTriggerMatcher as n, RetryPolicy as nt, EngineWorkflowRunnerServiceFactory as o, isUnbrandedPortsEmissionShape as ot, WorkflowPolicyErrorServices as p, WorkflowExecutableNodeClassifierFactory as pt, NoOpNodeExecutionTelemetry as q, RunIntentServiceFactory as r, NoRetryPolicy as rt, EngineWorkflowRunnerService as s, DefaultAsyncSleeper as st, WorkflowRepositoryWebhookTriggerMatcherFactory as t, ExpRetryPolicy as tt, InMemoryRunDataFactory as u, DefaultExecutionBinaryService as ut, InlineDrivingScheduler as v, resolveItemExprsForExecution as vt, NodeInstanceFactoryFactory as w, InjectableRuntimeDecoratorComposer as wt, ConfigDrivenOffloadPolicy as x, getPersistedRuntimeTypeMetadata as xt, HintOnlyOffloadPolicy as y, resolveItemExprsInUnknown as yt, branchRef as z };
-//# sourceMappingURL=runtime-DUW6tIJ1.js.map
+export { CostTrackingTelemetryMetricNames as $, NodeExecutor as A, StackTraceCallSitePathResolver as At, nodeRef as B, registry as Bt, StaticCostCatalog as C, resolveItemExprsInUnknown as Ct, PersistedWorkflowTokenRegistry as D, tool as Dt, WorkflowSnapshotCodec as E, node as Et, InProcessRetryRunner as F, injectAll as Ft, NoOpExecutionTelemetryFactory as G, CodemationTelemetryMetricNames as H, CoreTokens as Ht, CatalogBackedCostTrackingTelemetryFactory as I, injectable as It, NoOpTelemetrySpanScope as J, NoOpExecutionTelemetry as K, DefaultExecutionContextFactory as L, instanceCachingFactory as Lt, RunnableOutputBehaviorResolver as M, container$1 as Mt, NodeOutputNormalizer as N, delay as Nt, MissingRuntimeTriggerToken as O, InjectableRuntimeDecoratorComposer as Ot, ItemExprResolver as P, inject as Pt, CostTrackingTelemetryAttributeNames as Q, AllWorkflowsActiveWorkflowActivationPolicy as R, instancePerContainerCachingFactory as Rt, RunPolicySnapshotFactory as S, resolveItemExprsForExecution as St, NodeInstanceFactory as T, getPersistedRuntimeTypeMetadata as Tt, GenAiTelemetryAttributeNames as U, RunFinishedAtFactory as V, singleton as Vt, CodemationTelemetryAttributeNames as W, NoOpCostTrackingTelemetryFactory as X, NoOpTelemetryArtifactReference as Y, NoOpCostTrackingTelemetry as Z, LocalOnlyScheduler as _, WorkflowExecutableNodeClassifier as _t, InMemoryLiveWorkflowRepository as a, isPortsEmission as at, DefaultDrivingScheduler as b, isItemExpr as bt, EngineFactory as c, CredentialResolverFactory as ct, InMemoryBinaryStorage as d, DefaultExecutionBinaryService as dt, CredentialUnboundError as et, WorkflowStoragePolicyEvaluator as f, UnavailableBinaryStorage as ft, EngineExecutionLimitsPolicy as g, WorkflowExecutableNodeClassifierFactory as gt, ENGINE_EXECUTION_LIMITS_DEFAULTS as h, ConnectionInvocationEventPublisher as ht, RunIntentService as i, emitPorts as it, InProcessRetryRunnerFactory as j, PersistedRuntimeTypeNameResolver as jt, NodeExecutorFactory as k, PersistedRuntimeTypeMetadataStore as kt, Engine as l, getOriginIndexFromItem as lt, RunTerminalPersistenceCoordinator as m, NodeEventPublisher as mt, WorkflowRepositoryWebhookTriggerMatcher as n, RetryPolicy as nt, EngineWorkflowRunnerServiceFactory as o, isUnbrandedPortsEmissionShape as ot, WorkflowPolicyErrorServices as p, __decorate as pt, NoOpNodeExecutionTelemetry as q, RunIntentServiceFactory as r, NoRetryPolicy as rt, EngineWorkflowRunnerService as s, DefaultAsyncSleeper as st, WorkflowRepositoryWebhookTriggerMatcherFactory as t, ExpRetryPolicy as tt, InMemoryRunDataFactory as u, ChildExecutionScopeFactory as ut, InlineDrivingScheduler as v, NodeIterationIdFactory as vt, NodeInstanceFactoryFactory as w, chatModel as wt, ConfigDrivenOffloadPolicy as x, itemExpr as xt, HintOnlyOffloadPolicy as y, ConnectionNodeIdFactory as yt, branchRef as z, predicateAwareClassFactory as zt };
+//# sourceMappingURL=runtime-284ok0cm.js.map