@hostwebhook/platform-contracts 0.23.0 → 0.24.0

package/dist/servicios/formas-compartidas.d.ts

@@ -78,6 +78,32 @@ export interface PasoEjecutado {
      * conditional; ver `EvaluacionDeRamas`.
      */
     evaluacion?: EvaluacionDeRamas;
+    /**
+     * En qué vuelta de qué bucle corrió [2026-09-29]: la pila de los bucles que
+     * lo contienen, del de FUERA al de DENTRO. Ausente fuera de un bucle, en las
+     * corridas de antes, y donde el motor la pierde (tras reanudar un approval).
+     * Ver `VueltaDeBucle`.
+     */
+    vueltas?: VueltaDeBucle[];
+}
+/**
+ * Una vuelta de un bucle, vista desde un paso que corre dentro de él
+ * [2026-09-29].
+ *
+ * Hace falta porque el historial sólo sabía el ORDEN de los pasos: en un
+ * bucle dentro de otro, «la tercera vez que corrió el cuerpo» no dice de qué
+ * pedido ni de qué artículo. La pila la lleva el motor en el contexto
+ * (`ContextoDeCorrida.pilaDeVueltas`) y cada paso se la queda.
+ */
+export interface VueltaDeBucle {
+    /** El id del nodo Loop. */
+    bucleId: string;
+    /** Su nombre cuando corrió, para la pantalla. */
+    nombre?: string;
+    /** La vuelta, contando desde 0. */
+    vuelta: number;
+    /** Cuántas vueltas da en esta pasada. */
+    total: number;
 }
 /**
  * Una condición de una rama, tal como se evaluó.

package/dist/servicios/index.d.ts

@@ -26,7 +26,7 @@
  * que está diseñada justo para que los secretos NO crucen a lo bruto. Ningún
  * secreto vive aquí.
  */
-export type { FileRef, ChunkingStrategy, RunStepStatus, PasoEjecutado as PasoEjecutadoDelSdk, CondicionEvaluada, ResultadoDeRama, RamaEvaluada, EvaluacionDeRamas, } from './formas-compartidas';
+export type { FileRef, ChunkingStrategy, RunStepStatus, PasoEjecutado as PasoEjecutadoDelSdk, CondicionEvaluada, ResultadoDeRama, RamaEvaluada, EvaluacionDeRamas, VueltaDeBucle, } from './formas-compartidas';
 export * from './almacenes-vectoriales';
 export * from './aprobaciones-pendientes';
 export * from './avisos-en-vivo';

package/dist/servicios/motor-de-ejecucion.d.ts

@@ -1,4 +1,5 @@
 import type { Types } from 'mongoose';
+import type { VueltaDeBucle } from './formas-compartidas';
 /**
  * Lo que un nodo le pide al motor de ejecución. Nada más.
  *
@@ -168,6 +169,13 @@ export interface ContextoDeCorrida {
      * detecta los ciclos de FlowLinks y aplica el `maxFlowCallDepth` del plan.
      */
     callStack?: string[];
+    /**
+     * La vuelta de cada bucle en el que se está, del de fuera al de dentro
+     * [2026-09-29]. La pone el bucle al despachar cada vuelta —a partir de su
+     * estado, no de lo que traiga el contexto—, y los pasos la guardan. Es
+     * JSON plano: cruza el cable tal cual.
+     */
+    pilaDeVueltas?: VueltaDeBucle[];
 }
 /** Una espera pendiente, de lo que el motor le lee. */
 export interface EsperaPendiente {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hostwebhook/platform-contracts",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "Contratos compartidos entre los servicios de HostWebhook: addons del plan, identidad interna, y las formas que cruzan una frontera de red",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",