@epilot/sdk 2.8.0-rc.0 → 2.8.1

package/dist/{automation.d-Du6-uiz5.d.ts → automation.d-DS_YXDE8.d.ts}

@@ -55,6 +55,7 @@ declare namespace Components {
              * Result of the condition evaluation
              */
             evaluationResult?: boolean;
+            error_output?: ErrorOutput;
             statements?: /**
              * example:
              * {
@@ -670,6 +671,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
             execution_status?: ExecutionStatus;
             started_at?: string;
             updated_at?: string;
@@ -682,6 +688,11 @@ declare namespace Components {
             };
             error_output?: ErrorOutput;
             retry_strategy?: /* different behaviors for retrying failed execution actions. */ RetryStrategy;
+            /**
+             * For looped actions, an archive of completed iterations. The action's own execution_status / outputs / error_output always reflect the current (latest) iteration. The previous iteration's state is pushed here before the action is reset for the next pass.
+             *
+             */
+            iterations?: /* A snapshot of a single completed pass through a looped action. */ AutomationActionIteration[];
         }
         export interface AssignThreadConfig {
             /**
@@ -768,6 +779,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
             execution_status?: ExecutionStatus;
             started_at?: string;
             updated_at?: string;
@@ -780,6 +796,11 @@ declare namespace Components {
             };
             error_output?: ErrorOutput;
             retry_strategy?: /* different behaviors for retrying failed execution actions. */ RetryStrategy;
+            /**
+             * For looped actions, an archive of completed iterations. The action's own execution_status / outputs / error_output always reflect the current (latest) iteration. The previous iteration's state is pushed here before the action is reset for the next pass.
+             *
+             */
+            iterations?: /* A snapshot of a single completed pass through a looped action. */ AutomationActionIteration[];
         }
         export interface AutomationActionConfig {
             id?: /**
@@ -831,6 +852,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
         }
         export interface AutomationActionExecutionState {
             execution_status?: ExecutionStatus;
@@ -845,12 +871,33 @@ declare namespace Components {
             };
             error_output?: ErrorOutput;
             retry_strategy?: /* different behaviors for retrying failed execution actions. */ RetryStrategy;
+            /**
+             * For looped actions, an archive of completed iterations. The action's own execution_status / outputs / error_output always reflect the current (latest) iteration. The previous iteration's state is pushed here before the action is reset for the next pass.
+             *
+             */
+            iterations?: /* A snapshot of a single completed pass through a looped action. */ AutomationActionIteration[];
         }
         /**
          * example:
          * 9ec3711b-db63-449c-b894-54d5bb622a8f
          */
         export type AutomationActionId = string;
+        /**
+         * A snapshot of a single completed pass through a looped action.
+         */
+        export interface AutomationActionIteration {
+            /**
+             * Zero-based iteration index within the loop scope.
+             */
+            index: number;
+            execution_status: ExecutionStatus;
+            started_at?: string; // date-time
+            ended_at?: string; // date-time
+            outputs?: {
+                [name: string]: any;
+            };
+            error_output?: ErrorOutput;
+        }
         export interface AutomationExecution {
             id: /**
              * example:
@@ -917,6 +964,18 @@ declare namespace Components {
             version?: number;
             trigger_event?: TriggerEventManual | TriggerEventEntityActivity | TriggerEventEntityOperation | TriggerEventFlowAutomationTask | TriggerEventMessaging;
             workflow_context?: WorkflowExecutionContext;
+            /**
+             * Loop scope definitions propagated from the flow onto the execution record. Each loop has an id and a source_path resolved against the trigger entity at execution time. Actions referencing a loop's id via their loop_id property run once per item in the resolved array.
+             *
+             */
+            loops?: /* A loop scope on an automation flow. */ AutomationLoop[];
+            /**
+             * Runtime iteration state, keyed by loop_id. Tracks the current_index and total for each active loop scope. Entries are removed once a loop exits.
+             *
+             */
+            loop_state?: {
+                [name: string]: AutomationLoopState;
+            };
         }
         /**
          * example:
@@ -971,6 +1030,11 @@ declare namespace Components {
             entity_schema?: string;
             conditions?: ActionCondition[];
             schedules?: ActionSchedule[];
+            /**
+             * Loop scope definitions. Each loop has an id and a source_path resolved against the trigger entity at execution time. Actions referencing a loop's id via their loop_id property run once per item in the resolved array. Loop members must be contiguous in the actions array.
+             *
+             */
+            loops?: /* A loop scope on an automation flow. */ AutomationLoop[];
             /**
              * The actions (nodes) of the automation flow
              */
@@ -1043,6 +1107,38 @@ declare namespace Components {
          * 7791b04a-16d2-44a2-9af9-2d59c25c512f
          */
         export type AutomationFlowId = string;
+        /**
+         * A loop scope on an automation flow.
+         */
+        export interface AutomationLoop {
+            /**
+             * Stable identifier referenced by AutomationActionConfig.loop_id
+             * example:
+             * loop_contracts
+             */
+            id: string;
+            /**
+             * Path resolved against the trigger entity to produce the array of iteration items. e.g. submission.steps[0]['Contracts'].
+             *
+             * example:
+             * submission.steps[0]['Contracts']
+             */
+            source_path: string;
+            /**
+             * How source_path is interpreted. 'journey-multi-select' is the v1 source type (journey card block with multi-select). Future source types (e.g. 'previous-action-outputs', 'entity-relation') will be added here.
+             *
+             */
+            source_type?: "journey-multi-select" | "previous-action-outputs" | "entity-relation";
+            /**
+             * Maximum number of iterations. 0 / omitted = iterate the full resolved array.
+             *
+             */
+            length?: number;
+        }
+        export interface AutomationLoopState {
+            current_index: number;
+            total: number;
+        }
         export interface AutomationTrigger {
             /**
              * example:
@@ -1306,6 +1402,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
             execution_status?: ExecutionStatus;
             started_at?: string;
             updated_at?: string;
@@ -1318,6 +1419,11 @@ declare namespace Components {
             };
             error_output?: ErrorOutput;
             retry_strategy?: /* different behaviors for retrying failed execution actions. */ RetryStrategy;
+            /**
+             * For looped actions, an archive of completed iterations. The action's own execution_status / outputs / error_output always reflect the current (latest) iteration. The previous iteration's state is pushed here before the action is reset for the next pass.
+             *
+             */
+            iterations?: /* A snapshot of a single completed pass through a looped action. */ AutomationActionIteration[];
         }
         /**
          * Creates an order entity with prices from journey
@@ -1370,6 +1476,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
         }
         export interface CartCheckoutConfig {
             /**
@@ -1514,6 +1625,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
             execution_status?: ExecutionStatus;
             started_at?: string;
             updated_at?: string;
@@ -1526,6 +1642,11 @@ declare namespace Components {
             };
             error_output?: ErrorOutput;
             retry_strategy?: /* different behaviors for retrying failed execution actions. */ RetryStrategy;
+            /**
+             * For looped actions, an archive of completed iterations. The action's own execution_status / outputs / error_output always reflect the current (latest) iteration. The previous iteration's state is pushed here before the action is reset for the next pass.
+             *
+             */
+            iterations?: /* A snapshot of a single completed pass through a looped action. */ AutomationActionIteration[];
         }
         /**
          * example:
@@ -1593,6 +1714,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
         }
         export interface CreateDocumentConfig {
             template_id?: string;
@@ -1676,6 +1802,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
             execution_status?: ExecutionStatus;
             started_at?: string;
             updated_at?: string;
@@ -1688,6 +1819,11 @@ declare namespace Components {
             };
             error_output?: ErrorOutput;
             retry_strategy?: /* different behaviors for retrying failed execution actions. */ RetryStrategy;
+            /**
+             * For looped actions, an archive of completed iterations. The action's own execution_status / outputs / error_output always reflect the current (latest) iteration. The previous iteration's state is pushed here before the action is reset for the next pass.
+             *
+             */
+            iterations?: /* A snapshot of a single completed pass through a looped action. */ AutomationActionIteration[];
         }
         export type DiffAdded = FilterConditionOnEvent;
         export type DiffDeleted = FilterConditionOnEvent;
@@ -2234,6 +2370,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
             execution_status?: ExecutionStatus;
             started_at?: string;
             updated_at?: string;
@@ -2246,6 +2387,11 @@ declare namespace Components {
             };
             error_output?: ErrorOutput;
             retry_strategy?: /* different behaviors for retrying failed execution actions. */ RetryStrategy;
+            /**
+             * For looped actions, an archive of completed iterations. The action's own execution_status / outputs / error_output always reflect the current (latest) iteration. The previous iteration's state is pushed here before the action is reset for the next pass.
+             *
+             */
+            iterations?: /* A snapshot of a single completed pass through a looped action. */ AutomationActionIteration[];
         }
         /**
          * example:
@@ -2316,6 +2462,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
         }
         /**
          * Configuration for cancelling a flow execution with selected reasons
@@ -2394,6 +2545,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
             execution_status?: ExecutionStatus;
             started_at?: string;
             updated_at?: string;
@@ -2406,6 +2562,11 @@ declare namespace Components {
             };
             error_output?: ErrorOutput;
             retry_strategy?: /* different behaviors for retrying failed execution actions. */ RetryStrategy;
+            /**
+             * For looped actions, an archive of completed iterations. The action's own execution_status / outputs / error_output always reflect the current (latest) iteration. The previous iteration's state is pushed here before the action is reset for the next pass.
+             *
+             */
+            iterations?: /* A snapshot of a single completed pass through a looped action. */ AutomationActionIteration[];
         }
         /**
          * example:
@@ -2471,6 +2632,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
         }
         export interface ForwardEmailConfig {
             /**
@@ -2570,6 +2736,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
             execution_status?: ExecutionStatus;
             started_at?: string;
             updated_at?: string;
@@ -2582,6 +2753,11 @@ declare namespace Components {
             };
             error_output?: ErrorOutput;
             retry_strategy?: /* different behaviors for retrying failed execution actions. */ RetryStrategy;
+            /**
+             * For looped actions, an archive of completed iterations. The action's own execution_status / outputs / error_output always reflect the current (latest) iteration. The previous iteration's state is pushed here before the action is reset for the next pass.
+             *
+             */
+            iterations?: /* A snapshot of a single completed pass through a looped action. */ AutomationActionIteration[];
         }
         /**
          * example:
@@ -2646,6 +2822,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
         }
         export interface InformERPConfig {
             entity_sources?: string[];
@@ -2720,6 +2901,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
             execution_status?: ExecutionStatus;
             started_at?: string;
             updated_at?: string;
@@ -2732,6 +2918,11 @@ declare namespace Components {
             };
             error_output?: ErrorOutput;
             retry_strategy?: /* different behaviors for retrying failed execution actions. */ RetryStrategy;
+            /**
+             * For looped actions, an archive of completed iterations. The action's own execution_status / outputs / error_output always reflect the current (latest) iteration. The previous iteration's state is pushed here before the action is reset for the next pass.
+             *
+             */
+            iterations?: /* A snapshot of a single completed pass through a looped action. */ AutomationActionIteration[];
         }
         /**
          * example:
@@ -2901,6 +3092,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
         }
         export interface MapEntityConfig {
             mapping_config?: MappingConfigRef;
@@ -3031,6 +3227,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
             execution_status?: ExecutionStatus;
             started_at?: string;
             updated_at?: string;
@@ -3043,6 +3244,11 @@ declare namespace Components {
             };
             error_output?: ErrorOutput;
             retry_strategy?: /* different behaviors for retrying failed execution actions. */ RetryStrategy;
+            /**
+             * For looped actions, an archive of completed iterations. The action's own execution_status / outputs / error_output always reflect the current (latest) iteration. The previous iteration's state is pushed here before the action is reset for the next pass.
+             *
+             */
+            iterations?: /* A snapshot of a single completed pass through a looped action. */ AutomationActionIteration[];
         }
         export interface MoveThreadConfig {
             /**
@@ -3218,6 +3424,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
             execution_status?: ExecutionStatus;
             started_at?: string;
             updated_at?: string;
@@ -3230,6 +3441,11 @@ declare namespace Components {
             };
             error_output?: ErrorOutput;
             retry_strategy?: /* different behaviors for retrying failed execution actions. */ RetryStrategy;
+            /**
+             * For looped actions, an archive of completed iterations. The action's own execution_status / outputs / error_output always reflect the current (latest) iteration. The previous iteration's state is pushed here before the action is reset for the next pass.
+             *
+             */
+            iterations?: /* A snapshot of a single completed pass through a looped action. */ AutomationActionIteration[];
         }
         /**
          * example:
@@ -3292,6 +3508,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
         }
         export interface ReplyEmailConfig {
             /**
@@ -3399,6 +3620,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
             execution_status?: ExecutionStatus;
             started_at?: string;
             updated_at?: string;
@@ -3411,6 +3637,11 @@ declare namespace Components {
             };
             error_output?: ErrorOutput;
             retry_strategy?: /* different behaviors for retrying failed execution actions. */ RetryStrategy;
+            /**
+             * For looped actions, an archive of completed iterations. The action's own execution_status / outputs / error_output always reflect the current (latest) iteration. The previous iteration's state is pushed here before the action is reset for the next pass.
+             *
+             */
+            iterations?: /* A snapshot of a single completed pass through a looped action. */ AutomationActionIteration[];
         }
         /**
          * example:
@@ -3472,6 +3703,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
         }
         export interface SendEmailCondition {
             _equals?: {
@@ -3683,6 +3919,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
             execution_status?: ExecutionStatus;
             started_at?: string;
             updated_at?: string;
@@ -3695,6 +3936,11 @@ declare namespace Components {
             };
             error_output?: ErrorOutput;
             retry_strategy?: /* different behaviors for retrying failed execution actions. */ RetryStrategy;
+            /**
+             * For looped actions, an archive of completed iterations. The action's own execution_status / outputs / error_output always reflect the current (latest) iteration. The previous iteration's state is pushed here before the action is reset for the next pass.
+             *
+             */
+            iterations?: /* A snapshot of a single completed pass through a looped action. */ AutomationActionIteration[];
         }
         /**
          * example:
@@ -3758,6 +4004,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
         }
         /**
          * Configuration for triggering an event catalog event
@@ -3913,6 +4164,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
             execution_status?: ExecutionStatus;
             started_at?: string;
             updated_at?: string;
@@ -3925,6 +4181,11 @@ declare namespace Components {
             };
             error_output?: ErrorOutput;
             retry_strategy?: /* different behaviors for retrying failed execution actions. */ RetryStrategy;
+            /**
+             * For looped actions, an archive of completed iterations. The action's own execution_status / outputs / error_output always reflect the current (latest) iteration. The previous iteration's state is pushed here before the action is reset for the next pass.
+             *
+             */
+            iterations?: /* A snapshot of a single completed pass through a looped action. */ AutomationActionIteration[];
         }
         export interface TriggerShareEntityActionConfig {
             id?: /**
@@ -3974,6 +4235,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
         }
         export interface TriggerShareEntityConfig {
             partner_org_ids?: string[];
@@ -4026,6 +4292,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
             execution_status?: ExecutionStatus;
             started_at?: string;
             updated_at?: string;
@@ -4038,6 +4309,11 @@ declare namespace Components {
             };
             error_output?: ErrorOutput;
             retry_strategy?: /* different behaviors for retrying failed execution actions. */ RetryStrategy;
+            /**
+             * For looped actions, an archive of completed iterations. The action's own execution_status / outputs / error_output always reflect the current (latest) iteration. The previous iteration's state is pushed here before the action is reset for the next pass.
+             *
+             */
+            iterations?: /* A snapshot of a single completed pass through a looped action. */ AutomationActionIteration[];
         }
         /**
          * example:
@@ -4102,6 +4378,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
         }
         export interface TriggerWebhookConfig {
             /**
@@ -4163,6 +4444,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
             execution_status?: ExecutionStatus;
             started_at?: string;
             updated_at?: string;
@@ -4175,6 +4461,11 @@ declare namespace Components {
             };
             error_output?: ErrorOutput;
             retry_strategy?: /* different behaviors for retrying failed execution actions. */ RetryStrategy;
+            /**
+             * For looped actions, an archive of completed iterations. The action's own execution_status / outputs / error_output always reflect the current (latest) iteration. The previous iteration's state is pushed here before the action is reset for the next pass.
+             *
+             */
+            iterations?: /* A snapshot of a single completed pass through a looped action. */ AutomationActionIteration[];
         }
         /**
          * example:
@@ -4258,6 +4549,11 @@ declare namespace Components {
              * Schedule Id which indicates the schedule of the action
              */
             schedule_id?: string;
+            /**
+             * Id of a loop scope defined on the parent flow. When set, the action runs once per item resolved from the loop's source_path. All actions sharing the same loop_id must be contiguous in the actions array.
+             *
+             */
+            loop_id?: string;
         }
         /**
          * example:
@@ -5166,10 +5462,13 @@ type AutomationAction = Components.Schemas.AutomationAction;
 type AutomationActionConfig = Components.Schemas.AutomationActionConfig;
 type AutomationActionExecutionState = Components.Schemas.AutomationActionExecutionState;
 type AutomationActionId = Components.Schemas.AutomationActionId;
+type AutomationActionIteration = Components.Schemas.AutomationActionIteration;
 type AutomationExecution = Components.Schemas.AutomationExecution;
 type AutomationExecutionId = Components.Schemas.AutomationExecutionId;
 type AutomationFlow = Components.Schemas.AutomationFlow;
 type AutomationFlowId = Components.Schemas.AutomationFlowId;
+type AutomationLoop = Components.Schemas.AutomationLoop;
+type AutomationLoopState = Components.Schemas.AutomationLoopState;
 type AutomationTrigger = Components.Schemas.AutomationTrigger;
 type BulkTriggerJob = Components.Schemas.BulkTriggerJob;
 type BulkTriggerRequest = Components.Schemas.BulkTriggerRequest;
@@ -5280,4 +5579,4 @@ type WildcardCondition = Components.Schemas.WildcardCondition;
 type WorkflowContextRole = Components.Schemas.WorkflowContextRole;
 type WorkflowExecutionContext = Components.Schemas.WorkflowExecutionContext;
 
-export { type EqualsIgnoreCaseCondition as $, type ActionCondition as A, type BulkTriggerJob as B, type Client as C, type CancellationReason as D, type CartCheckoutAction as E, type CartCheckoutActionConfig as F, type CartCheckoutConfig as G, type Comparison as H, type ConditionStatement as I, type CopyValueMapper as J, type CreateDocumentAction as K, type CreateDocumentActionConfig as L, type CreateDocumentConfig as M, type CustomAction as N, type OperationMethods as O, Paths as P, type DiffAdded as Q, type DiffDeleted as R, type DiffUpdated as S, type EntityId as T, type EntityItemSnapshot as U, type EntityManualTrigger as V, type EntityOperation as W, type EntityOperationTrigger as X, type EntityRef as Y, type EntitySearchFilter as Z, type EntitySearchFilterValue as _, Components as a, type TriggerEventActionConfig as a$, type ErrorCode as a0, type ErrorDetail as a1, type ErrorObject as a2, type ErrorOutput as a3, type ExecItem as a4, type ExecutionChain as a5, type ExecutionStatus as a6, type ExistsCondition as a7, type FilterConditionOnEvent as a8, type FlowExecutionCancelAction as a9, type OrCondition as aA, type OrConditionForDiff as aB, type OrganizationId as aC, type PatchBulkJobRequest as aD, type PrefixCondition as aE, type PrimitiveJSONValue as aF, type ReceivedEmailTrigger as aG, type RelationAttribute as aH, type ReplyEmailAction as aI, type ReplyEmailActionConfig as aJ, type ReplyEmailConfig as aK, type ResumeReq as aL, type ResumeResp as aM, type ResumeToken as aN, type RetryReq as aO, type RetryStrategy as aP, type SearchAutomationsResp as aQ, type SendEmailAction as aR, type SendEmailActionConfig as aS, type SendEmailCondition as aT, type SendEmailConfig as aU, type SetValueMapper as aV, type StartExecutionRequest as aW, type SuffixCondition as aX, type TriggerCondition as aY, type TriggerContext as aZ, type TriggerEventAction as a_, type FlowExecutionCancelActionConfig as aa, type FlowExecutionCancelConfig as ab, type FlowsTrigger as ac, type ForwardEmailAction as ad, type ForwardEmailActionConfig as ae, type ForwardEmailConfig as af, type FrontendSubmitTrigger as ag, type GetExecutionsResp as ah, type InformERPAction as ai, type InformERPActionConfig as aj, type InformERPConfig as ak, type JobId as al, type JourneySubmitTrigger as am, type MapEntityAction as an, type MapEntityActionConfig as ao, type MapEntityConfig as ap, type MappingAttribute as aq, type MappingAttributeMode as ar, type MappingAttributeV2 as as, type MappingConfigRef as at, type MoveThreadAction as au, type MoveThreadConfig as av, type NewEmailThreadTrigger as aw, type NumericCondition as ax, type OperationNode as ay, type OperationObjectNode as az, type PathsDictionary as b, type TriggerEventConfig as b0, type TriggerEventEntityActivity as b1, type TriggerEventEntityOperation as b2, type TriggerEventFlowAutomationTask as b3, type TriggerEventManual as b4, type TriggerEventMessaging as b5, type TriggerShareEntityAction as b6, type TriggerShareEntityActionConfig as b7, type TriggerShareEntityConfig as b8, type TriggerWebhookAction as b9, type TriggerWebhookActionConfig as ba, type TriggerWebhookConfig as bb, type TriggerWorkflowAction as bc, type TriggerWorkflowActionConfig as bd, type TriggerWorkflowCondition as be, type TriggerWorkflowConfig as bf, type WildcardCondition as bg, type WorkflowContextRole as bh, type WorkflowExecutionContext as bi, type ActionSchedule as c, type ActionScheduleSource as d, type ActivityId as e, type ActivityTrigger as f, type AnyAction as g, type AnyActionConfig as h, type AnyTrigger as i, type AnythingButCondition as j, type ApiCallerContext as k, type ApiSubmissionTrigger as l, type AppendValueMapper as m, type AssignThreadAction as n, type AssignThreadConfig as o, type AssignUsersToStep as p, type AutomationAction as q, type AutomationActionConfig as r, type AutomationActionExecutionState as s, type AutomationActionId as t, type AutomationExecution as u, type AutomationExecutionId as v, type AutomationFlow as w, type AutomationFlowId as x, type AutomationTrigger as y, type BulkTriggerRequest as z };
+export { type EntityRef as $, type ActionCondition as A, type AutomationLoopState as B, type Client as C, type AutomationTrigger as D, type BulkTriggerJob as E, type BulkTriggerRequest as F, type CancellationReason as G, type CartCheckoutAction as H, type CartCheckoutActionConfig as I, type CartCheckoutConfig as J, type Comparison as K, type ConditionStatement as L, type CopyValueMapper as M, type CreateDocumentAction as N, type OperationMethods as O, Paths as P, type CreateDocumentActionConfig as Q, type CreateDocumentConfig as R, type CustomAction as S, type DiffAdded as T, type DiffDeleted as U, type DiffUpdated as V, type EntityId as W, type EntityItemSnapshot as X, type EntityManualTrigger as Y, type EntityOperation as Z, type EntityOperationTrigger as _, Components as a, type TriggerCondition as a$, type EntitySearchFilter as a0, type EntitySearchFilterValue as a1, type EqualsIgnoreCaseCondition as a2, type ErrorCode as a3, type ErrorDetail as a4, type ErrorObject as a5, type ErrorOutput as a6, type ExecItem as a7, type ExecutionChain as a8, type ExecutionStatus as a9, type NumericCondition as aA, type OperationNode as aB, type OperationObjectNode as aC, type OrCondition as aD, type OrConditionForDiff as aE, type OrganizationId as aF, type PatchBulkJobRequest as aG, type PrefixCondition as aH, type PrimitiveJSONValue as aI, type ReceivedEmailTrigger as aJ, type RelationAttribute as aK, type ReplyEmailAction as aL, type ReplyEmailActionConfig as aM, type ReplyEmailConfig as aN, type ResumeReq as aO, type ResumeResp as aP, type ResumeToken as aQ, type RetryReq as aR, type RetryStrategy as aS, type SearchAutomationsResp as aT, type SendEmailAction as aU, type SendEmailActionConfig as aV, type SendEmailCondition as aW, type SendEmailConfig as aX, type SetValueMapper as aY, type StartExecutionRequest as aZ, type SuffixCondition as a_, type ExistsCondition as aa, type FilterConditionOnEvent as ab, type FlowExecutionCancelAction as ac, type FlowExecutionCancelActionConfig as ad, type FlowExecutionCancelConfig as ae, type FlowsTrigger as af, type ForwardEmailAction as ag, type ForwardEmailActionConfig as ah, type ForwardEmailConfig as ai, type FrontendSubmitTrigger as aj, type GetExecutionsResp as ak, type InformERPAction as al, type InformERPActionConfig as am, type InformERPConfig as an, type JobId as ao, type JourneySubmitTrigger as ap, type MapEntityAction as aq, type MapEntityActionConfig as ar, type MapEntityConfig as as, type MappingAttribute as at, type MappingAttributeMode as au, type MappingAttributeV2 as av, type MappingConfigRef as aw, type MoveThreadAction as ax, type MoveThreadConfig as ay, type NewEmailThreadTrigger as az, type PathsDictionary as b, type TriggerContext as b0, type TriggerEventAction as b1, type TriggerEventActionConfig as b2, type TriggerEventConfig as b3, type TriggerEventEntityActivity as b4, type TriggerEventEntityOperation as b5, type TriggerEventFlowAutomationTask as b6, type TriggerEventManual as b7, type TriggerEventMessaging as b8, type TriggerShareEntityAction as b9, type TriggerShareEntityActionConfig as ba, type TriggerShareEntityConfig as bb, type TriggerWebhookAction as bc, type TriggerWebhookActionConfig as bd, type TriggerWebhookConfig as be, type TriggerWorkflowAction as bf, type TriggerWorkflowActionConfig as bg, type TriggerWorkflowCondition as bh, type TriggerWorkflowConfig as bi, type WildcardCondition as bj, type WorkflowContextRole as bk, type WorkflowExecutionContext as bl, type ActionSchedule as c, type ActionScheduleSource as d, type ActivityId as e, type ActivityTrigger as f, type AnyAction as g, type AnyActionConfig as h, type AnyTrigger as i, type AnythingButCondition as j, type ApiCallerContext as k, type ApiSubmissionTrigger as l, type AppendValueMapper as m, type AssignThreadAction as n, type AssignThreadConfig as o, type AssignUsersToStep as p, type AutomationAction as q, type AutomationActionConfig as r, type AutomationActionExecutionState as s, type AutomationActionId as t, type AutomationActionIteration as u, type AutomationExecution as v, type AutomationExecutionId as w, type AutomationFlow as x, type AutomationFlowId as y, type AutomationLoop as z };