@trii/types 2.10.764 → 2.10.766

package/dist/src/Automations/Executions/Execution.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutomationExecutionEffectDecision = exports.AutomationExecutionLineageOperation = exports.AutomationExecutionSourceKind = exports.AutomationExecutionScopeKind = exports.AutomationExecutionEffectMode = exports.AutomationExecutionPurpose = exports.AutomationExecutionStepStatus = exports.AutomationExecutionStatus = void 0;
+var AutomationExecutionStatus;
+(function (AutomationExecutionStatus) {
+    AutomationExecutionStatus["QUEUED"] = "queued";
+    AutomationExecutionStatus["RUNNING"] = "running";
+    AutomationExecutionStatus["WAITING"] = "waiting";
+    AutomationExecutionStatus["SUCCEEDED"] = "succeeded";
+    AutomationExecutionStatus["FAILED"] = "failed";
+    AutomationExecutionStatus["CANCELLED"] = "cancelled";
+    AutomationExecutionStatus["TIMED_OUT"] = "timedOut";
+})(AutomationExecutionStatus || (exports.AutomationExecutionStatus = AutomationExecutionStatus = {}));
+var AutomationExecutionStepStatus;
+(function (AutomationExecutionStepStatus) {
+    AutomationExecutionStepStatus["PENDING"] = "pending";
+    AutomationExecutionStepStatus["RUNNING"] = "running";
+    AutomationExecutionStepStatus["WAITING"] = "waiting";
+    AutomationExecutionStepStatus["SUCCEEDED"] = "succeeded";
+    AutomationExecutionStepStatus["FAILED"] = "failed";
+    AutomationExecutionStepStatus["SKIPPED"] = "skipped";
+    AutomationExecutionStepStatus["CANCELLED"] = "cancelled";
+})(AutomationExecutionStepStatus || (exports.AutomationExecutionStepStatus = AutomationExecutionStepStatus = {}));
+var AutomationExecutionPurpose;
+(function (AutomationExecutionPurpose) {
+    AutomationExecutionPurpose["PRODUCTION"] = "production";
+    AutomationExecutionPurpose["TEST"] = "test";
+})(AutomationExecutionPurpose || (exports.AutomationExecutionPurpose = AutomationExecutionPurpose = {}));
+var AutomationExecutionEffectMode;
+(function (AutomationExecutionEffectMode) {
+    AutomationExecutionEffectMode["SIMULATE"] = "simulate";
+    AutomationExecutionEffectMode["TEST_TARGETS"] = "testTargets";
+    AutomationExecutionEffectMode["REAL"] = "real";
+})(AutomationExecutionEffectMode || (exports.AutomationExecutionEffectMode = AutomationExecutionEffectMode = {}));
+var AutomationExecutionScopeKind;
+(function (AutomationExecutionScopeKind) {
+    AutomationExecutionScopeKind["FULL"] = "full";
+    AutomationExecutionScopeKind["UNTIL_NODE"] = "untilNode";
+    AutomationExecutionScopeKind["FROM_NODE"] = "fromNode";
+    AutomationExecutionScopeKind["NODE_ONLY"] = "nodeOnly";
+})(AutomationExecutionScopeKind || (exports.AutomationExecutionScopeKind = AutomationExecutionScopeKind = {}));
+var AutomationExecutionSourceKind;
+(function (AutomationExecutionSourceKind) {
+    AutomationExecutionSourceKind["MANUAL"] = "manual";
+    AutomationExecutionSourceKind["FIXTURE"] = "fixture";
+    AutomationExecutionSourceKind["CAPTURED_EVENT"] = "capturedEvent";
+    AutomationExecutionSourceKind["EXECUTION"] = "execution";
+    AutomationExecutionSourceKind["STEP_OUTPUT"] = "stepOutput";
+})(AutomationExecutionSourceKind || (exports.AutomationExecutionSourceKind = AutomationExecutionSourceKind = {}));
+var AutomationExecutionLineageOperation;
+(function (AutomationExecutionLineageOperation) {
+    AutomationExecutionLineageOperation["NEW"] = "new";
+    AutomationExecutionLineageOperation["REPLAY"] = "replay";
+    AutomationExecutionLineageOperation["RETRY"] = "retry";
+})(AutomationExecutionLineageOperation || (exports.AutomationExecutionLineageOperation = AutomationExecutionLineageOperation = {}));
+var AutomationExecutionEffectDecision;
+(function (AutomationExecutionEffectDecision) {
+    AutomationExecutionEffectDecision["EXECUTED"] = "executed";
+    AutomationExecutionEffectDecision["SIMULATED"] = "simulated";
+    AutomationExecutionEffectDecision["REDIRECTED"] = "redirected";
+    AutomationExecutionEffectDecision["BLOCKED"] = "blocked";
+})(AutomationExecutionEffectDecision || (exports.AutomationExecutionEffectDecision = AutomationExecutionEffectDecision = {}));

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

@@ -0,0 +1,166 @@
+import { AutomationCustomer, AutomationJsonObject, AutomationJsonSchema, AutomationJsonValue, AutomationResourceReference } from '../Common';
+import { AutomationCapabilityEffectClass } from '../Capabilities';
+import { AutomationExecutionContextInput, AutomationExecutionEffectMode, AutomationExecutionScope, AutomationExecutionSource, AutomationFlowSnapshotReference } from './Execution';
+export declare enum AutomationArtifactStatus {
+    UPLOADING = "uploading",
+    SCANNING = "scanning",
+    AVAILABLE = "available",
+    REJECTED = "rejected",
+    EXPIRED = "expired"
+}
+export declare enum AutomationArtifactOrigin {
+    UPLOAD = "upload",
+    CAPTURED_EVENT = "capturedEvent",
+    EXECUTION = "execution",
+    GENERATED = "generated"
+}
+export interface AutomationArtifactReference {
+    id: string;
+    name: string;
+    mimeType: string;
+    size: number;
+    origin: AutomationArtifactOrigin;
+    status: AutomationArtifactStatus;
+    checksum?: string | null;
+    expiresAt?: string | null;
+    owner?: AutomationResourceReference | null;
+}
+export declare enum AutomationTestCaseVisibility {
+    PRIVATE = "private",
+    SHARED = "shared"
+}
+export declare enum AutomationTestAssertionKind {
+    EXECUTION_STATUS = "executionStatus",
+    NODE_REACHED = "nodeReached",
+    NODE_NOT_REACHED = "nodeNotReached",
+    PATH_EXISTS = "pathExists",
+    PATH_TYPE = "pathType",
+    PATH_VALUE = "pathValue",
+    ERROR_CODE = "errorCode",
+    MAX_DURATION = "maxDuration",
+    MAX_COST = "maxCost"
+}
+export declare enum AutomationTestAssertionStatus {
+    PENDING = "pending",
+    PASSED = "passed",
+    FAILED = "failed",
+    SKIPPED = "skipped"
+}
+export interface AutomationTestAssertion {
+    id: string;
+    kind: AutomationTestAssertionKind;
+    nodeId?: string | null;
+    path?: string | null;
+    expected?: AutomationJsonValue;
+    configuration?: AutomationJsonObject | null;
+}
+export interface AutomationTestAssertionResult {
+    assertionId: string;
+    status: AutomationTestAssertionStatus;
+    message?: string | null;
+    actual?: AutomationJsonValue;
+}
+/** Configuración común utilizada por preflight e inicio de una prueba. */
+export interface AutomationTestConfiguration {
+    flowId: string;
+    flowVersionId?: string | null;
+    draftRevision?: number | null;
+    entryPointId: string;
+    scope: AutomationExecutionScope;
+    requestedEffectMode: AutomationExecutionEffectMode;
+    source: AutomationExecutionSource;
+    customer?: AutomationCustomer | null;
+    input?: AutomationJsonObject | null;
+    context?: AutomationExecutionContextInput | null;
+    nodeInputOverrides?: Record<string, AutomationJsonObject> | null;
+    artifactIds?: string[] | null;
+    testTargetOverrides?: AutomationJsonObject | null;
+}
+export interface StartAutomationTestRequest extends AutomationTestConfiguration {
+    idempotencyKey: string;
+    correlationId?: string | null;
+    testCaseId?: string | null;
+    testCaseRevision?: number | null;
+    preflightToken?: string | null;
+}
+export interface AutomationTestPreflightRequest extends AutomationTestConfiguration {
+}
+export declare enum AutomationTestPreflightStatus {
+    READY = "ready",
+    WARNING = "warning",
+    BLOCKED = "blocked"
+}
+export declare enum AutomationTestPreflightIssueSeverity {
+    INFO = "info",
+    WARNING = "warning",
+    BLOCKER = "blocker"
+}
+export interface AutomationTestPreflightIssue {
+    code: string;
+    severity: AutomationTestPreflightIssueSeverity;
+    message: string;
+    nodeId?: string | null;
+    details?: AutomationJsonObject | null;
+}
+export interface AutomationTestPreflightNode {
+    nodeId: string;
+    nodeDefinitionCode: string;
+    nodeDefinitionVersion: number;
+    reachable: boolean;
+    executable: boolean;
+    issues: AutomationTestPreflightIssue[];
+}
+export interface AutomationTestPreflightEffect {
+    nodeId: string;
+    effectClass: AutomationCapabilityEffectClass;
+    action: string;
+    description?: string | null;
+    originalTarget?: AutomationResourceReference | null;
+    effectiveTarget?: AutomationResourceReference | null;
+    estimatedItems?: number | null;
+}
+export interface AutomationTestPreflightLimits {
+    maxDurationMs?: number | null;
+    maxSteps?: number | null;
+    maxIterations?: number | null;
+    maxItems?: number | null;
+    estimatedCost?: number | null;
+    currency?: string | null;
+}
+export interface AutomationTestPreflightResult {
+    status: AutomationTestPreflightStatus;
+    snapshot: AutomationFlowSnapshotReference;
+    requestedEffectMode: AutomationExecutionEffectMode;
+    effectiveEffectMode: AutomationExecutionEffectMode;
+    nodes: AutomationTestPreflightNode[];
+    effects: AutomationTestPreflightEffect[];
+    issues: AutomationTestPreflightIssue[];
+    limits: AutomationTestPreflightLimits;
+    requiresConfirmation: boolean;
+    preflightToken: string;
+    expiresAt: string;
+}
+export interface AutomationTestCase {
+    id: string;
+    spaceId: string;
+    flowId: string;
+    name: string;
+    description?: string | null;
+    revision: number;
+    visibility: AutomationTestCaseVisibility;
+    configuration: AutomationTestConfiguration;
+    assertions: AutomationTestAssertion[];
+    createdBy: string;
+    createdAt: string;
+    updatedBy?: string | null;
+    updatedAt?: string | null;
+}
+/** Schema opcional para que el Estudio genere un simulador por Entry Point. */
+export interface AutomationEntryPointTestSchema {
+    entryPointId: string;
+    inputSchema?: AutomationJsonSchema | null;
+    contextSchema?: AutomationJsonSchema | null;
+    allowedArtifactMimeTypes?: string[] | null;
+    maxArtifactSize?: number | null;
+    maxArtifacts?: number | null;
+}

package/dist/src/Automations/Executions/Testing.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutomationTestPreflightIssueSeverity = exports.AutomationTestPreflightStatus = exports.AutomationTestAssertionStatus = exports.AutomationTestAssertionKind = exports.AutomationTestCaseVisibility = exports.AutomationArtifactOrigin = exports.AutomationArtifactStatus = void 0;
+var AutomationArtifactStatus;
+(function (AutomationArtifactStatus) {
+    AutomationArtifactStatus["UPLOADING"] = "uploading";
+    AutomationArtifactStatus["SCANNING"] = "scanning";
+    AutomationArtifactStatus["AVAILABLE"] = "available";
+    AutomationArtifactStatus["REJECTED"] = "rejected";
+    AutomationArtifactStatus["EXPIRED"] = "expired";
+})(AutomationArtifactStatus || (exports.AutomationArtifactStatus = AutomationArtifactStatus = {}));
+var AutomationArtifactOrigin;
+(function (AutomationArtifactOrigin) {
+    AutomationArtifactOrigin["UPLOAD"] = "upload";
+    AutomationArtifactOrigin["CAPTURED_EVENT"] = "capturedEvent";
+    AutomationArtifactOrigin["EXECUTION"] = "execution";
+    AutomationArtifactOrigin["GENERATED"] = "generated";
+})(AutomationArtifactOrigin || (exports.AutomationArtifactOrigin = AutomationArtifactOrigin = {}));
+var AutomationTestCaseVisibility;
+(function (AutomationTestCaseVisibility) {
+    AutomationTestCaseVisibility["PRIVATE"] = "private";
+    AutomationTestCaseVisibility["SHARED"] = "shared";
+})(AutomationTestCaseVisibility || (exports.AutomationTestCaseVisibility = AutomationTestCaseVisibility = {}));
+var AutomationTestAssertionKind;
+(function (AutomationTestAssertionKind) {
+    AutomationTestAssertionKind["EXECUTION_STATUS"] = "executionStatus";
+    AutomationTestAssertionKind["NODE_REACHED"] = "nodeReached";
+    AutomationTestAssertionKind["NODE_NOT_REACHED"] = "nodeNotReached";
+    AutomationTestAssertionKind["PATH_EXISTS"] = "pathExists";
+    AutomationTestAssertionKind["PATH_TYPE"] = "pathType";
+    AutomationTestAssertionKind["PATH_VALUE"] = "pathValue";
+    AutomationTestAssertionKind["ERROR_CODE"] = "errorCode";
+    AutomationTestAssertionKind["MAX_DURATION"] = "maxDuration";
+    AutomationTestAssertionKind["MAX_COST"] = "maxCost";
+})(AutomationTestAssertionKind || (exports.AutomationTestAssertionKind = AutomationTestAssertionKind = {}));
+var AutomationTestAssertionStatus;
+(function (AutomationTestAssertionStatus) {
+    AutomationTestAssertionStatus["PENDING"] = "pending";
+    AutomationTestAssertionStatus["PASSED"] = "passed";
+    AutomationTestAssertionStatus["FAILED"] = "failed";
+    AutomationTestAssertionStatus["SKIPPED"] = "skipped";
+})(AutomationTestAssertionStatus || (exports.AutomationTestAssertionStatus = AutomationTestAssertionStatus = {}));
+var AutomationTestPreflightStatus;
+(function (AutomationTestPreflightStatus) {
+    AutomationTestPreflightStatus["READY"] = "ready";
+    AutomationTestPreflightStatus["WARNING"] = "warning";
+    AutomationTestPreflightStatus["BLOCKED"] = "blocked";
+})(AutomationTestPreflightStatus || (exports.AutomationTestPreflightStatus = AutomationTestPreflightStatus = {}));
+var AutomationTestPreflightIssueSeverity;
+(function (AutomationTestPreflightIssueSeverity) {
+    AutomationTestPreflightIssueSeverity["INFO"] = "info";
+    AutomationTestPreflightIssueSeverity["WARNING"] = "warning";
+    AutomationTestPreflightIssueSeverity["BLOCKER"] = "blocker";
+})(AutomationTestPreflightIssueSeverity || (exports.AutomationTestPreflightIssueSeverity = AutomationTestPreflightIssueSeverity = {}));

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

@@ -0,0 +1,2 @@
+export * from './Execution';
+export * from './Testing';

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

@@ -0,0 +1,18 @@
+"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("./Execution"), exports);
+__exportStar(require("./Testing"), exports);

package/dist/src/Automations/Flows/Canvas.d.ts

@@ -0,0 +1,103 @@
+import { AutomationJsonObject, AutomationJsonSchema, AutomationJsonValue } from '../Common';
+import type { AutomationNodeVisibilityRule } from '../Nodes';
+export declare enum AutomationFlowVariableType {
+    STRING = "string",
+    NUMBER = "number",
+    BOOLEAN = "boolean",
+    DATE = "date",
+    JSON = "json",
+    ARRAY = "array"
+}
+export declare enum AutomationNodeKind {
+    TRIGGER = "trigger",
+    ACTION = "action",
+    CONDITION = "condition",
+    AGENT = "agent",
+    TOOL = "tool",
+    MESSAGE = "message",
+    CONTROL = "control"
+}
+export declare enum AutomationNodeHandleType {
+    SOURCE = "source",
+    TARGET = "target"
+}
+export declare enum AutomationNodeHandlePosition {
+    LEFT = "left",
+    RIGHT = "right",
+    TOP = "top",
+    BOTTOM = "bottom"
+}
+export interface AutomationFlowVariable {
+    name: string;
+    description?: string | null;
+    type: AutomationFlowVariableType;
+    isInput: boolean;
+    isOutput: boolean;
+    /** JSON Schema que restringe el valor permitido para la variable. */
+    schema?: AutomationJsonSchema | null;
+    defaultValue?: AutomationJsonValue;
+}
+export interface AutomationFlowViewport {
+    x: number;
+    y: number;
+    zoom: number;
+}
+export interface AutomationNodePosition {
+    x: number;
+    y: number;
+}
+export declare enum AutomationCanvasAnnotationType {
+    NOTE = "note"
+}
+/** Elemento puramente visual del canvas; no participa de la ejecución. */
+export interface AutomationCanvasAnnotation {
+    id: string;
+    type: AutomationCanvasAnnotationType;
+    title?: string | null;
+    text: string;
+    position: AutomationNodePosition;
+    width: number;
+    height: number;
+    color: string;
+    metadata?: AutomationJsonObject | null;
+}
+export interface AutomationFlowNode {
+    id: string;
+    /** Clave del renderer visual; no representa una regla de negocio. */
+    type: string;
+    data: AutomationNodeInstance;
+    position: AutomationNodePosition;
+}
+export interface AutomationNodeInstance {
+    definitionCode: string;
+    definitionVersion: number;
+    kind: AutomationNodeKind;
+    name: string;
+    values: AutomationJsonObject;
+    metadata?: AutomationJsonObject | null;
+    disabled: boolean;
+}
+export interface AutomationFlowEdge {
+    id: string;
+    type: string;
+    source: string;
+    sourceHandle?: string | null;
+    target: string;
+    targetHandle?: string | null;
+    data: AutomationFlowEdgeData;
+}
+export interface AutomationFlowEdgeData {
+    label?: string | null;
+    metadata?: AutomationJsonObject | null;
+}
+export interface AutomationNodeHandle {
+    id: string;
+    name: string;
+    type: AutomationNodeHandleType;
+    position: AutomationNodeHandlePosition;
+    multiple: boolean;
+    showName: boolean;
+    tags: string[];
+    showWhen?: AutomationNodeVisibilityRule | null;
+    hideWhen?: AutomationNodeVisibilityRule | null;
+}

package/dist/src/Automations/Flows/Canvas.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutomationCanvasAnnotationType = exports.AutomationNodeHandlePosition = exports.AutomationNodeHandleType = exports.AutomationNodeKind = exports.AutomationFlowVariableType = void 0;
+var AutomationFlowVariableType;
+(function (AutomationFlowVariableType) {
+    AutomationFlowVariableType["STRING"] = "string";
+    AutomationFlowVariableType["NUMBER"] = "number";
+    AutomationFlowVariableType["BOOLEAN"] = "boolean";
+    AutomationFlowVariableType["DATE"] = "date";
+    AutomationFlowVariableType["JSON"] = "json";
+    AutomationFlowVariableType["ARRAY"] = "array";
+})(AutomationFlowVariableType || (exports.AutomationFlowVariableType = AutomationFlowVariableType = {}));
+var AutomationNodeKind;
+(function (AutomationNodeKind) {
+    AutomationNodeKind["TRIGGER"] = "trigger";
+    AutomationNodeKind["ACTION"] = "action";
+    AutomationNodeKind["CONDITION"] = "condition";
+    AutomationNodeKind["AGENT"] = "agent";
+    AutomationNodeKind["TOOL"] = "tool";
+    AutomationNodeKind["MESSAGE"] = "message";
+    AutomationNodeKind["CONTROL"] = "control";
+})(AutomationNodeKind || (exports.AutomationNodeKind = AutomationNodeKind = {}));
+var AutomationNodeHandleType;
+(function (AutomationNodeHandleType) {
+    AutomationNodeHandleType["SOURCE"] = "source";
+    AutomationNodeHandleType["TARGET"] = "target";
+})(AutomationNodeHandleType || (exports.AutomationNodeHandleType = AutomationNodeHandleType = {}));
+var AutomationNodeHandlePosition;
+(function (AutomationNodeHandlePosition) {
+    AutomationNodeHandlePosition["LEFT"] = "left";
+    AutomationNodeHandlePosition["RIGHT"] = "right";
+    AutomationNodeHandlePosition["TOP"] = "top";
+    AutomationNodeHandlePosition["BOTTOM"] = "bottom";
+})(AutomationNodeHandlePosition || (exports.AutomationNodeHandlePosition = AutomationNodeHandlePosition = {}));
+var AutomationCanvasAnnotationType;
+(function (AutomationCanvasAnnotationType) {
+    AutomationCanvasAnnotationType["NOTE"] = "note";
+})(AutomationCanvasAnnotationType || (exports.AutomationCanvasAnnotationType = AutomationCanvasAnnotationType = {}));

package/dist/src/Automations/Flows/Flow.d.ts

@@ -0,0 +1,147 @@
+import { AutomationCapabilityReference } from '../Capabilities';
+import { AutomationJsonObject, AutomationJsonValue, AutomationSourceApplication } from '../Common';
+import { AutomationFlowEdge, AutomationCanvasAnnotation, AutomationFlowNode, AutomationFlowVariable, AutomationFlowViewport } from './Canvas';
+export declare enum AutomationFlowKind {
+    CONVERSATIONAL = "conversational",
+    VOICE = "voice",
+    CAMPAIGN = "campaign",
+    MARKETING = "marketing",
+    TICKET = "ticket",
+    SALES = "sales",
+    GENERIC = "generic"
+}
+export declare enum AutomationFlowStatus {
+    DRAFT = "draft",
+    ACTIVE = "active",
+    DISABLED = "disabled",
+    ARCHIVED = "archived"
+}
+export declare enum AutomationFlowVersionStatus {
+    DRAFT = "draft",
+    TESTING = "testing",
+    PUBLISHED = "published",
+    DEPRECATED = "deprecated"
+}
+export declare enum FlowEntryPointExecutionMode {
+    /** Un evento inicia como máximo una ejecución de esta versión del Flow. */
+    SINGLE = "single",
+    /** El solapamiento fue habilitado explícitamente. */
+    MULTIPLE = "multiple"
+}
+export declare enum AutomationFilterLogicalOperator {
+    /** Todas las condiciones y grupos hijos deben cumplirse. */
+    ALL = "all",
+    /** Al menos una condición o grupo hijo debe cumplirse. */
+    ANY = "any"
+}
+export declare enum AutomationFilterOperator {
+    EQUALS = "equals",
+    NOT_EQUALS = "notEquals",
+    CONTAINS = "contains",
+    NOT_CONTAINS = "notContains",
+    STARTS_WITH = "startsWith",
+    ENDS_WITH = "endsWith",
+    GREATER_THAN = "greaterThan",
+    GREATER_THAN_OR_EQUAL = "greaterThanOrEqual",
+    LESS_THAN = "lessThan",
+    LESS_THAN_OR_EQUAL = "lessThanOrEqual",
+    IN = "in",
+    NOT_IN = "notIn",
+    EXISTS = "exists",
+    NOT_EXISTS = "notExists"
+}
+/** Comparación tipada aplicada a un campo de un evento. */
+export interface AutomationFilterCondition {
+    /** JSON Pointer RFC 6901 absoluto dentro del envelope. */
+    path: string;
+    /** Operación utilizada para comparar el campo. */
+    operator: AutomationFilterOperator;
+    /** Valor esperado; no aplica a exists/notExists. */
+    value?: AutomationJsonValue;
+    /** Sensibilidad de comparaciones de strings; por defecto es true. */
+    caseSensitive?: boolean | null;
+}
+/** Grupo recursivo de filtros combinados mediante all o any. */
+export interface AutomationFilterGroup {
+    /** Forma en que se combinan condiciones y grupos hijos. */
+    logicalOperator: AutomationFilterLogicalOperator;
+    /** Comparaciones directas pertenecientes al grupo. */
+    conditions: AutomationFilterCondition[];
+    /** Grupos anidados. */
+    groups: AutomationFilterGroup[];
+}
+/**
+ * Identidad estable del Flow. El contenido ejecutable vive en FlowVersion.
+ */
+export interface AutomationFlowDefinition {
+    id: string;
+    spaceId: string;
+    name: string;
+    description?: string | null;
+    kind: AutomationFlowKind;
+    status: AutomationFlowStatus;
+    ownerId?: string | null;
+    tags: string[];
+    draftVersionId?: string | null;
+    activeVersionId?: string | null;
+    createdAt: string;
+    createdBy: string;
+    updatedAt?: string | null;
+    updatedBy?: string | null;
+    deletedAt?: string | null;
+}
+/**
+ * Snapshot del canvas.
+ *
+ * El canvas pertenece a Automations y no depende de contratos de otras
+ * aplicaciones.
+ */
+export interface AutomationFlowCanvas {
+    variables: AutomationFlowVariable[];
+    nodes: AutomationFlowNode[];
+    edges: AutomationFlowEdge[];
+    /** Anotaciones visuales que no forman parte del grafo ejecutable. */
+    annotations?: AutomationCanvasAnnotation[];
+    viewport: AutomationFlowViewport;
+}
+/**
+ * Snapshot versionado e inmutable una vez publicado.
+ */
+export interface AutomationFlowVersion {
+    id: string;
+    flowId: string;
+    version: number;
+    schemaVersion: number;
+    revision: number;
+    status: AutomationFlowVersionStatus;
+    canvas: AutomationFlowCanvas;
+    entryPoints: FlowEntryPoint[];
+    createdAt: string;
+    createdBy: string;
+    updatedAt?: string | null;
+    updatedBy?: string | null;
+    publishedAt?: string | null;
+    publishedBy?: string | null;
+}
+/**
+ * Evento de entrada que puede iniciar una versión concreta de un Flow.
+ *
+ * La configuración autoritativa vive en esta entidad. El nodo trigger es su
+ * representación en el canvas y se vincula mediante triggerNodeId.
+ */
+export interface FlowEntryPoint {
+    id: string;
+    flowId: string;
+    flowVersionId: string;
+    name: string;
+    sourceApplication: AutomationSourceApplication;
+    eventType: string;
+    triggerCapability?: AutomationCapabilityReference | null;
+    /** Grupo vacío acepta cualquier evento del tipo configurado. */
+    filters: AutomationFilterGroup;
+    enabled: boolean;
+    triggerNodeId: string;
+    priority: number;
+    executionMode: FlowEntryPointExecutionMode;
+    metadata?: AutomationJsonObject | null;
+}

package/dist/src/Automations/Flows/Flow.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutomationFilterOperator = exports.AutomationFilterLogicalOperator = exports.FlowEntryPointExecutionMode = exports.AutomationFlowVersionStatus = exports.AutomationFlowStatus = exports.AutomationFlowKind = void 0;
+var AutomationFlowKind;
+(function (AutomationFlowKind) {
+    AutomationFlowKind["CONVERSATIONAL"] = "conversational";
+    AutomationFlowKind["VOICE"] = "voice";
+    AutomationFlowKind["CAMPAIGN"] = "campaign";
+    AutomationFlowKind["MARKETING"] = "marketing";
+    AutomationFlowKind["TICKET"] = "ticket";
+    AutomationFlowKind["SALES"] = "sales";
+    AutomationFlowKind["GENERIC"] = "generic";
+})(AutomationFlowKind || (exports.AutomationFlowKind = AutomationFlowKind = {}));
+var AutomationFlowStatus;
+(function (AutomationFlowStatus) {
+    AutomationFlowStatus["DRAFT"] = "draft";
+    AutomationFlowStatus["ACTIVE"] = "active";
+    AutomationFlowStatus["DISABLED"] = "disabled";
+    AutomationFlowStatus["ARCHIVED"] = "archived";
+})(AutomationFlowStatus || (exports.AutomationFlowStatus = AutomationFlowStatus = {}));
+var AutomationFlowVersionStatus;
+(function (AutomationFlowVersionStatus) {
+    AutomationFlowVersionStatus["DRAFT"] = "draft";
+    AutomationFlowVersionStatus["TESTING"] = "testing";
+    AutomationFlowVersionStatus["PUBLISHED"] = "published";
+    AutomationFlowVersionStatus["DEPRECATED"] = "deprecated";
+})(AutomationFlowVersionStatus || (exports.AutomationFlowVersionStatus = AutomationFlowVersionStatus = {}));
+var FlowEntryPointExecutionMode;
+(function (FlowEntryPointExecutionMode) {
+    /** Un evento inicia como máximo una ejecución de esta versión del Flow. */
+    FlowEntryPointExecutionMode["SINGLE"] = "single";
+    /** El solapamiento fue habilitado explícitamente. */
+    FlowEntryPointExecutionMode["MULTIPLE"] = "multiple";
+})(FlowEntryPointExecutionMode || (exports.FlowEntryPointExecutionMode = FlowEntryPointExecutionMode = {}));
+var AutomationFilterLogicalOperator;
+(function (AutomationFilterLogicalOperator) {
+    /** Todas las condiciones y grupos hijos deben cumplirse. */
+    AutomationFilterLogicalOperator["ALL"] = "all";
+    /** Al menos una condición o grupo hijo debe cumplirse. */
+    AutomationFilterLogicalOperator["ANY"] = "any";
+})(AutomationFilterLogicalOperator || (exports.AutomationFilterLogicalOperator = AutomationFilterLogicalOperator = {}));
+var AutomationFilterOperator;
+(function (AutomationFilterOperator) {
+    AutomationFilterOperator["EQUALS"] = "equals";
+    AutomationFilterOperator["NOT_EQUALS"] = "notEquals";
+    AutomationFilterOperator["CONTAINS"] = "contains";
+    AutomationFilterOperator["NOT_CONTAINS"] = "notContains";
+    AutomationFilterOperator["STARTS_WITH"] = "startsWith";
+    AutomationFilterOperator["ENDS_WITH"] = "endsWith";
+    AutomationFilterOperator["GREATER_THAN"] = "greaterThan";
+    AutomationFilterOperator["GREATER_THAN_OR_EQUAL"] = "greaterThanOrEqual";
+    AutomationFilterOperator["LESS_THAN"] = "lessThan";
+    AutomationFilterOperator["LESS_THAN_OR_EQUAL"] = "lessThanOrEqual";
+    AutomationFilterOperator["IN"] = "in";
+    AutomationFilterOperator["NOT_IN"] = "notIn";
+    AutomationFilterOperator["EXISTS"] = "exists";
+    AutomationFilterOperator["NOT_EXISTS"] = "notExists";
+})(AutomationFilterOperator || (exports.AutomationFilterOperator = AutomationFilterOperator = {}));