@trii/types 2.10.692 → 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/Executions/Execution.d.ts

@@ -1,4 +1,5 @@
 import { AutomationCustomer, AutomationError, AutomationJsonObject, AutomationPageRequest, AutomationResourceReference, AutomationSourceApplication } from '../Common';
+import { AutomationCapabilityEffectClass } from '../Capabilities';
 export declare enum AutomationExecutionStatus {
     QUEUED = "queued",
     RUNNING = "running",
@@ -17,6 +18,89 @@ 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.
  */
@@ -85,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;
@@ -101,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;
@@ -121,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;

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/package.json

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