@codemation/host 1.0.1 → 1.0.2

package/dist/{CodemationAppContext-DP_-56c6.d.ts → CodemationAppContext-YgJRUHWF.d.ts}

@@ -1,4 +1,4 @@
-import { G as EngineExecutionLimitsPolicyConfig, I as WorkflowDefinition, U as Container, W as TypeToken, l as AnyCredentialType } from "./index-W4eSjdCM.js";
+import { G as EngineExecutionLimitsPolicyConfig, I as WorkflowDefinition, U as Container, W as TypeToken, l as AnyCredentialType } from "./index-BxIc_L4D.js";
 import { a as CodemationAuthConfig, n as CodemationLogConfig, t as CodemationWhitelabelConfig, u as LoggerFactory } from "./CodemationWhitelabelConfig-D5rYcLlj.js";
 
 //#region src/presentation/config/CodemationClassToken.d.ts
@@ -177,4 +177,4 @@ interface CodemationAppContext extends CodemationRegistrationContextBase {
 }
 //#endregion
 export { CodemationContainerRegistration as C, CodemationWorkflowDiscovery as S, CodemationEngineExecutionLimitsConfig as _, AppPluginLoadSummary as a, CodemationSchedulerConfig as b, CodemationPluginContext as c, CodemationAppSchedulerConfig as d, CodemationAppSchedulerKind as f, CodemationDatabaseKind as g, CodemationDatabaseConfig as h, AppPersistenceConfig as i, CodemationPluginPackageMetadata as l, CodemationConfig as m, CodemationRegistrationContextBase as n, CodemationPlugin as o, CodemationApplicationRuntimeConfig as p, AppConfig as r, CodemationPluginConfig as s, CodemationAppContext as t, CodemationAppDefinition as u, CodemationEventBusConfig as v, CodemationClassToken as w, CodemationSchedulerKind as x, CodemationEventBusKind as y };
-//# sourceMappingURL=CodemationAppContext-DP_-56c6.d.ts.map
+//# sourceMappingURL=CodemationAppContext-YgJRUHWF.d.ts.map

package/dist/{CodemationAuthoring.types-Cr2QZsUX.d.ts → CodemationAuthoring.types-lUdxXYq-.d.ts}

@@ -1,5 +1,5 @@
-import { A as Items, F as RunnableNodeOutputJson, I as WorkflowDefinition, J as ChainCursor, P as RunnableNodeConfig, W as TypeToken, Y as AnyRunnableNodeConfig, a as ChatModelConfig, c as DefinedNodeConfigInput, g as CredentialJsonRecord, i as AgentMessageConfig, k as Item, l as AnyCredentialType, o as ToolConfig, r as AgentGuardrailConfig, s as DefinedNode, z as NodeExecutionContext } from "./index-W4eSjdCM.js";
-import { c as CodemationPluginContext, m as CodemationConfig, o as CodemationPlugin, t as CodemationAppContext } from "./CodemationAppContext-DP_-56c6.js";
+import { A as Items, F as RunnableNodeOutputJson, I as WorkflowDefinition, J as ChainCursor, P as RunnableNodeConfig, W as TypeToken, Y as AnyRunnableNodeConfig, a as ChatModelConfig, c as DefinedNodeConfigInput, g as CredentialJsonRecord, i as AgentMessageConfig, k as Item, l as AnyCredentialType, o as ToolConfig, r as AgentGuardrailConfig, s as DefinedNode, z as NodeExecutionContext } from "./index-BxIc_L4D.js";
+import { c as CodemationPluginContext, m as CodemationConfig, o as CodemationPlugin, t as CodemationAppContext } from "./CodemationAppContext-YgJRUHWF.js";
 import { t as CodemationWhitelabelConfig } from "./CodemationWhitelabelConfig-D5rYcLlj.js";
 import { ZodType, z } from "zod";
 import "ai";
@@ -261,4 +261,4 @@ declare function definePlugin(options: DefinePluginOptions): CodemationPlugin &
 }>;
 //#endregion
 export { defineCodemationApp as a, FriendlyCodemationExecutionConfig as i, DefinePluginOptions as n, definePlugin as o, FriendlyCodemationDatabaseConfig as r, workflow as s, DefineCodemationAppOptions as t };
-//# sourceMappingURL=CodemationAuthoring.types-Cr2QZsUX.d.ts.map
+//# sourceMappingURL=CodemationAuthoring.types-lUdxXYq-.d.ts.map

package/dist/{CodemationConfigNormalizer-B8RGUwAe.d.ts → CodemationConfigNormalizer-BWBp7mFB.d.ts}

@@ -1,4 +1,4 @@
-import { C as CodemationContainerRegistration, m as CodemationConfig } from "./CodemationAppContext-DP_-56c6.js";
+import { C as CodemationContainerRegistration, m as CodemationConfig } from "./CodemationAppContext-YgJRUHWF.js";
 
 //#region src/presentation/config/CodemationConfigNormalizer.d.ts
 type NormalizedCodemationConfig = CodemationConfig & Readonly<{
@@ -6,4 +6,4 @@ type NormalizedCodemationConfig = CodemationConfig & Readonly<{
 }>;
 //#endregion
 export { NormalizedCodemationConfig as t };
-//# sourceMappingURL=CodemationConfigNormalizer-B8RGUwAe.d.ts.map
+//# sourceMappingURL=CodemationConfigNormalizer-BWBp7mFB.d.ts.map

package/dist/{CodemationConsumerConfigLoader-C_QVwcI3.d.ts → CodemationConsumerConfigLoader-Bka3v6lh.d.ts}

@@ -1,4 +1,4 @@
-import { t as NormalizedCodemationConfig } from "./CodemationConfigNormalizer-B8RGUwAe.js";
+import { t as NormalizedCodemationConfig } from "./CodemationConfigNormalizer-BWBp7mFB.js";
 
 //#region src/presentation/server/CodemationConsumerAppResolver.d.ts
 type CodemationConsumerApp = Readonly<{
@@ -63,4 +63,4 @@ declare class CodemationConsumerConfigLoader {
 }
 //#endregion
 export { CodemationConsumerAppResolver as i, CodemationConsumerConfigResolution as n, CodemationConsumerApp as r, CodemationConsumerConfigLoader as t };
-//# sourceMappingURL=CodemationConsumerConfigLoader-C_QVwcI3.d.ts.map
+//# sourceMappingURL=CodemationConsumerConfigLoader-Bka3v6lh.d.ts.map

package/dist/{CodemationPluginListMerger-Bgn1CIX9.d.ts → CodemationPluginListMerger-Oz-GAkxz.d.ts}

@@ -1,9 +1,9 @@
-import { $ as PersistedRunState, B as NodeExecutionRequestHandler, H as WorkflowRepository, I as WorkflowDefinition, K as RunEvent, L as WorkflowId, M as RunId, Q as WorkflowRunDetailDto, R as BinaryStorage, U as Container, V as NodeExecutionScheduler, W as TypeToken, X as WorkflowActivationPolicy, at as TelemetryMetricRecord, et as RunCurrentState, it as TelemetryAttributes, j as PersistedRunPolicySnapshot, l as AnyCredentialType, n as Engine, nt as RunSummary, ot as TelemetrySpanEventRecord, q as RunEventBus, rt as TelemetryArtifactAttachment, st as Clock, tt as RunPruneCandidate } from "./index-W4eSjdCM.js";
-import { C as CodemationContainerRegistration, l as CodemationPluginPackageMetadata, o as CodemationPlugin, r as AppConfig } from "./CodemationAppContext-DP_-56c6.js";
+import { $ as TelemetryArtifactAttachment, B as NodeExecutionRequestHandler, H as WorkflowRepository, I as WorkflowDefinition, K as RunEvent, L as WorkflowId, M as RunId, Q as WorkflowRunDetailDto, R as BinaryStorage, U as Container, V as NodeExecutionScheduler, W as TypeToken, X as WorkflowActivationPolicy, at as RunPruneCandidate, et as TelemetryAttributes, it as RunCurrentState, j as PersistedRunPolicySnapshot, l as AnyCredentialType, n as Engine, nt as TelemetrySpanEventRecord, ot as RunSummary, q as RunEventBus, rt as PersistedRunState, st as Clock, tt as TelemetryMetricRecord } from "./index-BxIc_L4D.js";
+import { C as CodemationContainerRegistration, l as CodemationPluginPackageMetadata, o as CodemationPlugin, r as AppConfig } from "./CodemationAppContext-YgJRUHWF.js";
 import { a as CodemationAuthConfig, l as Logger, t as CodemationWhitelabelConfig, u as LoggerFactory } from "./CodemationWhitelabelConfig-D5rYcLlj.js";
 import { t as LogLevelPolicy } from "./LogLevelPolicy-CkiJAH75.js";
-import { t as CredentialStore } from "./CredentialServices-95DPogx-.js";
-import { n as PrismaMigrationDeployer, r as PrismaDatabaseClient } from "./AppConfigFactory-PFmDg5Sg.js";
+import { t as CredentialStore } from "./CredentialServices-CKXPg5xu.js";
+import { n as PrismaMigrationDeployer, r as PrismaDatabaseClient } from "./AppConfigFactory-D3k-R3Ch.js";
 import "reflect-metadata";
 import { Hono } from "hono";
 
@@ -197,6 +197,9 @@ interface TelemetrySpanRecord {
   readonly attributes?: TelemetryAttributes;
   readonly events?: ReadonlyArray<TelemetrySpanEventRecord>;
   readonly retentionExpiresAt?: string;
+  readonly iterationId?: string;
+  readonly itemIndex?: number;
+  readonly parentInvocationId?: string;
 }
 interface TelemetrySpanUpsert {
   readonly traceId: string;
@@ -220,6 +223,9 @@ interface TelemetrySpanUpsert {
   readonly attributes?: TelemetryAttributes;
   readonly events?: ReadonlyArray<TelemetrySpanEventRecord>;
   readonly retentionExpiresAt?: string;
+  readonly iterationId?: string;
+  readonly itemIndex?: number;
+  readonly parentInvocationId?: string;
 }
 interface TelemetryArtifactRecord {
   readonly artifactId: string;
@@ -268,6 +274,9 @@ interface TelemetryMetricPointRecord {
   readonly modelName?: string;
   readonly dimensions?: TelemetryAttributes;
   readonly retentionExpiresAt?: string;
+  readonly iterationId?: string;
+  readonly itemIndex?: number;
+  readonly parentInvocationId?: string;
 }
 interface TelemetryMetricPointWrite extends TelemetryMetricRecord {
   readonly traceId?: string;
@@ -282,6 +291,9 @@ interface TelemetryMetricPointWrite extends TelemetryMetricRecord {
   readonly nodeRole?: string;
   readonly modelName?: string;
   readonly retentionExpiresAt?: string;
+  readonly iterationId?: string;
+  readonly itemIndex?: number;
+  readonly parentInvocationId?: string;
 }
 interface TelemetrySpanListQuery {
   readonly traceId?: string;
@@ -671,4 +683,4 @@ declare class CodemationPluginListMerger {
 }
 //#endregion
 export { Command as S, AppContainerFactory as _, WorkflowDebuggerOverlayRepository as a, Query as b, FrontendRuntime as c, LogLevelPolicyFactory as d, logLevelPolicyFactory as f, AppContainerLifecycle as g, DatabaseMigrations as h, HonoApiRouteRegistrar as i, WorkflowRunRetentionPruneScheduler as l, WorkflowRunRepository as m, CodemationBootstrapRequest as n, SessionVerifier as o, LogFilter as p, ApplicationTokens as r, WorkerRuntime as s, CodemationPluginListMerger as t, ServerLoggerFactory as u, WorkflowWebsocketServer as v, CommandBus as x, QueryBus as y };
-//# sourceMappingURL=CodemationPluginListMerger-Bgn1CIX9.d.ts.map
+//# sourceMappingURL=CodemationPluginListMerger-Oz-GAkxz.d.ts.map

package/dist/{CredentialServices-95DPogx-.d.ts → CredentialServices-CKXPg5xu.d.ts}

@@ -1,5 +1,5 @@
-import { C as CredentialType, E as CredentialTypeRegistry, H as WorkflowRepository, I as WorkflowDefinition, S as CredentialSetupStatus, T as CredentialTypeId, _ as CredentialMaterialSourceKind, d as CredentialBindingKey, f as CredentialFieldSchema, g as CredentialJsonRecord, h as CredentialInstanceRecord, l as AnyCredentialType, m as CredentialInstanceId, p as CredentialHealth, u as CredentialBinding, v as CredentialOAuth2AuthDefinition, w as CredentialTypeDefinition, x as CredentialSessionService, y as CredentialRequirement } from "./index-W4eSjdCM.js";
-import { r as AppConfig } from "./CodemationAppContext-DP_-56c6.js";
+import { C as CredentialType, E as CredentialTypeRegistry, H as WorkflowRepository, I as WorkflowDefinition, S as CredentialSetupStatus, T as CredentialTypeId, _ as CredentialMaterialSourceKind, d as CredentialBindingKey, f as CredentialFieldSchema, g as CredentialJsonRecord, h as CredentialInstanceRecord, l as AnyCredentialType, m as CredentialInstanceId, p as CredentialHealth, u as CredentialBinding, v as CredentialOAuth2AuthDefinition, w as CredentialTypeDefinition, x as CredentialSessionService, y as CredentialRequirement } from "./index-BxIc_L4D.js";
+import { r as AppConfig } from "./CodemationAppContext-YgJRUHWF.js";
 
 //#region src/domain/credentials/CredentialTypeRegistryImpl.d.ts
 declare class CredentialTypeRegistryImpl implements CredentialTypeRegistry {
@@ -298,4 +298,4 @@ type MutableCredentialSessionService = CredentialSessionService & Readonly<{
 }>;
 //#endregion
 export { CredentialInstanceService as a, CredentialSecretCipher as c, CredentialBindingService as i, CredentialFieldEnvOverlayService as l, CredentialType$1 as n, CredentialOAuth2ScopeResolver as o, CredentialRuntimeMaterialService as r, CredentialMaterialResolver as s, CredentialStore as t, CredentialTypeRegistryImpl as u };
-//# sourceMappingURL=CredentialServices-95DPogx-.d.ts.map
+//# sourceMappingURL=CredentialServices-CKXPg5xu.d.ts.map

package/dist/{PublicFrontendBootstrapFactory-C_iLgPV-.d.ts → PublicFrontendBootstrapFactory-DkQoSYDo.d.ts}

@@ -1,4 +1,4 @@
-import { r as AppConfig } from "./CodemationAppContext-DP_-56c6.js";
+import { r as AppConfig } from "./CodemationAppContext-YgJRUHWF.js";
 import { a as CodemationAuthConfig } from "./CodemationWhitelabelConfig-D5rYcLlj.js";
 import { a as CodemationFrontendAuthSnapshot, n as InternalAuthBootstrap, r as FrontendAppConfig, t as PublicFrontendBootstrap } from "./PublicFrontendBootstrap-ci0Vwxrb.js";
 
@@ -90,4 +90,4 @@ declare class PublicFrontendBootstrapFactory {
 }
 //#endregion
 export { WorkflowDto as a, CodemationFrontendAuthSnapshotFactory as i, InternalAuthBootstrapFactory as n, WorkflowSummary as o, FrontendAppConfigFactory as r, PublicFrontendBootstrapFactory as t };
-//# sourceMappingURL=PublicFrontendBootstrapFactory-C_iLgPV-.d.ts.map
+//# sourceMappingURL=PublicFrontendBootstrapFactory-DkQoSYDo.d.ts.map

package/dist/authoring.d.ts

@@ -1,5 +1,5 @@
-import "./index-W4eSjdCM.js";
-import { a as defineCodemationApp, i as FriendlyCodemationExecutionConfig, n as DefinePluginOptions, o as definePlugin, r as FriendlyCodemationDatabaseConfig, s as workflow, t as DefineCodemationAppOptions } from "./CodemationAuthoring.types-Cr2QZsUX.js";
-import { _ as CodemationEngineExecutionLimitsConfig, b as CodemationSchedulerConfig, c as CodemationPluginContext, d as CodemationAppSchedulerConfig, f as CodemationAppSchedulerKind, g as CodemationDatabaseKind, h as CodemationDatabaseConfig, m as CodemationConfig, n as CodemationRegistrationContextBase, o as CodemationPlugin, p as CodemationApplicationRuntimeConfig, s as CodemationPluginConfig, t as CodemationAppContext, u as CodemationAppDefinition, v as CodemationEventBusConfig, x as CodemationSchedulerKind, y as CodemationEventBusKind } from "./CodemationAppContext-DP_-56c6.js";
+import "./index-BxIc_L4D.js";
+import { a as defineCodemationApp, i as FriendlyCodemationExecutionConfig, n as DefinePluginOptions, o as definePlugin, r as FriendlyCodemationDatabaseConfig, s as workflow, t as DefineCodemationAppOptions } from "./CodemationAuthoring.types-lUdxXYq-.js";
+import { _ as CodemationEngineExecutionLimitsConfig, b as CodemationSchedulerConfig, c as CodemationPluginContext, d as CodemationAppSchedulerConfig, f as CodemationAppSchedulerKind, g as CodemationDatabaseKind, h as CodemationDatabaseConfig, m as CodemationConfig, n as CodemationRegistrationContextBase, o as CodemationPlugin, p as CodemationApplicationRuntimeConfig, s as CodemationPluginConfig, t as CodemationAppContext, u as CodemationAppDefinition, v as CodemationEventBusConfig, x as CodemationSchedulerKind, y as CodemationEventBusKind } from "./CodemationAppContext-YgJRUHWF.js";
 import "./CodemationWhitelabelConfig-D5rYcLlj.js";
 export { type CodemationAppContext, type CodemationAppDefinition, type CodemationAppSchedulerConfig, type CodemationAppSchedulerKind, type CodemationApplicationRuntimeConfig, type CodemationConfig, type CodemationDatabaseConfig, type CodemationDatabaseKind, type CodemationEngineExecutionLimitsConfig, type CodemationEventBusConfig, type CodemationEventBusKind, type CodemationPlugin, type CodemationPluginConfig, type CodemationPluginContext, type CodemationRegistrationContextBase, type CodemationSchedulerConfig, type CodemationSchedulerKind, type DefineCodemationAppOptions, type DefinePluginOptions, type FriendlyCodemationDatabaseConfig, type FriendlyCodemationExecutionConfig, defineCodemationApp, definePlugin, workflow };

package/dist/consumer.d.ts

@@ -1,6 +1,6 @@
-import "./index-W4eSjdCM.js";
-import "./CodemationAppContext-DP_-56c6.js";
+import "./index-BxIc_L4D.js";
+import "./CodemationAppContext-YgJRUHWF.js";
 import "./CodemationWhitelabelConfig-D5rYcLlj.js";
-import "./CodemationConfigNormalizer-B8RGUwAe.js";
-import { i as CodemationConsumerAppResolver, n as CodemationConsumerConfigResolution, r as CodemationConsumerApp, t as CodemationConsumerConfigLoader } from "./CodemationConsumerConfigLoader-C_QVwcI3.js";
+import "./CodemationConfigNormalizer-BWBp7mFB.js";
+import { i as CodemationConsumerAppResolver, n as CodemationConsumerConfigResolution, r as CodemationConsumerApp, t as CodemationConsumerConfigLoader } from "./CodemationConsumerConfigLoader-Bka3v6lh.js";
 export { type CodemationConsumerApp, CodemationConsumerAppResolver, CodemationConsumerConfigLoader, type CodemationConsumerConfigResolution };

package/dist/credentials.d.ts

@@ -1,7 +1,7 @@
-import { b as CredentialSessionFactoryArgs, l as AnyCredentialType, p as CredentialHealth } from "./index-W4eSjdCM.js";
-import "./CodemationAppContext-DP_-56c6.js";
+import { b as CredentialSessionFactoryArgs, l as AnyCredentialType, p as CredentialHealth } from "./index-BxIc_L4D.js";
+import "./CodemationAppContext-YgJRUHWF.js";
 import "./CodemationWhitelabelConfig-D5rYcLlj.js";
-import { a as CredentialInstanceService, i as CredentialBindingService, n as CredentialType } from "./CredentialServices-95DPogx-.js";
+import { a as CredentialInstanceService, i as CredentialBindingService, n as CredentialType } from "./CredentialServices-CKXPg5xu.js";
 
 //#region src/infrastructure/credentials/OpenAiApiKeyCredentialShapes.types.d.ts
 /**

package/dist/devServerSidecar.d.ts

@@ -1,4 +1,4 @@
-import { I as WorkflowDefinition, U as Container } from "./index-W4eSjdCM.js";
+import { I as WorkflowDefinition, U as Container } from "./index-BxIc_L4D.js";
 
 //#region src/presentation/server/CodemationTsyringeParamInfoReader.d.ts
 declare class CodemationTsyringeParamInfoReader {

package/dist/{index-W4eSjdCM.d.ts → index-BxIc_L4D.d.ts}

@@ -9,155 +9,6 @@ interface Clock {
   now(): Date;
 }
 //#endregion
-//#region ../core/src/contracts/itemExpr.d.ts
-declare const ITEM_EXPR_BRAND: unique symbol;
-type ItemExprResolvedContext = Readonly<{
-  runId: RunId;
-  workflowId: WorkflowId;
-  nodeId: NodeId;
-  activationId: NodeActivationId;
-  data: RunDataSnapshot;
-}>;
-/**
- * Context aligned with former {@link ItemInputMapperContext} — use **`data`** to read any completed upstream node.
- */
-type ItemExprContext = ItemExprResolvedContext;
-type ItemExprArgs<TItemJson = unknown> = Readonly<{
-  item: Item<TItemJson>;
-  itemIndex: number;
-  items: Items<TItemJson>;
-  ctx: ItemExprContext;
-}>;
-type ItemExprCallback<T, TItemJson = unknown> = (args: ItemExprArgs<TItemJson>) => T | Promise<T>;
-type ItemExpr<T, TItemJson = unknown> = Readonly<{
-  readonly [ITEM_EXPR_BRAND]: true;
-  readonly fn: ItemExprCallback<T, TItemJson>;
-}>;
-//#endregion
-//#region ../core/src/contracts/params.d.ts
-type Expr<T, TItemJson = unknown> = ItemExpr<T, TItemJson>;
-type ParamDeep<T, TItemJson = unknown> = Expr<T, TItemJson> | (T extends readonly (infer U)[] ? ReadonlyArray<ParamDeep<U, TItemJson>> : never) | (T extends object ? { [K in keyof T]: ParamDeep<T[K], TItemJson> } : T);
-//#endregion
-//#region ../core/src/contracts/retryPolicySpec.types.d.ts
-/**
- * In-process retry policy for runnable nodes. Serialized configs use the same
- * `kind` discriminator (`JSON.stringify` / persisted workflows).
- *
- * `maxAttempts` is the total number of tries including the first (e.g. 3 means up to 2 delays after failures).
- */
-type RetryPolicySpec = NoneRetryPolicySpec | FixedRetryPolicySpec | ExponentialRetryPolicySpec;
-interface NoneRetryPolicySpec {
-  readonly kind: "none";
-}
-interface FixedRetryPolicySpec {
-  readonly kind: "fixed";
-  /** Total attempts including the first execution. Must be >= 1. */
-  readonly maxAttempts: number;
-  readonly delayMs: number;
-}
-interface ExponentialRetryPolicySpec {
-  readonly kind: "exponential";
-  /** Total attempts including the first execution. Must be >= 1. */
-  readonly maxAttempts: number;
-  readonly initialDelayMs: number;
-  readonly multiplier: number;
-  readonly maxDelayMs?: number;
-  /** When true, each delay is multiplied by a random factor in [1, 1.2). */
-  readonly jitter?: boolean;
-}
-//#endregion
-//#region ../core/src/contracts/telemetryTypes.d.ts
-type TelemetryAttributePrimitive = string | number | boolean | null;
-interface TelemetryAttributes {
-  readonly [key: string]: TelemetryAttributePrimitive | undefined;
-}
-interface TelemetryMetricRecord {
-  readonly name: string;
-  readonly value: number;
-  readonly unit?: string;
-  readonly attributes?: TelemetryAttributes;
-}
-interface TelemetrySpanEventRecord {
-  readonly name: string;
-  readonly occurredAt?: Date;
-  readonly attributes?: TelemetryAttributes;
-}
-interface TelemetryArtifactAttachment {
-  readonly kind: string;
-  readonly contentType: string;
-  readonly previewText?: string;
-  readonly previewJson?: JsonValue;
-  readonly payloadText?: string;
-  readonly payloadJson?: JsonValue;
-  readonly bytes?: number;
-  readonly truncated?: boolean;
-  readonly expiresAt?: Date;
-}
-interface TelemetryArtifactReference {
-  readonly artifactId: string;
-  readonly traceId?: string;
-  readonly spanId?: string;
-}
-interface TelemetrySpanEnd {
-  readonly status?: "ok" | "error";
-  readonly statusMessage?: string;
-  readonly endedAt?: Date;
-  readonly attributes?: TelemetryAttributes;
-}
-interface TelemetryChildSpanStart {
-  readonly name: string;
-  readonly kind?: "internal" | "client";
-  readonly startedAt?: Date;
-  readonly attributes?: TelemetryAttributes;
-}
-interface TelemetryScope {
-  readonly traceId?: string;
-  readonly spanId?: string;
-  readonly costTracking?: CostTrackingTelemetry;
-  addSpanEvent(args: TelemetrySpanEventRecord): Promise<void> | void;
-  recordMetric(args: TelemetryMetricRecord): Promise<void> | void;
-  attachArtifact(args: TelemetryArtifactAttachment): Promise<TelemetryArtifactReference> | TelemetryArtifactReference;
-}
-interface TelemetrySpanScope extends TelemetryScope {
-  readonly traceId: string;
-  readonly spanId: string;
-  end(args?: TelemetrySpanEnd): Promise<void> | void;
-}
-interface NodeExecutionTelemetry extends ExecutionTelemetry, TelemetrySpanScope {
-  startChildSpan(args: TelemetryChildSpanStart): TelemetrySpanScope;
-}
-interface ExecutionTelemetry extends TelemetryScope {
-  readonly traceId: string;
-  readonly spanId: string;
-  forNode(args: Readonly<{
-    nodeId: NodeId;
-    activationId: NodeActivationId;
-  }>): NodeExecutionTelemetry;
-}
-//#endregion
-//#region ../core/src/contracts/CostTrackingTelemetryContract.d.ts
-type CostTrackingComponent = "chat" | "ocr" | "rag";
-interface CostTrackingUsageRecord {
-  readonly component: CostTrackingComponent;
-  readonly provider: string;
-  readonly operation: string;
-  readonly pricingKey: string;
-  readonly usageUnit: string;
-  readonly quantity: number;
-  readonly modelName?: string;
-  readonly attributes?: TelemetryAttributes;
-}
-interface CostTrackingPriceQuote {
-  readonly currency: string;
-  readonly currencyScale: number;
-  readonly estimatedAmountMinor: number;
-  readonly estimateKind: "catalog";
-}
-interface CostTrackingTelemetry {
-  captureUsage(args: CostTrackingUsageRecord): Promise<CostTrackingPriceQuote | undefined>;
-  forScope(scope: TelemetryScope): CostTrackingTelemetry;
-}
-//#endregion
 //#region ../core/src/contracts/runTypes.d.ts
 interface RunExecutionOptions {
   /** Run-intent override: force the inline scheduler and bypass node-level offload decisions. */
@@ -279,6 +130,12 @@ interface ConnectionInvocationRecord {
   readonly startedAt?: string;
   readonly finishedAt?: string;
   readonly updatedAt: string;
+  /** Per-item iteration id minted by the engine when this invocation occurred inside a runnable node's per-item loop. */
+  readonly iterationId?: NodeIterationId;
+  /** Item index (0-based) of the iteration that produced this invocation. */
+  readonly itemIndex?: number;
+  /** When set, this invocation was produced inside a sub-agent triggered by the named parent invocation. */
+  readonly parentInvocationId?: ConnectionInvocationId;
 }
 /** Arguments for appending a {@link ConnectionInvocationRecord} (engine fills run/workflow ids and timestamps). */
 type ConnectionInvocationAppendArgs = Readonly<{
@@ -293,6 +150,9 @@ type ConnectionInvocationAppendArgs = Readonly<{
   queuedAt?: string;
   startedAt?: string;
   finishedAt?: string;
+  iterationId?: NodeIterationId;
+  itemIndex?: number;
+  parentInvocationId?: ConnectionInvocationId;
 }>;
 interface RunCurrentState {
   outputsByNode: Record<NodeId, NodeOutputs>;
@@ -424,6 +284,166 @@ interface PersistedWorkflowTokenRegistryLike {
   registerFromWorkflows?(workflows: ReadonlyArray<WorkflowDefinition>): void;
 }
 //#endregion
+//#region ../core/src/contracts/itemExpr.d.ts
+declare const ITEM_EXPR_BRAND: unique symbol;
+type ItemExprResolvedContext = Readonly<{
+  runId: RunId;
+  workflowId: WorkflowId;
+  nodeId: NodeId;
+  activationId: NodeActivationId;
+  data: RunDataSnapshot;
+}>;
+/**
+ * Context aligned with former {@link ItemInputMapperContext} — use **`data`** to read any completed upstream node.
+ */
+type ItemExprContext = ItemExprResolvedContext;
+type ItemExprArgs<TItemJson = unknown> = Readonly<{
+  item: Item<TItemJson>;
+  itemIndex: number;
+  items: Items<TItemJson>;
+  ctx: ItemExprContext;
+}>;
+type ItemExprCallback<T, TItemJson = unknown> = (args: ItemExprArgs<TItemJson>) => T | Promise<T>;
+type ItemExpr<T, TItemJson = unknown> = Readonly<{
+  readonly [ITEM_EXPR_BRAND]: true;
+  readonly fn: ItemExprCallback<T, TItemJson>;
+}>;
+//#endregion
+//#region ../core/src/contracts/params.d.ts
+type Expr<T, TItemJson = unknown> = ItemExpr<T, TItemJson>;
+type ParamDeep<T, TItemJson = unknown> = Expr<T, TItemJson> | (T extends readonly (infer U)[] ? ReadonlyArray<ParamDeep<U, TItemJson>> : never) | (T extends object ? { [K in keyof T]: ParamDeep<T[K], TItemJson> } : T);
+//#endregion
+//#region ../core/src/contracts/retryPolicySpec.types.d.ts
+/**
+ * In-process retry policy for runnable nodes. Serialized configs use the same
+ * `kind` discriminator (`JSON.stringify` / persisted workflows).
+ *
+ * `maxAttempts` is the total number of tries including the first (e.g. 3 means up to 2 delays after failures).
+ */
+type RetryPolicySpec = NoneRetryPolicySpec | FixedRetryPolicySpec | ExponentialRetryPolicySpec;
+interface NoneRetryPolicySpec {
+  readonly kind: "none";
+}
+interface FixedRetryPolicySpec {
+  readonly kind: "fixed";
+  /** Total attempts including the first execution. Must be >= 1. */
+  readonly maxAttempts: number;
+  readonly delayMs: number;
+}
+interface ExponentialRetryPolicySpec {
+  readonly kind: "exponential";
+  /** Total attempts including the first execution. Must be >= 1. */
+  readonly maxAttempts: number;
+  readonly initialDelayMs: number;
+  readonly multiplier: number;
+  readonly maxDelayMs?: number;
+  /** When true, each delay is multiplied by a random factor in [1, 1.2). */
+  readonly jitter?: boolean;
+}
+//#endregion
+//#region ../core/src/contracts/telemetryTypes.d.ts
+type TelemetryAttributePrimitive = string | number | boolean | null;
+interface TelemetryAttributes {
+  readonly [key: string]: TelemetryAttributePrimitive | undefined;
+}
+interface TelemetryMetricRecord {
+  readonly name: string;
+  readonly value: number;
+  readonly unit?: string;
+  readonly attributes?: TelemetryAttributes;
+}
+interface TelemetrySpanEventRecord {
+  readonly name: string;
+  readonly occurredAt?: Date;
+  readonly attributes?: TelemetryAttributes;
+}
+interface TelemetryArtifactAttachment {
+  readonly kind: string;
+  readonly contentType: string;
+  readonly previewText?: string;
+  readonly previewJson?: JsonValue;
+  readonly payloadText?: string;
+  readonly payloadJson?: JsonValue;
+  readonly bytes?: number;
+  readonly truncated?: boolean;
+  readonly expiresAt?: Date;
+}
+interface TelemetryArtifactReference {
+  readonly artifactId: string;
+  readonly traceId?: string;
+  readonly spanId?: string;
+}
+interface TelemetrySpanEnd {
+  readonly status?: "ok" | "error";
+  readonly statusMessage?: string;
+  readonly endedAt?: Date;
+  readonly attributes?: TelemetryAttributes;
+}
+interface TelemetryChildSpanStart {
+  readonly name: string;
+  readonly kind?: "internal" | "client";
+  readonly startedAt?: Date;
+  readonly attributes?: TelemetryAttributes;
+}
+interface TelemetryScope {
+  readonly traceId?: string;
+  readonly spanId?: string;
+  readonly costTracking?: CostTrackingTelemetry;
+  addSpanEvent(args: TelemetrySpanEventRecord): Promise<void> | void;
+  recordMetric(args: TelemetryMetricRecord): Promise<void> | void;
+  attachArtifact(args: TelemetryArtifactAttachment): Promise<TelemetryArtifactReference> | TelemetryArtifactReference;
+}
+interface TelemetrySpanScope extends TelemetryScope {
+  readonly traceId: string;
+  readonly spanId: string;
+  end(args?: TelemetrySpanEnd): Promise<void> | void;
+  /**
+   * Lift this span into a {@link NodeExecutionTelemetry} scoped to a different (nodeId, activationId).
+   * Children created via the returned telemetry's `startChildSpan` get this span as their parent.
+   *
+   * Used at the sub-agent boundary so that nested runtime telemetry parents under the agent.tool.call
+   * span instead of the orchestrator's node-level span.
+   */
+  asNodeTelemetry(args: Readonly<{
+    nodeId: NodeId;
+    activationId: NodeActivationId;
+  }>): NodeExecutionTelemetry;
+}
+interface NodeExecutionTelemetry extends ExecutionTelemetry, TelemetrySpanScope {
+  startChildSpan(args: TelemetryChildSpanStart): TelemetrySpanScope;
+}
+interface ExecutionTelemetry extends TelemetryScope {
+  readonly traceId: string;
+  readonly spanId: string;
+  forNode(args: Readonly<{
+    nodeId: NodeId;
+    activationId: NodeActivationId;
+  }>): NodeExecutionTelemetry;
+}
+//#endregion
+//#region ../core/src/contracts/CostTrackingTelemetryContract.d.ts
+type CostTrackingComponent = "chat" | "ocr" | "rag";
+interface CostTrackingUsageRecord {
+  readonly component: CostTrackingComponent;
+  readonly provider: string;
+  readonly operation: string;
+  readonly pricingKey: string;
+  readonly usageUnit: string;
+  readonly quantity: number;
+  readonly modelName?: string;
+  readonly attributes?: TelemetryAttributes;
+}
+interface CostTrackingPriceQuote {
+  readonly currency: string;
+  readonly currencyScale: number;
+  readonly estimatedAmountMinor: number;
+  readonly estimateKind: "catalog";
+}
+interface CostTrackingTelemetry {
+  captureUsage(args: CostTrackingUsageRecord): Promise<CostTrackingPriceQuote | undefined>;
+  forScope(scope: TelemetryScope): CostTrackingTelemetry;
+}
+//#endregion
 //#region ../core/src/contracts/executionPersistenceContracts.d.ts
 /** Canonical id for persisted execution rows (activation or connection invocation). */
 type ExecutionInstanceId = string;
@@ -441,6 +461,29 @@ interface WorkflowRunDetailDto {
   readonly mutableState?: PersistedMutableRunState;
   readonly slotStates: ReadonlyArray<SlotExecutionStateDto>;
   readonly executionInstances: ReadonlyArray<ExecutionInstanceDto>;
+  readonly iterations?: ReadonlyArray<RunIterationDto>;
+}
+/**
+ * Per-item iteration projected from connection invocations and node activations.
+ *
+ * One iteration = one item processed by an agent within an activation. Multiple invocations
+ * (LLM rounds, tool calls) belonging to the same iteration share the iterationId.
+ */
+interface RunIterationDto {
+  readonly iterationId: string;
+  readonly agentNodeId: NodeId;
+  readonly activationId: NodeActivationId;
+  readonly itemIndex: number;
+  readonly itemSummary?: string;
+  readonly status: NodeExecutionStatus;
+  readonly startedAt?: string;
+  readonly finishedAt?: string;
+  readonly invocationIds: ReadonlyArray<string>;
+  readonly parentInvocationId?: string;
+  /** Estimated cost rolled up from telemetry cost metric points, keyed by ISO currency code (e.g. "USD"). Values are minor units (cents-of-cents per the metric's `cost.currency_scale`). */
+  readonly estimatedCostMinorByCurrency?: Readonly<Record<string, number>>;
+  /** Currency scale (denominator) per currency, when present on the metric points. Joined with `estimatedCostMinorByCurrency` to format human-readable amounts. */
+  readonly estimatedCostCurrencyScaleByCurrency?: Readonly<Record<string, number>>;
 }
 interface SlotExecutionStateDto {
   readonly slotNodeId: NodeId;
@@ -469,6 +512,12 @@ interface ExecutionInstanceDto {
   readonly inputJson?: JsonValue;
   readonly outputJson?: JsonValue;
   readonly error?: Readonly<NodeExecutionError>;
+  /** Per-item iteration that produced this instance. Set on connectionInvocation rows produced inside per-item runnable loops. */
+  readonly iterationId?: string;
+  /** Item index (0-based) of the iteration. */
+  readonly itemIndex?: number;
+  /** Parent invocation id when this instance was emitted by a sub-agent triggered by an outer LLM/tool call. */
+  readonly parentInvocationId?: string;
 }
 //#endregion
 //#region ../core/src/contracts/webhookTypes.d.ts
@@ -625,6 +674,27 @@ type RunEvent = Readonly<{
   parent?: ParentExecutionRef;
   at: string;
   snapshot: NodeExecutionSnapshot;
+}> | Readonly<{
+  kind: "connectionInvocationStarted";
+  runId: RunId;
+  workflowId: WorkflowId;
+  parent?: ParentExecutionRef;
+  at: string;
+  record: ConnectionInvocationRecord;
+}> | Readonly<{
+  kind: "connectionInvocationCompleted";
+  runId: RunId;
+  workflowId: WorkflowId;
+  parent?: ParentExecutionRef;
+  at: string;
+  record: ConnectionInvocationRecord;
+}> | Readonly<{
+  kind: "connectionInvocationFailed";
+  runId: RunId;
+  workflowId: WorkflowId;
+  parent?: ParentExecutionRef;
+  at: string;
+  record: ConnectionInvocationRecord;
 }>;
 interface RunEventSubscription {
   close(): Promise<void>;
@@ -735,6 +805,12 @@ interface ExecutionContext {
   telemetry: ExecutionTelemetry;
   binary: ExecutionBinaryService;
   getCredential<TSession = unknown>(slotKey: string): Promise<TSession>;
+  /** Per-item iteration id, set by {@link NodeExecutor} on the ctx passed into runnable `execute`. */
+  iterationId?: NodeIterationId;
+  /** Item index (0-based) within the current activation's batch; set alongside {@link iterationId}. */
+  itemIndex?: number;
+  /** When set, this ctx is executing inside a sub-agent triggered by the named parent invocation. */
+  parentInvocationId?: ConnectionInvocationId;
 }
 interface NodeExecutionContext<TConfig$1 extends NodeConfigBase = NodeConfigBase> extends ExecutionContext {
   nodeId: NodeId;
@@ -948,6 +1024,12 @@ type Items<TJson = unknown> = ReadonlyArray<Item<TJson>>;
 type NodeOutputs = Partial<Record<OutputPortKey, Items>>;
 type RunId = string;
 type NodeActivationId = string;
+/**
+ * One per-item iteration of a runnable node's execute loop. Refines `NodeActivationId` for
+ * per-item connection invocations and telemetry. Undefined when the executing node is a batch
+ * node or trigger that does not iterate items.
+ */
+type NodeIterationId = string;
 interface ParentExecutionRef {
   runId: RunId;
   workflowId: WorkflowId;
@@ -1493,5 +1575,5 @@ declare class RunIntentService {
   private createWebhookExecutionOptions;
 }
 //#endregion
-export { PersistedRunState as $, Items as A, NodeExecutionRequestHandler as B, CredentialType as C, ActivationIdFactory as D, CredentialTypeRegistry as E, RunnableNodeOutputJson as F, EngineExecutionLimitsPolicyConfig as G, WorkflowRepository as H, WorkflowDefinition as I, ChainCursor as J, RunEvent as K, WorkflowId as L, RunId as M, RunIdFactory as N, BinaryAttachment as O, RunnableNodeConfig as P, WorkflowRunDetailDto as Q, BinaryStorage as R, CredentialSetupStatus as S, CredentialTypeId as T, Container as U, NodeExecutionScheduler as V, TypeToken as W, WorkflowActivationPolicy as X, AnyRunnableNodeConfig as Y, WebhookInvocationMatch as Z, CredentialMaterialSourceKind as _, ChatModelConfig as a, TelemetryMetricRecord as at, CredentialSessionFactoryArgs as b, DefinedNodeConfigInput as c, CredentialBindingKey as d, RunCurrentState as et, CredentialFieldSchema as f, CredentialJsonRecord as g, CredentialInstanceRecord as h, AgentMessageConfig as i, TelemetryAttributes as it, PersistedRunPolicySnapshot as j, Item as k, AnyCredentialType as l, CredentialInstanceId as m, Engine as n, RunSummary as nt, ToolConfig as o, TelemetrySpanEventRecord as ot, CredentialHealth as p, RunEventBus as q, AgentGuardrailConfig as r, TelemetryArtifactAttachment as rt, DefinedNode as s, Clock as st, RunIntentService as t, RunPruneCandidate as tt, CredentialBinding as u, CredentialOAuth2AuthDefinition as v, CredentialTypeDefinition as w, CredentialSessionService as x, CredentialRequirement as y, NodeExecutionContext as z };
-//# sourceMappingURL=index-W4eSjdCM.d.ts.map
+export { TelemetryArtifactAttachment as $, Items as A, NodeExecutionRequestHandler as B, CredentialType as C, ActivationIdFactory as D, CredentialTypeRegistry as E, RunnableNodeOutputJson as F, EngineExecutionLimitsPolicyConfig as G, WorkflowRepository as H, WorkflowDefinition as I, ChainCursor as J, RunEvent as K, WorkflowId as L, RunId as M, RunIdFactory as N, BinaryAttachment as O, RunnableNodeConfig as P, WorkflowRunDetailDto as Q, BinaryStorage as R, CredentialSetupStatus as S, CredentialTypeId as T, Container as U, NodeExecutionScheduler as V, TypeToken as W, WorkflowActivationPolicy as X, AnyRunnableNodeConfig as Y, WebhookInvocationMatch as Z, CredentialMaterialSourceKind as _, ChatModelConfig as a, RunPruneCandidate as at, CredentialSessionFactoryArgs as b, DefinedNodeConfigInput as c, CredentialBindingKey as d, TelemetryAttributes as et, CredentialFieldSchema as f, CredentialJsonRecord as g, CredentialInstanceRecord as h, AgentMessageConfig as i, RunCurrentState as it, PersistedRunPolicySnapshot as j, Item as k, AnyCredentialType as l, CredentialInstanceId as m, Engine as n, TelemetrySpanEventRecord as nt, ToolConfig as o, RunSummary as ot, CredentialHealth as p, RunEventBus as q, AgentGuardrailConfig as r, PersistedRunState as rt, DefinedNode as s, Clock as st, RunIntentService as t, TelemetryMetricRecord as tt, CredentialBinding as u, CredentialOAuth2AuthDefinition as v, CredentialTypeDefinition as w, CredentialSessionService as x, CredentialRequirement as y, NodeExecutionContext as z };
+//# sourceMappingURL=index-BxIc_L4D.d.ts.map