@trii/types 2.10.691 → 2.10.694

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

@@ -4,6 +4,37 @@ export declare enum AutomationCapabilityKind {
     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.
@@ -19,6 +50,8 @@ export interface AutomationCapability {
     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[];

package/dist/Automations/Capabilities/Capability.js

@@ -1,9 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AutomationCapabilityKind = void 0;
+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/Automations/Common.d.ts

@@ -5,11 +5,33 @@
  * 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[];
@@ -50,6 +72,17 @@ 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

package/dist/Automations/Common.js

@@ -9,10 +9,32 @@ exports.AutomationSourceApplication = void 0;
  */
 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/Automations/Events/Event.d.ts

@@ -1,4 +1,4 @@
-import { AutomationCustomer, AutomationJsonObject, AutomationJsonSchema, AutomationSourceApplication } from '../Common';
+import { AutomationCustomer, AutomationJsonObject, AutomationJsonSchema, AutomationResourceReference, AutomationSourceApplication } from '../Common';
 export interface AutomationEventDefinition {
     eventType: string;
     version: number;
@@ -6,6 +6,7 @@ export interface AutomationEventDefinition {
     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;
@@ -19,23 +20,49 @@ export interface AutomationEventEnvelope {
     occurredAt: string;
     receivedAt: string;
     customer?: AutomationCustomer | null;
-    subjectId?: string | 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;
-    exclusionReason?: string | null;
+    /** Motivo de exclusión; ausente cuando selected es true. */
+    exclusion?: AutomationEntryPointExclusion | null;
 }
 export interface ResolveFlowEntryPointsResult {
     matches: ResolvedFlowEntryPoint[];

package/dist/Automations/Events/Event.js

@@ -1,2 +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/Automations/Executions/Execution.d.ts

@@ -1,4 +1,5 @@
-import { AutomationCustomer, AutomationError, AutomationJsonObject, AutomationPageRequest, AutomationSourceApplication } from '../Common';
+import { AutomationCustomer, AutomationError, AutomationJsonObject, AutomationPageRequest, AutomationResourceReference, AutomationSourceApplication } from '../Common';
+import { AutomationCapabilityEffectClass } from '../Capabilities';
 export declare enum AutomationExecutionStatus {
     QUEUED = "queued",
     RUNNING = "running",
@@ -17,15 +18,104 @@ export declare enum AutomationExecutionStepStatus {
     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;
-    referenceId?: string | null;
+    /** 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. */
@@ -35,6 +125,27 @@ export interface AutomationFlowExecutionReference {
     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;
@@ -46,7 +157,8 @@ export interface AutomationExecution {
     customer?: AutomationCustomer | null;
     trigger: AutomationExecutionTrigger;
     input: AutomationJsonObject;
-    context: AutomationJsonObject;
+    /** Scope tipado y extensible utilizado durante la ejecución. */
+    context: AutomationExecutionContext;
     output?: AutomationJsonObject | null;
     error?: AutomationError | null;
     createdAt: string;
@@ -57,6 +169,18 @@ export interface AutomationExecution {
     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;
@@ -73,6 +197,13 @@ export interface AutomationExecutionStep {
     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;
@@ -93,6 +224,9 @@ export interface AutomationExecutionQuery extends AutomationPageRequest {
     createdFrom?: string | null;
     createdTo?: string | null;
     correlationId?: string | null;
+    purposes?: AutomationExecutionPurpose[] | null;
+    effectModes?: AutomationExecutionEffectMode[] | null;
+    testCaseId?: string | null;
 }
 export interface StartAutomationExecutionRequest {
     flowId: string;
@@ -101,7 +235,8 @@ export interface StartAutomationExecutionRequest {
     customer?: AutomationCustomer | null;
     trigger: AutomationExecutionTrigger;
     input: AutomationJsonObject;
-    context: AutomationJsonObject;
+    /** Variables iniciales y extensiones aportadas por el caller. */
+    context: AutomationExecutionContextInput;
     idempotencyKey?: string | null;
     correlationId?: string | null;
     parentExecutionId?: string | null;

package/dist/Automations/Executions/Execution.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AutomationExecutionStepStatus = exports.AutomationExecutionStatus = void 0;
+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";
@@ -21,3 +21,42 @@ var AutomationExecutionStepStatus;
     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/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/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/Automations/Executions/index.d.ts

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

package/dist/Automations/Executions/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./Execution"), exports);
+__exportStar(require("./Testing"), exports);

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

@@ -1,4 +1,5 @@
-import { AutomationJsonObject, AutomationJsonValue } from '../Common';
+import { AutomationJsonObject, AutomationJsonSchema, AutomationJsonValue } from '../Common';
+import type { AutomationNodeVisibilityRule } from '../Nodes';
 export declare enum AutomationFlowVariableType {
     STRING = "string",
     NUMBER = "number",
@@ -32,7 +33,8 @@ export interface AutomationFlowVariable {
     type: AutomationFlowVariableType;
     isInput: boolean;
     isOutput: boolean;
-    schema?: AutomationJsonObject | null;
+    /** JSON Schema que restringe el valor permitido para la variable. */
+    schema?: AutomationJsonSchema | null;
     defaultValue?: AutomationJsonValue;
 }
 export interface AutomationFlowViewport {
@@ -96,6 +98,6 @@ export interface AutomationNodeHandle {
     multiple: boolean;
     showName: boolean;
     tags: string[];
-    showWhen?: AutomationJsonObject | null;
-    hideWhen?: AutomationJsonObject | null;
+    showWhen?: AutomationNodeVisibilityRule | null;
+    hideWhen?: AutomationNodeVisibilityRule | null;
 }

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

@@ -1,5 +1,5 @@
 import { AutomationCapabilityReference } from '../Capabilities';
-import { AutomationJsonObject, AutomationSourceApplication } from '../Common';
+import { AutomationJsonObject, AutomationJsonValue, AutomationSourceApplication } from '../Common';
 import { AutomationFlowEdge, AutomationCanvasAnnotation, AutomationFlowNode, AutomationFlowVariable, AutomationFlowViewport } from './Canvas';
 export declare enum AutomationFlowKind {
     CONVERSATIONAL = "conversational",
@@ -28,6 +28,48 @@ export declare enum FlowEntryPointExecutionMode {
     /** 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.
  */
@@ -95,7 +137,8 @@ export interface FlowEntryPoint {
     sourceApplication: AutomationSourceApplication;
     eventType: string;
     triggerCapability?: AutomationCapabilityReference | null;
-    filters: AutomationJsonObject;
+    /** Grupo vacío acepta cualquier evento del tipo configurado. */
+    filters: AutomationFilterGroup;
     enabled: boolean;
     triggerNodeId: string;
     priority: number;

package/dist/Automations/Flows/Flow.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FlowEntryPointExecutionMode = exports.AutomationFlowVersionStatus = exports.AutomationFlowStatus = exports.AutomationFlowKind = void 0;
+exports.AutomationFilterOperator = exports.AutomationFilterLogicalOperator = exports.FlowEntryPointExecutionMode = exports.AutomationFlowVersionStatus = exports.AutomationFlowStatus = exports.AutomationFlowKind = void 0;
 var AutomationFlowKind;
 (function (AutomationFlowKind) {
     AutomationFlowKind["CONVERSATIONAL"] = "conversational";
@@ -32,3 +32,27 @@ var FlowEntryPointExecutionMode;
     /** 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 = {}));

package/dist/Automations/Nodes/Node.d.ts

@@ -15,6 +15,37 @@ export declare enum AutomationNodePropertyEditor {
     ASYNC_OPTIONS = "asyncOptions",
     ASYNC_MULTI_OPTIONS = "asyncMultiOptions"
 }
+export declare enum AutomationNodeVisibilityLogicalOperator {
+    ALL = "all",
+    ANY = "any"
+}
+export declare enum AutomationNodeConditionOperator {
+    EQUALS = "equals"
+}
+export interface AutomationNodeCondition {
+    propertyId: string;
+    operator: AutomationNodeConditionOperator;
+    value?: AutomationJsonValue;
+}
+export interface AutomationNodeVisibilityRule {
+    logicalOperator: AutomationNodeVisibilityLogicalOperator;
+    conditions: AutomationNodeCondition[];
+}
+export interface AutomationNodePropertyUi {
+    tabId: string;
+    tabLabel: string;
+    order: number;
+    labelKey?: string | null;
+    placeholder?: string | null;
+    rows?: number | null;
+    numberMin?: number | null;
+    numberMax?: number | null;
+    step?: number | null;
+    acceptVariable?: boolean | null;
+    acceptEmojis?: boolean | null;
+    allowMaximizeInput?: boolean | null;
+    itemProperties: AutomationNodePropertyDefinition[];
+}
 export interface AutomationNodeDefinition {
     code: string;
     version: number;
@@ -44,9 +75,9 @@ export interface AutomationNodePropertyDefinition {
     schema?: AutomationJsonSchema | null;
     options: AutomationNodeOption[];
     optionsCapabilityCode?: string | null;
-    ui?: AutomationJsonObject | null;
-    showWhen?: AutomationJsonObject | null;
-    hideWhen?: AutomationJsonObject | null;
+    ui: AutomationNodePropertyUi;
+    showWhen?: AutomationNodeVisibilityRule | null;
+    hideWhen?: AutomationNodeVisibilityRule | null;
 }
 export interface AutomationNodeOption {
     id: string;

package/dist/Automations/Nodes/Node.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AutomationNodePropertyEditor = void 0;
+exports.AutomationNodeConditionOperator = exports.AutomationNodeVisibilityLogicalOperator = exports.AutomationNodePropertyEditor = void 0;
 var AutomationNodePropertyEditor;
 (function (AutomationNodePropertyEditor) {
     AutomationNodePropertyEditor["STRING"] = "string";
@@ -16,3 +16,12 @@ var AutomationNodePropertyEditor;
     AutomationNodePropertyEditor["ASYNC_OPTIONS"] = "asyncOptions";
     AutomationNodePropertyEditor["ASYNC_MULTI_OPTIONS"] = "asyncMultiOptions";
 })(AutomationNodePropertyEditor || (exports.AutomationNodePropertyEditor = AutomationNodePropertyEditor = {}));
+var AutomationNodeVisibilityLogicalOperator;
+(function (AutomationNodeVisibilityLogicalOperator) {
+    AutomationNodeVisibilityLogicalOperator["ALL"] = "all";
+    AutomationNodeVisibilityLogicalOperator["ANY"] = "any";
+})(AutomationNodeVisibilityLogicalOperator || (exports.AutomationNodeVisibilityLogicalOperator = AutomationNodeVisibilityLogicalOperator = {}));
+var AutomationNodeConditionOperator;
+(function (AutomationNodeConditionOperator) {
+    AutomationNodeConditionOperator["EQUALS"] = "equals";
+})(AutomationNodeConditionOperator || (exports.AutomationNodeConditionOperator = AutomationNodeConditionOperator = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trii/types",
-  "version": "2.10.691",
+  "version": "2.10.694",
   "description": "Types definitions for Trii projects - ",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",