@epilot/sdk 2.20.32 → 2.20.34

package/dist/{automation.d-2biAmiMc.d.cts → automation.d-B8g3nYp-.d.cts}

@@ -92,6 +92,35 @@ declare namespace Components {
              */
             ConditionStatement[];
         }
+        /**
+         * Internal. Run-time inputs for the actions of this execution, keyed by
+         * action type. An action reads the entry for its own type and treats it
+         * as replacing the matching configured values; an action whose type has
+         * no entry runs entirely from its configuration.
+         *
+         * Only the workflows service may set this field, on behalf of the person
+         * running a semi-automated flow task: it forwards what that person chose
+         * after checking their permission to run the task. A request carrying
+         * `action_inputs` under any other token is refused with 403 and nothing
+         * is stored.
+         *
+         * This is deliberately NOT stored on `actions[].config`. Retrying a step
+         * refreshes that action's config from the live flow (see `startAction`),
+         * which would silently drop an override and re-run the action with the
+         * configured values — sending the wrong email, or cancelling a flow
+         * under the wrong reason. Keeping the inputs on the execution row means a
+         * retry replays what the person actually chose.
+         *
+         */
+        export interface ActionInputs {
+            "cancel-flow-execution"?: /* The cancellation reasons a person chose when running a semi-automated cancel step, replacing `selected_reasons` from the action's configuration. */ FlowExecutionCancelInputs;
+            "send-email"?: /**
+             * Adjustments a person made to an email before sending it, replacing the rendered values the template produced. The template itself is untouched.
+             *
+             * `attachment_entity_ids` is a request, not an instruction: the worker keeps only the ids that are genuinely files of the entity this execution runs on, so a caller cannot attach an arbitrary file.
+             */
+            SendEmailInputs;
+        }
         export interface ActionSchedule {
             /**
              * Schedule Id
@@ -1393,6 +1422,27 @@ declare namespace Components {
             conditions?: ActionCondition[];
             schedules?: ActionSchedule[];
             actions: AnyAction[];
+            action_inputs?: /**
+             * Internal. Run-time inputs for the actions of this execution, keyed by
+             * action type. An action reads the entry for its own type and treats it
+             * as replacing the matching configured values; an action whose type has
+             * no entry runs entirely from its configuration.
+             *
+             * Only the workflows service may set this field, on behalf of the person
+             * running a semi-automated flow task: it forwards what that person chose
+             * after checking their permission to run the task. A request carrying
+             * `action_inputs` under any other token is refused with 403 and nothing
+             * is stored.
+             *
+             * This is deliberately NOT stored on `actions[].config`. Retrying a step
+             * refreshes that action's config from the live flow (see `startAction`),
+             * which would silently drop an override and re-run the action with the
+             * configured values — sending the wrong email, or cancelling a flow
+             * under the wrong reason. Keeping the inputs on the execution row means a
+             * retry replays what the person actually chose.
+             *
+             */
+            ActionInputs;
             resume_token?: /**
              * A unique token to resume a paused automation execution
              * example:
@@ -1420,7 +1470,7 @@ declare namespace Components {
             TriggerEventEventCatalog;
             workflow_context?: WorkflowExecutionContext;
             workflow_wait_context?: /**
-             * Correlation stamped when the triggering submission entity carried workflow wait claims from a journey link (AL-2521). Consumed by svc-workflows to resume a task waiting on this journey submission.
+             * Correlation stamped when the triggering submission entity carried workflow wait claims from a journey link. Consumed by svc-workflows to resume a task waiting on this journey submission.
              *
              */
             WorkflowWaitContext;
@@ -2908,7 +2958,7 @@ declare namespace Components {
             AutomationActionId;
             name?: string;
             type?: "cancel-flow-execution";
-            config?: /* Configuration for cancelling a flow execution with selected reasons */ FlowExecutionCancelConfig;
+            config?: /* Configuration for cancelling a flow execution. The selected reasons are optional; a semi-automated step lets the person running it choose them when the execution starts. */ FlowExecutionCancelConfig;
             /**
              * Whether to stop execution in a failed state if this action fails
              */
@@ -3000,7 +3050,7 @@ declare namespace Components {
             AutomationActionId;
             name?: string;
             type?: "cancel-flow-execution";
-            config?: /* Configuration for cancelling a flow execution with selected reasons */ FlowExecutionCancelConfig;
+            config?: /* Configuration for cancelling a flow execution. The selected reasons are optional; a semi-automated step lets the person running it choose them when the execution starts. */ FlowExecutionCancelConfig;
             /**
              * Whether to stop execution in a failed state if this action fails
              */
@@ -3042,7 +3092,7 @@ declare namespace Components {
             loop_id?: string;
         }
         /**
-         * Configuration for cancelling a flow execution with selected reasons
+         * Configuration for cancelling a flow execution. The selected reasons are optional; a semi-automated step lets the person running it choose them when the execution starts.
          */
         export interface FlowExecutionCancelConfig {
             /**
@@ -3056,6 +3106,16 @@ declare namespace Components {
              */
             extra_description?: string;
         }
+        /**
+         * The cancellation reasons a person chose when running a semi-automated cancel step, replacing `selected_reasons` from the action's configuration.
+         */
+        export interface FlowExecutionCancelInputs {
+            selected_reasons: /* A reason for cancelling a flow execution */ CancellationReason[];
+            /**
+             * A note the person added with their choice, replacing the one fixed in the action's configuration.
+             */
+            extra_description?: string;
+        }
         export interface FlowsTrigger {
             /**
              * example:
@@ -3233,6 +3293,13 @@ declare namespace Components {
              * Prefix to add to the original email subject
              */
             subject_prefix?: string;
+            /**
+             * Language of the "Forwarded message" attribution header
+             * (From / Date / To / Subject) prepended to the forwarded email.
+             * Defaults to German.
+             *
+             */
+            language_code?: "de" | "en";
             /**
              * When enabled, the email thread will be automatically marked as done after this action completes.
              */
@@ -3524,6 +3591,54 @@ declare namespace Components {
          * 8c086140-f33e-4bb7-a993-50c0f2402c7b
          */
         export type JobId = string;
+        export interface JourneyContextUsage {
+            kind: "automation";
+            resource: {
+                type: "automation_flow";
+                id: string;
+                name?: string;
+            };
+            location?: {
+                action_id?: string;
+                action_type?: string;
+            };
+            matched_as: {
+                dialect: "name";
+                token: string;
+                at: string;
+            };
+            link_hint: {
+                route: "automation-flow";
+                params: {
+                    [name: string]: string;
+                };
+            };
+        }
+        export interface JourneyContextUsagesReq {
+            journey_id: string; // uuid
+            /**
+             * Context parameter keys to look for, as plain strings.
+             */
+            param_keys: string[];
+            /**
+             * Accepted and ignored. This service stores context references by name only; the field keeps one request shape across every adapter.
+             *
+             */
+            param_ids?: string[];
+        }
+        export interface JourneyContextUsagesResp {
+            usages: JourneyContextUsage[];
+            /**
+             * partial means the row cap (MAX_USAGES) was reached mid-scan and the scan was aborted: entire flows after the one that tripped the cap may have gone unscanned, not just that some rows were dropped from the one flow being scanned when it tripped.
+             *
+             */
+            status: "ok" | "partial";
+            /**
+             * Number of flows actually entered by the scan, including the one flow the scan was aborted part-way through when the row cap tripped. Not a total: when status is partial, flows after the aborted one were never visited and are not counted here.
+             *
+             */
+            scanned: number;
+        }
         export interface JourneySubmitTrigger {
             /**
              * example:
@@ -4484,7 +4599,7 @@ declare namespace Components {
             /**
              * Only relevant when this action runs from a workflow automation task. After the email is sent,
              * the workflow task waits for the journey referenced in the email template to be submitted and
-             * its submission automation to complete (AL-2521).
+             * its submission automation to complete.
              *
              * The email template should contain a journey link created with the generateJourneyLink variable.
              *
@@ -4540,6 +4655,22 @@ declare namespace Components {
                      * .*
                      */
                     filename_regex?: string;
+                    /**
+                     * Match by exact filename
+                     * example:
+                     * Datenblatt_PV.pdf
+                     */
+                    filename?: string;
+                    /**
+                     * Match by a filename pattern that may contain template variables. Each
+                     * `{{variable}}` placeholder matches any text, so a pattern written the way a
+                     * generated document is named picks up every document produced from that
+                     * template, whatever the variables resolved to.
+                     *
+                     * example:
+                     * {{system.date}}_Summary_{{contact._title}}.docx
+                     */
+                    filename_pattern?: string;
                     /**
                      * Filter by a specific relation attribute on the main entity
                      * example:
@@ -4571,6 +4702,16 @@ declare namespace Components {
              */
             conditions?: SendEmailCondition[];
         }
+        /**
+         * Adjustments a person made to an email before sending it, replacing the rendered values the template produced. The template itself is untouched.
+         *
+         * `attachment_entity_ids` is a request, not an instruction: the worker keeps only the ids that are genuinely files of the entity this execution runs on, so a caller cannot attach an arbitrary file.
+         */
+        export interface SendEmailInputs {
+            subject?: string;
+            body?: string;
+            attachment_entity_ids?: string[];
+        }
         export interface SetValueMapper {
             mode: /**
              * - copy_if_exists - it replaces the target attribute with the source value - append_if_exists - it currently replaces target attribute with array like values. Useful when you have multiple values to be added into one attribute. - set_value - it sets a value to a predefined value. Must be used together with value property.
@@ -4608,6 +4749,27 @@ declare namespace Components {
              * Use workflow_context.workflow_exec_task_id instead
              */
             flow_automation_task_id?: string;
+            action_inputs?: /**
+             * Internal. Run-time inputs for the actions of this execution, keyed by
+             * action type. An action reads the entry for its own type and treats it
+             * as replacing the matching configured values; an action whose type has
+             * no entry runs entirely from its configuration.
+             *
+             * Only the workflows service may set this field, on behalf of the person
+             * running a semi-automated flow task: it forwards what that person chose
+             * after checking their permission to run the task. A request carrying
+             * `action_inputs` under any other token is refused with 403 and nothing
+             * is stored.
+             *
+             * This is deliberately NOT stored on `actions[].config`. Retrying a step
+             * refreshes that action's config from the live flow (see `startAction`),
+             * which would silently drop an override and re-run the action with the
+             * configured values — sending the wrong email, or cancelling a flow
+             * under the wrong reason. Keeping the inputs on the execution row means a
+             * retry replays what the person actually chose.
+             *
+             */
+            ActionInputs;
         }
         export interface SuffixCondition {
             suffix?: string;
@@ -5477,7 +5639,7 @@ declare namespace Components {
             trigger_user_id?: string;
         }
         /**
-         * Correlation stamped when the triggering submission entity carried workflow wait claims from a journey link (AL-2521). Consumed by svc-workflows to resume a task waiting on this journey submission.
+         * Correlation stamped when the triggering submission entity carried workflow wait claims from a journey link. Consumed by svc-workflows to resume a task waiting on this journey submission.
          *
          */
         export interface WorkflowWaitContext {
@@ -6359,6 +6521,7 @@ type Client = OpenAPIClient<OperationMethods, PathsDictionary>
 
 
 type ActionCondition = Components.Schemas.ActionCondition;
+type ActionInputs = Components.Schemas.ActionInputs;
 type ActionSchedule = Components.Schemas.ActionSchedule;
 type ActionScheduleSource = Components.Schemas.ActionScheduleSource;
 type ActivityId = Components.Schemas.ActivityId;
@@ -6427,6 +6590,7 @@ type FilterConditionOnEvent = Components.Schemas.FilterConditionOnEvent;
 type FlowExecutionCancelAction = Components.Schemas.FlowExecutionCancelAction;
 type FlowExecutionCancelActionConfig = Components.Schemas.FlowExecutionCancelActionConfig;
 type FlowExecutionCancelConfig = Components.Schemas.FlowExecutionCancelConfig;
+type FlowExecutionCancelInputs = Components.Schemas.FlowExecutionCancelInputs;
 type FlowsTrigger = Components.Schemas.FlowsTrigger;
 type ForwardEmailAction = Components.Schemas.ForwardEmailAction;
 type ForwardEmailActionConfig = Components.Schemas.ForwardEmailActionConfig;
@@ -6443,6 +6607,9 @@ type InformERPAction = Components.Schemas.InformERPAction;
 type InformERPActionConfig = Components.Schemas.InformERPActionConfig;
 type InformERPConfig = Components.Schemas.InformERPConfig;
 type JobId = Components.Schemas.JobId;
+type JourneyContextUsage = Components.Schemas.JourneyContextUsage;
+type JourneyContextUsagesReq = Components.Schemas.JourneyContextUsagesReq;
+type JourneyContextUsagesResp = Components.Schemas.JourneyContextUsagesResp;
 type JourneySubmitTrigger = Components.Schemas.JourneySubmitTrigger;
 type MapEntityAction = Components.Schemas.MapEntityAction;
 type MapEntityActionConfig = Components.Schemas.MapEntityActionConfig;
@@ -6480,6 +6647,7 @@ type SendEmailAction = Components.Schemas.SendEmailAction;
 type SendEmailActionConfig = Components.Schemas.SendEmailActionConfig;
 type SendEmailCondition = Components.Schemas.SendEmailCondition;
 type SendEmailConfig = Components.Schemas.SendEmailConfig;
+type SendEmailInputs = Components.Schemas.SendEmailInputs;
 type SetValueMapper = Components.Schemas.SetValueMapper;
 type StartExecutionRequest = Components.Schemas.StartExecutionRequest;
 type SuffixCondition = Components.Schemas.SuffixCondition;
@@ -6510,4 +6678,4 @@ type WorkflowContextRole = Components.Schemas.WorkflowContextRole;
 type WorkflowExecutionContext = Components.Schemas.WorkflowExecutionContext;
 type WorkflowWaitContext = Components.Schemas.WorkflowWaitContext;
 
-export { type EntityItemSnapshot as $, type ActionCondition as A, type AutomationFlow as B, type Client as C, type AutomationFlowId as D, type AutomationLoop as E, type AutomationLoopState as F, type AutomationTrigger as G, type BulkTriggerJob as H, type BulkTriggerRequest as I, type CancellationReason as J, type CartCheckoutAction as K, type CartCheckoutActionConfig as L, type CartCheckoutConfig as M, type Comparison as N, type OperationMethods as O, Paths as P, type ConditionStatement as Q, type CopyValueMapper as R, type CreateDocumentAction as S, type CreateDocumentActionConfig as T, type CreateDocumentConfig as U, type CustomAction as V, type DiffAdded as W, type DiffDeleted as X, type DiffUpdated as Y, type EntityAssignee as Z, type EntityId as _, Components as a, type ResumeToken as a$, type EntityManualTrigger as a0, type EntityOperation as a1, type EntityOperationTrigger as a2, type EntityRef as a3, type EntitySearchFilter as a4, type EntitySearchFilterValue as a5, type EqualsIgnoreCaseCondition as a6, type ErrorCode as a7, type ErrorDetail as a8, type ErrorObject as a9, type JourneySubmitTrigger as aA, type MapEntityAction as aB, type MapEntityActionConfig as aC, type MapEntityConfig as aD, type MappingAttribute as aE, type MappingAttributeMode as aF, type MappingAttributeV2 as aG, type MappingConfigRef as aH, type MoveThreadAction as aI, type MoveThreadConfig as aJ, type NewEmailThreadTrigger as aK, type NumericCondition as aL, type OperationNode as aM, type OperationObjectNode as aN, type OrCondition as aO, type OrConditionForDiff as aP, type OrganizationId as aQ, type PatchBulkJobRequest as aR, type PrefixCondition as aS, type PrimitiveJSONValue as aT, type ReceivedEmailTrigger as aU, type RelationAttribute as aV, type ReplyEmailAction as aW, type ReplyEmailActionConfig as aX, type ReplyEmailConfig as aY, type ResumeReq as aZ, type ResumeResp as a_, type ErrorOutput as aa, type EventCatalogTrigger as ab, type ExecItem as ac, type ExecutionChain as ad, type ExecutionStatus as ae, type ExistsCondition as af, type FilterConditionOnEvent as ag, type FlowExecutionCancelAction as ah, type FlowExecutionCancelActionConfig as ai, type FlowExecutionCancelConfig as aj, type FlowsTrigger as ak, type ForwardEmailAction as al, type ForwardEmailActionConfig as am, type ForwardEmailConfig as an, type FrontendSubmitTrigger as ao, type GetExecutionsResp as ap, type GraphContextEntry as aq, type GraphDefinition as ar, type GraphEdge as as, type GraphNode as at, type GraphNodeFilter as au, type GraphSeed as av, type InformERPAction as aw, type InformERPActionConfig as ax, type InformERPConfig as ay, type JobId as az, type PathsDictionary as b, type RetryReq as b0, type RetryStrategy as b1, type SearchAutomationsResp as b2, type SearchExecutionsReq as b3, type SearchExecutionsResp as b4, type SendEmailAction as b5, type SendEmailActionConfig as b6, type SendEmailCondition as b7, type SendEmailConfig as b8, type SetValueMapper as b9, type WorkflowExecutionContext as bA, type WorkflowWaitContext as bB, type StartExecutionRequest as ba, type SuffixCondition as bb, type TriggerCondition as bc, type TriggerContext as bd, type TriggerEventAction as be, type TriggerEventActionConfig as bf, type TriggerEventConfig as bg, type TriggerEventEntityActivity as bh, type TriggerEventEntityOperation as bi, type TriggerEventEventCatalog as bj, type TriggerEventFlowAutomationTask as bk, type TriggerEventManual as bl, type TriggerEventMessaging as bm, type TriggerEventPayloadRef as bn, type TriggerShareEntityAction as bo, type TriggerShareEntityActionConfig as bp, type TriggerShareEntityConfig as bq, type TriggerWebhookAction as br, type TriggerWebhookActionConfig as bs, type TriggerWebhookConfig as bt, type TriggerWorkflowAction as bu, type TriggerWorkflowActionConfig as bv, type TriggerWorkflowCondition as bw, type TriggerWorkflowConfig as bx, type WildcardCondition as by, type WorkflowContextRole as bz, 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 AssignEntityAction as n, type AssignEntityActionConfig as o, type AssignEntityConfig as p, type AssignThreadAction as q, type AssignThreadConfig as r, type AssignUsersToStep as s, type AutomationAction as t, type AutomationActionConfig as u, type AutomationActionExecutionState as v, type AutomationActionId as w, type AutomationActionIteration as x, type AutomationExecution as y, type AutomationExecutionId as z };
+export { type EntityId as $, type ActionCondition as A, type AutomationExecutionId as B, type Client as C, type AutomationFlow as D, type AutomationFlowId as E, type AutomationLoop as F, type AutomationLoopState as G, type AutomationTrigger as H, type BulkTriggerJob as I, type BulkTriggerRequest as J, type CancellationReason as K, type CartCheckoutAction as L, type CartCheckoutActionConfig as M, type CartCheckoutConfig as N, type OperationMethods as O, Paths as P, type Comparison as Q, type ConditionStatement as R, type CopyValueMapper as S, type CreateDocumentAction as T, type CreateDocumentActionConfig as U, type CreateDocumentConfig as V, type CustomAction as W, type DiffAdded as X, type DiffDeleted as Y, type DiffUpdated as Z, type EntityAssignee as _, Components as a, type ReplyEmailAction as a$, type EntityItemSnapshot as a0, type EntityManualTrigger as a1, type EntityOperation as a2, type EntityOperationTrigger as a3, type EntityRef as a4, type EntitySearchFilter as a5, type EntitySearchFilterValue as a6, type EqualsIgnoreCaseCondition as a7, type ErrorCode as a8, type ErrorDetail as a9, type InformERPConfig as aA, type JobId as aB, type JourneyContextUsage as aC, type JourneyContextUsagesReq as aD, type JourneyContextUsagesResp as aE, type JourneySubmitTrigger as aF, type MapEntityAction as aG, type MapEntityActionConfig as aH, type MapEntityConfig as aI, type MappingAttribute as aJ, type MappingAttributeMode as aK, type MappingAttributeV2 as aL, type MappingConfigRef as aM, type MoveThreadAction as aN, type MoveThreadConfig as aO, type NewEmailThreadTrigger as aP, type NumericCondition as aQ, type OperationNode as aR, type OperationObjectNode as aS, type OrCondition as aT, type OrConditionForDiff as aU, type OrganizationId as aV, type PatchBulkJobRequest as aW, type PrefixCondition as aX, type PrimitiveJSONValue as aY, type ReceivedEmailTrigger as aZ, type RelationAttribute as a_, type ErrorObject as aa, type ErrorOutput as ab, type EventCatalogTrigger as ac, type ExecItem as ad, type ExecutionChain as ae, type ExecutionStatus as af, type ExistsCondition as ag, type FilterConditionOnEvent as ah, type FlowExecutionCancelAction as ai, type FlowExecutionCancelActionConfig as aj, type FlowExecutionCancelConfig as ak, type FlowExecutionCancelInputs as al, type FlowsTrigger as am, type ForwardEmailAction as an, type ForwardEmailActionConfig as ao, type ForwardEmailConfig as ap, type FrontendSubmitTrigger as aq, type GetExecutionsResp as ar, type GraphContextEntry as as, type GraphDefinition as at, type GraphEdge as au, type GraphNode as av, type GraphNodeFilter as aw, type GraphSeed as ax, type InformERPAction as ay, type InformERPActionConfig as az, type PathsDictionary as b, type ReplyEmailActionConfig as b0, type ReplyEmailConfig as b1, type ResumeReq as b2, type ResumeResp as b3, type ResumeToken as b4, type RetryReq as b5, type RetryStrategy as b6, type SearchAutomationsResp as b7, type SearchExecutionsReq as b8, type SearchExecutionsResp as b9, type TriggerWorkflowAction as bA, type TriggerWorkflowActionConfig as bB, type TriggerWorkflowCondition as bC, type TriggerWorkflowConfig as bD, type WildcardCondition as bE, type WorkflowContextRole as bF, type WorkflowExecutionContext as bG, type WorkflowWaitContext as bH, type SendEmailAction as ba, type SendEmailActionConfig as bb, type SendEmailCondition as bc, type SendEmailConfig as bd, type SendEmailInputs as be, type SetValueMapper as bf, type StartExecutionRequest as bg, type SuffixCondition as bh, type TriggerCondition as bi, type TriggerContext as bj, type TriggerEventAction as bk, type TriggerEventActionConfig as bl, type TriggerEventConfig as bm, type TriggerEventEntityActivity as bn, type TriggerEventEntityOperation as bo, type TriggerEventEventCatalog as bp, type TriggerEventFlowAutomationTask as bq, type TriggerEventManual as br, type TriggerEventMessaging as bs, type TriggerEventPayloadRef as bt, type TriggerShareEntityAction as bu, type TriggerShareEntityActionConfig as bv, type TriggerShareEntityConfig as bw, type TriggerWebhookAction as bx, type TriggerWebhookActionConfig as by, type TriggerWebhookConfig as bz, type ActionInputs as c, type ActionSchedule as d, type ActionScheduleSource as e, type ActivityId as f, type ActivityTrigger as g, type AnyAction as h, type AnyActionConfig as i, type AnyTrigger as j, type AnythingButCondition as k, type ApiCallerContext as l, type ApiSubmissionTrigger as m, type AppendValueMapper as n, type AssignEntityAction as o, type AssignEntityActionConfig as p, type AssignEntityConfig as q, type AssignThreadAction as r, type AssignThreadConfig as s, type AssignUsersToStep as t, type AutomationAction as u, type AutomationActionConfig as v, type AutomationActionExecutionState as w, type AutomationActionId as x, type AutomationActionIteration as y, type AutomationExecution as z };