@trii/types 2.10.764 → 2.10.766

package/dist/src/Automations/Capabilities/Capability.d.ts

@@ -0,0 +1,81 @@
+import { AutomationError, AutomationJsonObject, AutomationJsonSchema, AutomationSourceApplication } from '../Common';
+export declare enum AutomationCapabilityKind {
+    TRIGGER = "trigger",
+    ACTION = "action",
+    CONDITION = "condition"
+}
+export declare enum AutomationCapabilityEffectClass {
+    NONE = "none",
+    READ = "read",
+    WRITE = "write",
+    COMMUNICATION = "communication",
+    BULK = "bulk"
+}
+export declare enum AutomationCapabilityIdempotency {
+    NONE = "none",
+    SUPPORTED = "supported",
+    REQUIRED = "required"
+}
+/** Capacidades operativas que el runtime puede aplicar de forma confiable. */
+export interface AutomationCapabilityExecutionSupport {
+    effectClass: AutomationCapabilityEffectClass;
+    supportsSimulation: boolean;
+    supportsTestTargets: boolean;
+    supportsUntilNode: boolean;
+    supportsFromNode: boolean;
+    supportsNodeOnly: boolean;
+    supportsCancellation: boolean;
+    idempotency: AutomationCapabilityIdempotency;
+    defaultTimeoutMs?: number | null;
+    maxAttempts?: number | null;
+    maxTestItems?: number | null;
+    inputSchema?: AutomationJsonSchema | null;
+    outputSchema?: AutomationJsonSchema | null;
+    simulationOutputSchema?: AutomationJsonSchema | null;
+    sensitivePaths?: string[] | null;
+    requiredPermissions?: string[] | null;
+}
+/**
+ * Capacidad publicada por una aplicación de negocio para que Automation pueda
+ * descubrirla y representarla sin incorporar reglas de ese dominio.
+ */
+export interface AutomationCapability {
+    code: string;
+    sourceApplication: AutomationSourceApplication;
+    kind: AutomationCapabilityKind;
+    name: string;
+    description?: string | null;
+    inputSchema?: AutomationJsonSchema | null;
+    outputSchema?: AutomationJsonSchema | null;
+    requiredPermissions: string[];
+    enabled: boolean;
+    version: number;
+    /** Metadata opcional para definitions anteriores a la política de ejecución. */
+    executionSupport?: AutomationCapabilityExecutionSupport | null;
+}
+export interface AutomationCapabilityQuery {
+    sourceApplications?: AutomationSourceApplication[];
+    kinds?: AutomationCapabilityKind[];
+    enabledOnly?: boolean;
+    version?: number;
+}
+export interface AutomationCapabilityReference {
+    code: string;
+    version: number;
+    sourceApplication: AutomationSourceApplication;
+}
+export interface AutomationCapabilityInvocation {
+    invocationId: string;
+    executionId: string;
+    nodeId: string;
+    capability: AutomationCapabilityReference;
+    input: AutomationJsonObject;
+    context: AutomationJsonObject;
+}
+export interface AutomationCapabilityResult {
+    invocationId: string;
+    success: boolean;
+    output?: AutomationJsonObject | null;
+    error?: AutomationError | null;
+    completedAt: string;
+}

package/dist/src/Automations/Capabilities/Capability.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutomationCapabilityIdempotency = exports.AutomationCapabilityEffectClass = exports.AutomationCapabilityKind = void 0;
+var AutomationCapabilityKind;
+(function (AutomationCapabilityKind) {
+    AutomationCapabilityKind["TRIGGER"] = "trigger";
+    AutomationCapabilityKind["ACTION"] = "action";
+    AutomationCapabilityKind["CONDITION"] = "condition";
+})(AutomationCapabilityKind || (exports.AutomationCapabilityKind = AutomationCapabilityKind = {}));
+var AutomationCapabilityEffectClass;
+(function (AutomationCapabilityEffectClass) {
+    AutomationCapabilityEffectClass["NONE"] = "none";
+    AutomationCapabilityEffectClass["READ"] = "read";
+    AutomationCapabilityEffectClass["WRITE"] = "write";
+    AutomationCapabilityEffectClass["COMMUNICATION"] = "communication";
+    AutomationCapabilityEffectClass["BULK"] = "bulk";
+})(AutomationCapabilityEffectClass || (exports.AutomationCapabilityEffectClass = AutomationCapabilityEffectClass = {}));
+var AutomationCapabilityIdempotency;
+(function (AutomationCapabilityIdempotency) {
+    AutomationCapabilityIdempotency["NONE"] = "none";
+    AutomationCapabilityIdempotency["SUPPORTED"] = "supported";
+    AutomationCapabilityIdempotency["REQUIRED"] = "required";
+})(AutomationCapabilityIdempotency || (exports.AutomationCapabilityIdempotency = AutomationCapabilityIdempotency = {}));

package/dist/src/Automations/Capabilities/index.d.ts

@@ -0,0 +1 @@
+export * from './Capability';

package/dist/src/Automations/Capabilities/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Capability"), exports);

package/dist/src/Automations/Common.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Aplicación propietaria del evento o capacidad consumida por Automation.
+ *
+ * Los valores forman parte del contrato HTTP/event-driven y no deben
+ * traducirse ni depender del nombre visible de la aplicación.
+ */
+export declare enum AutomationSourceApplication {
+    /** Automations y sus capacidades Core. */
+    AUTOMATIONS = "automations",
+    /** Gestión de conversaciones y mensajería conversacional. */
+    CONVERSATIONS = "conversations",
+    /** Gestión de contactos y organizaciones. */
+    CONTACTS = "contacts",
+    /** Gestión de tickets y soporte. */
+    TICKETS = "tickets",
+    /** Campañas y operaciones de marketing. */
+    MARKETING = "marketing",
+    /** Procesos y oportunidades comerciales. */
+    SALES = "sales",
+    /** Telefonía y llamadas. */
+    CALLS = "calls",
+    /** Comunicaciones salientes como email y SMS. */
+    COMMUNICATIONS = "communications",
+    /** Formularios y captura estructurada de datos. */
+    FORMS = "forms",
+    /** Conectores e integraciones externas. */
+    INTEGRATIONS = "integrations",
+    /** Acceso y transformación de datos. */
+    DATA = "data",
+    /** Agentes, modelos y herramientas de inteligencia artificial. */
+    AI = "ai",
+    /** Bases de conocimiento, documentos y búsqueda semántica. */
+    KNOWLEDGE = "knowledge",
+    /** Propietario externo o no clasificado; no debe usarse como fallback. */
+    GENERIC = "generic"
+}
+export type AutomationJsonValue = string | number | boolean | null | AutomationJsonObject | AutomationJsonValue[];
+/** Objeto JSON transportable entre aplicaciones y Automation. */
+export interface AutomationJsonObject {
+    [key: string]: AutomationJsonValue;
+}
+/**
+ * Schema JSON deliberadamente abierto. Cada aplicación es propietaria de la
+ * validación del schema que publica en su catálogo de capacidades.
+ */
+export interface AutomationJsonSchema extends AutomationJsonObject {
+    type?: string;
+    title?: string;
+    description?: string;
+    required?: string[];
+    properties?: {
+        [key: string]: AutomationJsonSchema;
+    };
+}
+export interface AutomationPageRequest {
+    skip: number;
+    limit: number;
+}
+export interface AutomationPagedResult<T> {
+    items: T[];
+    total: number;
+    skip: number;
+    limit: number;
+}
+export interface AutomationError {
+    code: string;
+    message: string;
+    details?: AutomationJsonObject | null;
+}
+/** Referencia estable con la identidad visible al iniciar una ejecución. */
+export interface AutomationCustomerReference {
+    id: string;
+    displayNameSnapshot?: string | null;
+}
+/** Referencia transversal a una entidad perteneciente a una aplicación. */
+export interface AutomationResourceReference {
+    /** Aplicación propietaria de la entidad. */
+    sourceApplication: AutomationSourceApplication;
+    /** Tipo estable dentro de la aplicación, por ejemplo ticket o campaign. */
+    resourceType: string;
+    /** Identificador en la aplicación propietaria. */
+    id: string;
+    /** Nombre informativo capturado al crear la referencia. */
+    displayNameSnapshot?: string | null;
+}
+/**
+ * Contexto CRM opcional asociado a un evento o ejecución.
+ * Permite representar escenarios B2C, B2B o un contacto perteneciente a una
+ * empresa sin depender de los contratos internos del módulo Contacts.
+ */
+export interface AutomationCustomer {
+    contact?: AutomationCustomerReference | null;
+    business?: AutomationCustomerReference | null;
+}

package/dist/src/Automations/Common.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutomationSourceApplication = void 0;
+/**
+ * Aplicación propietaria del evento o capacidad consumida por Automation.
+ *
+ * Los valores forman parte del contrato HTTP/event-driven y no deben
+ * traducirse ni depender del nombre visible de la aplicación.
+ */
+var AutomationSourceApplication;
+(function (AutomationSourceApplication) {
+    /** Automations y sus capacidades Core. */
+    AutomationSourceApplication["AUTOMATIONS"] = "automations";
+    /** Gestión de conversaciones y mensajería conversacional. */
+    AutomationSourceApplication["CONVERSATIONS"] = "conversations";
+    /** Gestión de contactos y organizaciones. */
+    AutomationSourceApplication["CONTACTS"] = "contacts";
+    /** Gestión de tickets y soporte. */
+    AutomationSourceApplication["TICKETS"] = "tickets";
+    /** Campañas y operaciones de marketing. */
+    AutomationSourceApplication["MARKETING"] = "marketing";
+    /** Procesos y oportunidades comerciales. */
+    AutomationSourceApplication["SALES"] = "sales";
+    /** Telefonía y llamadas. */
+    AutomationSourceApplication["CALLS"] = "calls";
+    /** Comunicaciones salientes como email y SMS. */
+    AutomationSourceApplication["COMMUNICATIONS"] = "communications";
+    /** Formularios y captura estructurada de datos. */
+    AutomationSourceApplication["FORMS"] = "forms";
+    /** Conectores e integraciones externas. */
+    AutomationSourceApplication["INTEGRATIONS"] = "integrations";
+    /** Acceso y transformación de datos. */
+    AutomationSourceApplication["DATA"] = "data";
+    /** Agentes, modelos y herramientas de inteligencia artificial. */
+    AutomationSourceApplication["AI"] = "ai";
+    /** Bases de conocimiento, documentos y búsqueda semántica. */
+    AutomationSourceApplication["KNOWLEDGE"] = "knowledge";
+    /** Propietario externo o no clasificado; no debe usarse como fallback. */
+    AutomationSourceApplication["GENERIC"] = "generic";
+})(AutomationSourceApplication || (exports.AutomationSourceApplication = AutomationSourceApplication = {}));

package/dist/src/Automations/Events/Event.d.ts

@@ -0,0 +1,69 @@
+import { AutomationCustomer, AutomationJsonObject, AutomationJsonSchema, AutomationResourceReference, AutomationSourceApplication } from '../Common';
+export interface AutomationEventDefinition {
+    eventType: string;
+    version: number;
+    sourceApplication: AutomationSourceApplication;
+    name: string;
+    description?: string | null;
+    payloadSchema: AutomationJsonSchema;
+    /** Schema de la vista del envelope cuyos paths pueden utilizarse en filtros. */
+    filterSchema?: AutomationJsonSchema | null;
+    requiredPermissions: string[];
+    enabled: boolean;
+}
+export interface AutomationEventEnvelope {
+    id: string;
+    spaceId: string;
+    sourceApplication: AutomationSourceApplication;
+    eventType: string;
+    eventVersion: number;
+    occurredAt: string;
+    receivedAt: string;
+    customer?: AutomationCustomer | null;
+    /** Entidad principal sobre la que ocurrió el evento. */
+    subject?: AutomationResourceReference | null;
+    correlationId?: string | null;
+    causationId?: string | null;
+    idempotencyKey?: string | null;
+    payload: AutomationJsonObject;
+    metadata?: AutomationJsonObject | null;
+}
+export declare enum AutomationEntryPointExclusionCode {
+    ENTRY_POINT_DISABLED = "entryPointDisabled",
+    SOURCE_APPLICATION_MISMATCH = "sourceApplicationMismatch",
+    EVENT_TYPE_MISMATCH = "eventTypeMismatch",
+    FILTERS_NOT_MATCHED = "filtersNotMatched",
+    FLOW_NOT_ACTIVE = "flowNotActive",
+    VERSION_NOT_PUBLISHED = "versionNotPublished",
+    LOWER_PRIORITY = "lowerPriority",
+    EXECUTION_MODE_RESTRICTED = "executionModeRestricted"
+}
+/** Motivo estructurado por el que un Entry Point no fue seleccionado. */
+export interface AutomationEntryPointExclusion {
+    /** Código estable para lógica, métricas y observabilidad. */
+    code: AutomationEntryPointExclusionCode;
+    /** Explicación humana opcional; no debe utilizarse para lógica. */
+    message?: string | null;
+    /** Datos diagnósticos específicos del código. */
+    details?: AutomationJsonObject | null;
+}
+export interface ResolveFlowEntryPointsRequest {
+    event: AutomationEventEnvelope;
+}
+export interface ResolvedFlowEntryPoint {
+    /** Definición estable del Flow. */
+    flowId: string;
+    /** Versión publicada candidata a recibir el evento. */
+    flowVersionId: string;
+    /** Entry Point evaluado. */
+    entryPointId: string;
+    /** Prioridad utilizada para resolver candidatos. */
+    priority: number;
+    /** Indica si el candidato debe iniciar una ejecución. */
+    selected: boolean;
+    /** Motivo de exclusión; ausente cuando selected es true. */
+    exclusion?: AutomationEntryPointExclusion | null;
+}
+export interface ResolveFlowEntryPointsResult {
+    matches: ResolvedFlowEntryPoint[];
+}

package/dist/src/Automations/Events/Event.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutomationEntryPointExclusionCode = void 0;
+var AutomationEntryPointExclusionCode;
+(function (AutomationEntryPointExclusionCode) {
+    AutomationEntryPointExclusionCode["ENTRY_POINT_DISABLED"] = "entryPointDisabled";
+    AutomationEntryPointExclusionCode["SOURCE_APPLICATION_MISMATCH"] = "sourceApplicationMismatch";
+    AutomationEntryPointExclusionCode["EVENT_TYPE_MISMATCH"] = "eventTypeMismatch";
+    AutomationEntryPointExclusionCode["FILTERS_NOT_MATCHED"] = "filtersNotMatched";
+    AutomationEntryPointExclusionCode["FLOW_NOT_ACTIVE"] = "flowNotActive";
+    AutomationEntryPointExclusionCode["VERSION_NOT_PUBLISHED"] = "versionNotPublished";
+    AutomationEntryPointExclusionCode["LOWER_PRIORITY"] = "lowerPriority";
+    AutomationEntryPointExclusionCode["EXECUTION_MODE_RESTRICTED"] = "executionModeRestricted";
+})(AutomationEntryPointExclusionCode || (exports.AutomationEntryPointExclusionCode = AutomationEntryPointExclusionCode = {}));

package/dist/src/Automations/Events/index.d.ts

@@ -0,0 +1 @@
+export * from './Event';

package/dist/src/Automations/Events/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Event"), exports);

package/dist/src/Automations/Executions/Execution.d.ts

@@ -0,0 +1,254 @@
+import { AutomationCustomer, AutomationError, AutomationJsonObject, AutomationPageRequest, AutomationResourceReference, AutomationSourceApplication } from '../Common';
+import { AutomationCapabilityEffectClass } from '../Capabilities';
+export declare enum AutomationExecutionStatus {
+    QUEUED = "queued",
+    RUNNING = "running",
+    WAITING = "waiting",
+    SUCCEEDED = "succeeded",
+    FAILED = "failed",
+    CANCELLED = "cancelled",
+    TIMED_OUT = "timedOut"
+}
+export declare enum AutomationExecutionStepStatus {
+    PENDING = "pending",
+    RUNNING = "running",
+    WAITING = "waiting",
+    SUCCEEDED = "succeeded",
+    FAILED = "failed",
+    SKIPPED = "skipped",
+    CANCELLED = "cancelled"
+}
+export declare enum AutomationExecutionPurpose {
+    PRODUCTION = "production",
+    TEST = "test"
+}
+export declare enum AutomationExecutionEffectMode {
+    SIMULATE = "simulate",
+    TEST_TARGETS = "testTargets",
+    REAL = "real"
+}
+export declare enum AutomationExecutionScopeKind {
+    FULL = "full",
+    UNTIL_NODE = "untilNode",
+    FROM_NODE = "fromNode",
+    NODE_ONLY = "nodeOnly"
+}
+export declare enum AutomationExecutionSourceKind {
+    MANUAL = "manual",
+    FIXTURE = "fixture",
+    CAPTURED_EVENT = "capturedEvent",
+    EXECUTION = "execution",
+    STEP_OUTPUT = "stepOutput"
+}
+export declare enum AutomationExecutionLineageOperation {
+    NEW = "new",
+    REPLAY = "replay",
+    RETRY = "retry"
+}
+export declare enum AutomationExecutionEffectDecision {
+    EXECUTED = "executed",
+    SIMULATED = "simulated",
+    REDIRECTED = "redirected",
+    BLOCKED = "blocked"
+}
+export interface AutomationExecutionScope {
+    kind: AutomationExecutionScopeKind;
+    startNodeId?: string | null;
+    stopNodeId?: string | null;
+}
+/** Referencia inmutable a la definición exacta utilizada por una ejecución. */
+export interface AutomationFlowSnapshotReference {
+    flowId: string;
+    flowVersionId?: string | null;
+    snapshotId?: string | null;
+    revision: number;
+    contentHash: string;
+}
+export interface AutomationExecutionSource {
+    kind: AutomationExecutionSourceKind;
+    fixtureId?: string | null;
+    capturedEventId?: string | null;
+    executionId?: string | null;
+    stepId?: string | null;
+}
+export interface AutomationExecutionLineage {
+    operation: AutomationExecutionLineageOperation;
+    sourceExecutionId?: string | null;
+    sourceStepId?: string | null;
+    rootExecutionId?: string | null;
+}
+/** Resumen seguro; la política interna completa nunca se expone al caller. */
+export interface AutomationExecutionPolicySummary {
+    maxDurationMs?: number | null;
+    maxSteps?: number | null;
+    maxIterations?: number | null;
+    maxItems?: number | null;
+    maxCost?: number | null;
+    currency?: string | null;
+    simulatedClockAt?: string | null;
+    requiresConfirmation: boolean;
+}
+export interface AutomationExecutionEffectRecord {
+    id: string;
+    nodeId: string;
+    effectClass: AutomationCapabilityEffectClass;
+    action: string;
+    decision: AutomationExecutionEffectDecision;
+    originalTarget?: AutomationResourceReference | null;
+    effectiveTarget?: AutomationResourceReference | null;
+    preview?: AutomationJsonObject | null;
+    providerReference?: string | null;
+    idempotencyKey?: string | null;
+    warnings?: string[] | null;
+}
+/**
+ * Referencia genérica al evento que inició una ejecución.
+ */
+export interface AutomationExecutionTrigger {
+    /** Entry Point que aceptó el evento. */
+    entryPointId: string;
+    /** Aplicación propietaria del evento. */
+    sourceApplication: AutomationSourceApplication;
+    /** Código estable del tipo de evento. */
+    eventType: string;
+    /** Entidad principal relacionada con el evento. */
+    reference?: AutomationResourceReference | null;
+    /** Instante informado por el productor. */
+    occurredAt?: string | null;
+    /** Snapshot opcional del payload disparador. */
+    payload?: AutomationJsonObject | null;
+}
+/** Identidad completa que debe persistir una ejecución transversal. */
+export interface AutomationFlowExecutionReference {
+    flowId: string;
+    flowVersionId: string;
+    entryPointId: string;
+    executionId: string;
+}
+/** Contexto que un caller puede aportar al iniciar una ejecución. */
+export interface AutomationExecutionContextInput {
+    /** Valores iniciales de variables declaradas por la versión del Flow. */
+    variables: AutomationJsonObject;
+    /** Extensiones agrupadas por módulo propietario. */
+    extensions: AutomationJsonObject;
+}
+/** Datos confiables establecidos exclusivamente por Automations. */
+export interface AutomationExecutionSystemContext {
+    /** Locale BCP 47, por ejemplo es-AR. */
+    locale?: string | null;
+    /** Zona horaria IANA utilizada por fechas y agendas. */
+    timeZone?: string | null;
+    /** Usuario, servicio o recurso que originó la ejecución. */
+    actor?: AutomationResourceReference | null;
+}
+/** Contexto persistido y utilizado durante una ejecución. */
+export interface AutomationExecutionContext extends AutomationExecutionContextInput {
+    /** Datos confiables agregados por el runtime. */
+    system: AutomationExecutionSystemContext;
+}
+export interface AutomationExecution {
+    id: string;
+    spaceId: string;
+    flowId: string;
+    flowVersionId: string;
+    flowVersion: number;
+    entryPointId: string;
+    status: AutomationExecutionStatus;
+    customer?: AutomationCustomer | null;
+    trigger: AutomationExecutionTrigger;
+    input: AutomationJsonObject;
+    /** Scope tipado y extensible utilizado durante la ejecución. */
+    context: AutomationExecutionContext;
+    output?: AutomationJsonObject | null;
+    error?: AutomationError | null;
+    createdAt: string;
+    startedAt?: string | null;
+    completedAt?: string | null;
+    cancelledAt?: string | null;
+    cancelledBy?: string | null;
+    correlationId?: string | null;
+    parentExecutionId?: string | null;
+    usage: AutomationExecutionUsage;
+    /** Ausente únicamente en ejecuciones creadas con contratos anteriores. */
+    purpose?: AutomationExecutionPurpose | null;
+    requestedEffectMode?: AutomationExecutionEffectMode | null;
+    effectiveEffectMode?: AutomationExecutionEffectMode | null;
+    scope?: AutomationExecutionScope | null;
+    source?: AutomationExecutionSource | null;
+    snapshot?: AutomationFlowSnapshotReference | null;
+    lineage?: AutomationExecutionLineage | null;
+    startedBy?: AutomationResourceReference | null;
+    policySummary?: AutomationExecutionPolicySummary | null;
+    testCaseId?: string | null;
+    testCaseRevision?: number | null;
+}
+export interface AutomationExecutionStep {
+    id: string;
+    executionId: string;
+    nodeId: string;
+    nodeDefinitionCode: string;
+    nodeDefinitionVersion: number;
+    sequence: number;
+    attempt: number;
+    status: AutomationExecutionStepStatus;
+    input?: AutomationJsonObject | null;
+    output?: AutomationJsonObject | null;
+    error?: AutomationError | null;
+    startedAt?: string | null;
+    completedAt?: string | null;
+    usage: AutomationExecutionUsage;
+    waitingReason?: string | null;
+    skippedReason?: string | null;
+    itemIndex?: number | null;
+    iteration?: number | null;
+    parentStepId?: string | null;
+    takenEdgeIds?: string[] | null;
+    effects?: AutomationExecutionEffectRecord[] | null;
+}
+export interface AutomationExecutionUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    totalCost: number;
+    currency: string;
+    durationMs: number;
+}
+export interface AutomationExecutionQuery extends AutomationPageRequest {
+    flowId?: string | null;
+    flowVersionId?: string | null;
+    entryPointId?: string | null;
+    contactId?: string | null;
+    businessId?: string | null;
+    customerSearch?: string | null;
+    statuses?: AutomationExecutionStatus[] | null;
+    createdFrom?: string | null;
+    createdTo?: string | null;
+    correlationId?: string | null;
+    purposes?: AutomationExecutionPurpose[] | null;
+    effectModes?: AutomationExecutionEffectMode[] | null;
+    testCaseId?: string | null;
+}
+export interface StartAutomationExecutionRequest {
+    flowId: string;
+    flowVersionId: string;
+    entryPointId: string;
+    customer?: AutomationCustomer | null;
+    trigger: AutomationExecutionTrigger;
+    input: AutomationJsonObject;
+    /** Variables iniciales y extensiones aportadas por el caller. */
+    context: AutomationExecutionContextInput;
+    idempotencyKey?: string | null;
+    correlationId?: string | null;
+    parentExecutionId?: string | null;
+}
+export interface CancelAutomationExecutionRequest {
+    reason?: string | null;
+}
+export interface RetryAutomationExecutionRequest {
+    fromStepId?: string | null;
+    inputOverrides?: AutomationJsonObject | null;
+}
+export interface AutomationExecutionDetails {
+    execution: AutomationExecution;
+    steps: AutomationExecutionStep[];
+}