@supertst/api 0.2.0 → 0.4.0

package/src/index.ts

@@ -33,6 +33,8 @@ export interface OptionDto {
   indice_opcion: number;
   /** @example {"texto":"..."} */
   contenido_json: object;
+  /** Texto plano de la opción (extraído de contenido_json) */
+  texto: string;
   es_correcta: boolean;
   explicacion?: object | null;
 }
@@ -861,6 +863,19 @@ export interface ReviewSessionInfoDto {
   config?: Record<string, any>;
 }
 
+export interface RepresentacionVisualDto {
+  tipo: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia";
+  version: "v1";
+  tabla_markdown?: object | null;
+  grafica_json?: object | null;
+  /** URL of the image in Supabase bucket (new questions). Injected from pregunta_imagenes table at response-build time. */
+  imagen_url?: object | null;
+  /** Inline SVG XML content (legacy/old questions). Used as fallback when imagen_url is not available. */
+  imagen_svg?: object | null;
+  /** Alt text / description for image accessibility. */
+  imagen_alt?: object | null;
+}
+
 export interface ReviewImageDto {
   /** @example "https://storage.example.com/image.png" */
   url: string;
@@ -877,6 +892,8 @@ export interface ReviewOptionDto {
   indice_opcion: number;
   /** Option content (text or structured) */
   contenido_json: Record<string, any>;
+  /** @example "La opcion correcta" */
+  texto: string;
   /** @example true */
   es_correcta: boolean;
   /** @example "Esta es la respuesta correcta porque..." */
@@ -895,6 +912,7 @@ export interface ReviewItemDto {
   id_clasificacion?: string;
   /** Question metadata */
   metadata?: Record<string, any>;
+  representacion_visual_enunciado?: RepresentacionVisualDto | null;
   /** @example 1 */
   orden: number;
   imagenes: ReviewImageDto[];
@@ -910,12 +928,12 @@ export interface ReviewItemDto {
 
 export interface ReviewGroupDto {
   /**
-   * Stimulus text
+   * Context text
    * @example "Lea el siguiente texto..."
    */
-  id_estimulo?: object;
-  /** Visual representation of the stimulus (object with tipo, version, descripcion, tabla_markdown, grafica_json, imagen_alt, imagen_svg). Same structure as diagnostico/start. */
-  representacion_visual_id_estimulo?: Record<string, any>;
+  contexto?: object;
+  /** Visual representation of the shared context. */
+  representacion_visual_id_estimulo?: RepresentacionVisualDto | null;
   items: ReviewItemDto[];
 }
 
@@ -1068,13 +1086,59 @@ export namespace V1 {
   }
 
   /**
-   * No description
-   * @tags trainer
-   * @name GetQuestionsByClasificacion
-   * @summary Obtener preguntas AI generadas por clasificación (agrupadas por contexto)
-   * @request GET:/v1/trainer/questions
-   * @response `200` `void` Questions retrieved successfully, grouped by context
-   */
+ * No description
+ * @tags trainer
+ * @name GetQuestionsByClasificacion
+ * @summary Obtener preguntas AI generadas por clasificación (agrupadas por contexto)
+ * @request GET:/v1/trainer/questions
+ * @response `200` `{
+    modelo_llm?: string,
+    grupos?: ({
+    contexto?: string | null,
+    representacion_visual_id_estimulo?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_svg?: string | null,
+    imagen_alt?: string | null,
+
+},
+    items?: ({
+  /** @format uuid *\/
+    id_item?: string,
+    ai_generated?: boolean,
+    enunciado?: string,
+    opciones?: ({
+    indice_opcion?: number,
+    contenido_json?: object | null,
+    texto?: string,
+    es_correcta?: boolean,
+    explicacion?: string | null,
+
+})[],
+    indice_respuesta?: number,
+    justificacion?: string | null,
+    dificultad?: "NIVEL 1" | "NIVEL 2" | "NIVEL 3" | "NIVEL 4" | null,
+    representacion_visual_enunciado?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_svg?: string | null,
+    imagen_alt?: string | null,
+
+},
+    id_clasificacion?: string,
+
+})[],
+
+})[],
+
+}` Questions retrieved successfully, grouped by context
+*/
   export namespace GetQuestionsByClasificacion {
     export type RequestParams = {};
     export type RequestQuery = {
@@ -1082,7 +1146,47 @@ export namespace V1 {
     };
     export type RequestBody = never;
     export type RequestHeaders = {};
-    export type ResponseBody = void;
+    export type ResponseBody = {
+      modelo_llm?: string;
+      grupos?: {
+        contexto?: string | null;
+        representacion_visual_id_estimulo?: {
+          tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia";
+          version?: "v1";
+          tabla_markdown?: string | null;
+          grafica_json?: object | null;
+          imagen_url?: string | null;
+          imagen_svg?: string | null;
+          imagen_alt?: string | null;
+        };
+        items?: {
+          /** @format uuid */
+          id_item?: string;
+          ai_generated?: boolean;
+          enunciado?: string;
+          opciones?: {
+            indice_opcion?: number;
+            contenido_json?: object | null;
+            texto?: string;
+            es_correcta?: boolean;
+            explicacion?: string | null;
+          }[];
+          indice_respuesta?: number;
+          justificacion?: string | null;
+          dificultad?: "NIVEL 1" | "NIVEL 2" | "NIVEL 3" | "NIVEL 4" | null;
+          representacion_visual_enunciado?: {
+            tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia";
+            version?: "v1";
+            tabla_markdown?: string | null;
+            grafica_json?: object | null;
+            imagen_url?: string | null;
+            imagen_svg?: string | null;
+            imagen_alt?: string | null;
+          };
+          id_clasificacion?: string;
+        }[];
+      }[];
+    };
   }
 
   /**
@@ -1092,8 +1196,84 @@ export namespace V1 {
  * @summary Obtener detalle de una pregunta por ID (id_item)
  * @request GET:/v1/trainer/questions/{id}
  * @response `200` `{
+  /** @example true *\/
     ok?: boolean,
-    data?: object,
+    data?: {
+    question?: {
+  /** @format uuid *\/
+    id_item?: string,
+    id_clasificacion?: string,
+    nombre_pregunta?: string | null,
+    enunciado?: string,
+    dificultad?: "NIVEL 1" | "NIVEL 2" | "NIVEL 3" | "NIVEL 4" | null,
+    estado_revision?: string | null,
+    ai_generated?: boolean,
+    created_at?: string,
+    indice_respuesta?: number,
+    justificacion?: string | null,
+    metadata?: object | null,
+    representacion_visual_enunciado?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_svg?: string | null,
+    imagen_alt?: string | null,
+
+},
+    imagenes?: ({
+    url?: string,
+    alt?: string | null,
+    orden?: number | null,
+
+})[],
+    opciones?: ({
+    indice_opcion?: number,
+    contenido_json?: object | null,
+    texto?: string,
+    es_correcta?: boolean,
+    explicacion?: string | null,
+    imagenes?: ({
+    url?: string,
+    alt?: string | null,
+    orden?: number | null,
+
+})[],
+
+})[],
+
+},
+    shared_context?: {
+    contexto?: string | null,
+    representacion_visual_id_estimulo?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_svg?: string | null,
+    imagen_alt?: string | null,
+
+},
+    group_info?: {
+    total_questions?: number,
+    current_question_index?: number,
+    is_first_question?: boolean,
+
+},
+    related_questions?: ({
+  /** @format uuid *\/
+    id_item?: string,
+    nombre_pregunta?: string,
+    order_in_group?: number,
+    is_current?: boolean,
+
+})[],
+
+},
+
+},
 
 }` Detalle de la pregunta con opciones
 */
@@ -1109,8 +1289,74 @@ export namespace V1 {
     export type RequestBody = never;
     export type RequestHeaders = {};
     export type ResponseBody = {
+      /** @example true */
       ok?: boolean;
-      data?: object;
+      data?: {
+        question?: {
+          /** @format uuid */
+          id_item?: string;
+          id_clasificacion?: string;
+          nombre_pregunta?: string | null;
+          enunciado?: string;
+          dificultad?: "NIVEL 1" | "NIVEL 2" | "NIVEL 3" | "NIVEL 4" | null;
+          estado_revision?: string | null;
+          ai_generated?: boolean;
+          created_at?: string;
+          indice_respuesta?: number;
+          justificacion?: string | null;
+          metadata?: object | null;
+          representacion_visual_enunciado?: {
+            tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia";
+            version?: "v1";
+            tabla_markdown?: string | null;
+            grafica_json?: object | null;
+            imagen_url?: string | null;
+            imagen_svg?: string | null;
+            imagen_alt?: string | null;
+          };
+          imagenes?: {
+            url?: string;
+            alt?: string | null;
+            orden?: number | null;
+          }[];
+          opciones?: {
+            indice_opcion?: number;
+            contenido_json?: object | null;
+            texto?: string;
+            es_correcta?: boolean;
+            explicacion?: string | null;
+            imagenes?: {
+              url?: string;
+              alt?: string | null;
+              orden?: number | null;
+            }[];
+          }[];
+        };
+        shared_context?: {
+          contexto?: string | null;
+          representacion_visual_id_estimulo?: {
+            tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia";
+            version?: "v1";
+            tabla_markdown?: string | null;
+            grafica_json?: object | null;
+            imagen_url?: string | null;
+            imagen_svg?: string | null;
+            imagen_alt?: string | null;
+          };
+          group_info?: {
+            total_questions?: number;
+            current_question_index?: number;
+            is_first_question?: boolean;
+          };
+          related_questions?: {
+            /** @format uuid */
+            id_item?: string;
+            nombre_pregunta?: string;
+            order_in_group?: number;
+            is_current?: boolean;
+          }[];
+        };
+      };
     };
   }
 
@@ -1328,8 +1574,43 @@ export namespace V1 {
  * @request GET:/v1/trainer/preguntas
  * @secure
  * @response `200` `{
+  /** @example true *\/
     ok?: boolean,
-    data?: (object)[],
+    data?: ({
+  /** @format uuid *\/
+    id_item?: string,
+    enunciado?: string,
+    indice_respuesta?: number,
+    id_clasificacion?: string,
+    id_estimulo?: string | null,
+    metadata?: object | null,
+    ai_generated?: boolean,
+    justificacion?: string | null,
+    created_at?: string,
+    imagenes?: ({
+    id_item?: string,
+    url?: string,
+    alt?: string | null,
+    orden?: number | null,
+
+})[],
+    opciones?: ({
+    id_item?: string,
+    indice_opcion?: number,
+    contenido_json?: object | null,
+    es_correcta?: boolean,
+    imagenes?: ({
+    id_item?: string,
+    indice_opcion?: number,
+    url?: string,
+    alt?: string | null,
+    orden?: number | null,
+
+})[],
+
+})[],
+
+})[],
 
 }` Lista de preguntas agrupadas por clasificación
 */
@@ -1342,8 +1623,39 @@ export namespace V1 {
     export type RequestBody = never;
     export type RequestHeaders = {};
     export type ResponseBody = {
+      /** @example true */
       ok?: boolean;
-      data?: object[];
+      data?: {
+        /** @format uuid */
+        id_item?: string;
+        enunciado?: string;
+        indice_respuesta?: number;
+        id_clasificacion?: string;
+        id_estimulo?: string | null;
+        metadata?: object | null;
+        ai_generated?: boolean;
+        justificacion?: string | null;
+        created_at?: string;
+        imagenes?: {
+          id_item?: string;
+          url?: string;
+          alt?: string | null;
+          orden?: number | null;
+        }[];
+        opciones?: {
+          id_item?: string;
+          indice_opcion?: number;
+          contenido_json?: object | null;
+          es_correcta?: boolean;
+          imagenes?: {
+            id_item?: string;
+            indice_opcion?: number;
+            url?: string;
+            alt?: string | null;
+            orden?: number | null;
+          }[];
+        }[];
+      }[];
     };
   }
 
@@ -2569,7 +2881,7 @@ export namespace V1 {
    * Texto completo del contexto/estímulo asociado al grupo de preguntas. Puede ser un párrafo de lectura, un enunciado de situación, un texto en inglés, etc. Es null cuando las preguntas no tienen contexto compartido.
    * @example "En una bodega, un trabajador observa un carro de carga sobre el piso. Sobre el carro actúan tres fuerzas en dirección horizontal..."
    *\/
-    id_estimulo?: string | null,
+    contexto?: string | null,
   /** Representación visual del contexto. Presente cuando el contexto tiene una imagen, gráfica o tabla asociada. null si el contexto es solo texto. *\/
     representacion_visual_id_estimulo?: {
   /**
@@ -2582,6 +2894,11 @@ export namespace V1 {
    * @example "v1"
    *\/
     version?: string,
+  /**
+   * URL pública de la imagen cuando existe asset persistido
+   * @example "https://example.supabase.co/storage/v1/object/public/preguntas/img.png"
+   *\/
+    imagen_url?: string | null,
   /**
    * Texto alternativo descriptivo de la imagen
    * @example "Un carro representado como un rectángulo. Dos flechas hacia la derecha etiquetadas 25 N y 10 N. Una flecha hacia la izquierda etiquetada 50 N."
@@ -2695,6 +3012,17 @@ export namespace V1 {
   /** Representación visual del enunciado de la pregunta (misma estructura que representacion_visual_id_estimulo) *\/
     representacion_visual_enunciado?: object | null,
 
+},
+  /** Representación visual del enunciado de la pregunta, ya extraída al nivel superior. *\/
+    representacion_visual_enunciado?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_svg?: string | null,
+    imagen_alt?: string | null,
+
 },
   /** Imágenes directas de la pregunta. Array vacío si no tiene imágenes. *\/
     imagenes?: ({
@@ -2722,6 +3050,11 @@ export namespace V1 {
     texto?: string,
 
 },
+  /**
+   * Texto plano extraído desde contenido_json.texto
+   * @example "la fuerza de la cuerda por sí sola es capaz de mover el carro hacia la izquierda, sin considerar las demás fuerzas."
+   *\/
+    texto?: string,
   /** Imágenes de la opción. Array vacío si la opción no tiene imágenes. *\/
     imagenes?: ({
     url?: string,
@@ -2766,7 +3099,7 @@ export namespace V1 {
          * Texto completo del contexto/estímulo asociado al grupo de preguntas. Puede ser un párrafo de lectura, un enunciado de situación, un texto en inglés, etc. Es null cuando las preguntas no tienen contexto compartido.
          * @example "En una bodega, un trabajador observa un carro de carga sobre el piso. Sobre el carro actúan tres fuerzas en dirección horizontal..."
          */
-        id_estimulo?: string | null;
+        contexto?: string | null;
         /** Representación visual del contexto. Presente cuando el contexto tiene una imagen, gráfica o tabla asociada. null si el contexto es solo texto. */
         representacion_visual_id_estimulo?: {
           /**
@@ -2779,6 +3112,11 @@ export namespace V1 {
            * @example "v1"
            */
           version?: string;
+          /**
+           * URL pública de la imagen cuando existe asset persistido
+           * @example "https://example.supabase.co/storage/v1/object/public/preguntas/img.png"
+           */
+          imagen_url?: string | null;
           /**
            * Texto alternativo descriptivo de la imagen
            * @example "Un carro representado como un rectángulo. Dos flechas hacia la derecha etiquetadas 25 N y 10 N. Una flecha hacia la izquierda etiquetada 50 N."
@@ -2886,6 +3224,16 @@ export namespace V1 {
             /** Representación visual del enunciado de la pregunta (misma estructura que representacion_visual_id_estimulo) */
             representacion_visual_enunciado?: object | null;
           };
+          /** Representación visual del enunciado de la pregunta, ya extraída al nivel superior. */
+          representacion_visual_enunciado?: {
+            tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia";
+            version?: "v1";
+            tabla_markdown?: string | null;
+            grafica_json?: object | null;
+            imagen_url?: string | null;
+            imagen_svg?: string | null;
+            imagen_alt?: string | null;
+          };
           /** Imágenes directas de la pregunta. Array vacío si no tiene imágenes. */
           imagenes?: {
             /** URL de la imagen */
@@ -2910,6 +3258,11 @@ export namespace V1 {
                */
               texto?: string;
             };
+            /**
+             * Texto plano extraído desde contenido_json.texto
+             * @example "la fuerza de la cuerda por sí sola es capaz de mover el carro hacia la izquierda, sin considerar las demás fuerzas."
+             */
+            texto?: string;
             /** Imágenes de la opción. Array vacío si la opción no tiene imágenes. */
             imagenes?: {
               url?: string;
@@ -3640,14 +3993,21 @@ export namespace V1 {
     export type RequestQuery = {
       /**
        * Página (default 1)
+       * @min 1
+       * @default 1
        * @example 1
        */
       page?: number;
       /**
        * Resultados por página (default 50)
+       * @min 1
+       * @max 100
+       * @default 50
        * @example 50
        */
       perPage?: number;
+      /** Orden primario del leaderboard (default score) */
+      sortBy?: "score" | "xp";
     };
     export type RequestBody = never;
     export type RequestHeaders = {};
@@ -4050,9 +4410,18 @@ export namespace V1 {
     estado?: string,
   /** Preguntas agrupadas por contexto/estímulo *\/
     grupos?: ({
-    id_estimulo?: string | null,
-  /** Representación visual del contexto. Misma estructura que en diagnóstico/start (tipo, version, descripcion, tabla_markdown, grafica_json, imagen_alt, imagen_svg). *\/
-    representacion_visual_id_estimulo?: object | null,
+    contexto?: string | null,
+  /** Representación visual del contexto. Misma estructura actual que diagnóstico/start. *\/
+    representacion_visual_id_estimulo?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_svg?: string | null,
+    imagen_alt?: string | null,
+
+},
     items?: ({
   /** @format uuid *\/
     id_item?: string,
@@ -4061,6 +4430,16 @@ export namespace V1 {
     id_materia?: string | null,
     materia_nombre?: string | null,
     metadata?: object | null,
+    representacion_visual_enunciado?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_svg?: string | null,
+    imagen_alt?: string | null,
+
+},
     imagenes?: ({
     url?: string,
     alt?: string,
@@ -4074,6 +4453,7 @@ export namespace V1 {
     texto?: string,
 
 },
+    texto?: string,
     imagenes?: ({
     url?: string,
     alt?: string,
@@ -4114,9 +4494,17 @@ export namespace V1 {
         estado?: string;
         /** Preguntas agrupadas por contexto/estímulo */
         grupos?: {
-          id_estimulo?: string | null;
-          /** Representación visual del contexto. Misma estructura que en diagnóstico/start (tipo, version, descripcion, tabla_markdown, grafica_json, imagen_alt, imagen_svg). */
-          representacion_visual_id_estimulo?: object | null;
+          contexto?: string | null;
+          /** Representación visual del contexto. Misma estructura actual que diagnóstico/start. */
+          representacion_visual_id_estimulo?: {
+            tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia";
+            version?: "v1";
+            tabla_markdown?: string | null;
+            grafica_json?: object | null;
+            imagen_url?: string | null;
+            imagen_svg?: string | null;
+            imagen_alt?: string | null;
+          };
           items?: {
             /** @format uuid */
             id_item?: string;
@@ -4125,6 +4513,20 @@ export namespace V1 {
             id_materia?: string | null;
             materia_nombre?: string | null;
             metadata?: object | null;
+            representacion_visual_enunciado?: {
+              tipo?:
+                | "tabla"
+                | "grafica"
+                | "imagen"
+                | "caricatura"
+                | "infografia";
+              version?: "v1";
+              tabla_markdown?: string | null;
+              grafica_json?: object | null;
+              imagen_url?: string | null;
+              imagen_svg?: string | null;
+              imagen_alt?: string | null;
+            };
             imagenes?: {
               url?: string;
               alt?: string;
@@ -4136,6 +4538,7 @@ export namespace V1 {
               contenido_json?: {
                 texto?: string;
               };
+              texto?: string;
               imagenes?: {
                 url?: string;
                 alt?: string;
@@ -4162,7 +4565,7 @@ export namespace V1 {
     clasificacion?: object,
   /** Preguntas agrupadas por contexto con respuestas reveladas *\/
     grupos?: ({
-    id_estimulo?: string | null,
+    contexto?: string | null,
   /** Representación visual del contexto. Misma estructura que en diagnóstico/start. *\/
     representacion_visual_id_estimulo?: object | null,
     items?: ({
@@ -4174,6 +4577,8 @@ export namespace V1 {
     id_materia?: string,
     materia_nombre?: string,
     metadata?: object | null,
+  /** Representación visual del enunciado si aplica. *\/
+    representacion_visual_enunciado?: object | null,
   /** true si es Comunicación Escrita *\/
     isOpenTextQuestion?: boolean,
     imagenes?: ({
@@ -4245,7 +4650,7 @@ export namespace V1 {
         clasificacion?: object;
         /** Preguntas agrupadas por contexto con respuestas reveladas */
         grupos?: {
-          id_estimulo?: string | null;
+          contexto?: string | null;
           /** Representación visual del contexto. Misma estructura que en diagnóstico/start. */
           representacion_visual_id_estimulo?: object | null;
           items?: {
@@ -4257,6 +4662,8 @@ export namespace V1 {
             id_materia?: string;
             materia_nombre?: string;
             metadata?: object | null;
+            /** Representación visual del enunciado si aplica. */
+            representacion_visual_enunciado?: object | null;
             /** true si es Comunicación Escrita */
             isOpenTextQuestion?: boolean;
             imagenes?: {
@@ -4580,8 +4987,50 @@ export namespace V1 {
  * @request GET:/v1/exams/practice/{materiaId}
  * @secure
  * @response `200` `{
+  /** @example true *\/
     ok?: boolean,
-    data?: object,
+    data?: {
+    materia?: {
+    id_materia?: string,
+    nombre?: string,
+    institution_type?: string | null,
+
+},
+    preguntas?: ({
+  /** @format uuid *\/
+    id_item?: string,
+    enunciado?: string,
+    indice_respuesta?: number,
+    id_clasificacion?: string,
+    id_estimulo?: string | null,
+    metadata?: object | null,
+    ai_generated?: boolean,
+    imagenes?: ({
+    id_item?: string,
+    url?: string,
+    alt?: string | null,
+    orden?: number | null,
+
+})[],
+    opciones?: ({
+    id_item?: string,
+    indice_opcion?: number,
+    contenido_json?: object | null,
+    es_correcta?: boolean,
+    imagenes?: ({
+    id_item?: string,
+    indice_opcion?: number,
+    url?: string,
+    alt?: string | null,
+    orden?: number | null,
+
+})[],
+
+})[],
+
+})[],
+
+},
 
 }` Preguntas de práctica para la materia
 */
@@ -4597,8 +5046,44 @@ export namespace V1 {
     export type RequestBody = never;
     export type RequestHeaders = {};
     export type ResponseBody = {
+      /** @example true */
       ok?: boolean;
-      data?: object;
+      data?: {
+        materia?: {
+          id_materia?: string;
+          nombre?: string;
+          institution_type?: string | null;
+        };
+        preguntas?: {
+          /** @format uuid */
+          id_item?: string;
+          enunciado?: string;
+          indice_respuesta?: number;
+          id_clasificacion?: string;
+          id_estimulo?: string | null;
+          metadata?: object | null;
+          ai_generated?: boolean;
+          imagenes?: {
+            id_item?: string;
+            url?: string;
+            alt?: string | null;
+            orden?: number | null;
+          }[];
+          opciones?: {
+            id_item?: string;
+            indice_opcion?: number;
+            contenido_json?: object | null;
+            es_correcta?: boolean;
+            imagenes?: {
+              id_item?: string;
+              indice_opcion?: number;
+              url?: string;
+              alt?: string | null;
+              orden?: number | null;
+            }[];
+          }[];
+        }[];
+      };
     };
   }
 
@@ -4610,8 +5095,44 @@ export namespace V1 {
  * @request GET:/v1/exams/practice/theme/{tematicaId}
  * @secure
  * @response `200` `{
+  /** @example true *\/
     ok?: boolean,
-    data?: object,
+    data?: {
+    materia?: {
+    id_materia?: string,
+    nombre?: string,
+    institution_type?: string | null,
+
+},
+    tematica?: {
+    texto?: string,
+
+},
+    preguntas?: ({
+  /** @format uuid *\/
+    id_item?: string,
+    enunciado?: string,
+    indice_respuesta?: number,
+    id_clasificacion?: string,
+    id_estimulo?: string | null,
+    metadata?: object | null,
+    ai_generated?: boolean,
+  /** Registro del contexto asociado cuando existe coincidencia en contextos. *\/
+    estimulo?: object | null,
+  /** Primera imagen encontrada para la pregunta cuando aplica. *\/
+    imagen?: object | null,
+    opciones?: ({
+    id_item?: string,
+    indice_opcion?: number,
+    contenido_json?: object | null,
+    es_correcta?: boolean,
+    explicacion?: string | null,
+
+})[],
+
+})[],
+
+},
 
 }` Preguntas de práctica para la temática
 */
@@ -4629,8 +5150,39 @@ export namespace V1 {
     export type RequestBody = never;
     export type RequestHeaders = {};
     export type ResponseBody = {
+      /** @example true */
       ok?: boolean;
-      data?: object;
+      data?: {
+        materia?: {
+          id_materia?: string;
+          nombre?: string;
+          institution_type?: string | null;
+        };
+        tematica?: {
+          texto?: string;
+        };
+        preguntas?: {
+          /** @format uuid */
+          id_item?: string;
+          enunciado?: string;
+          indice_respuesta?: number;
+          id_clasificacion?: string;
+          id_estimulo?: string | null;
+          metadata?: object | null;
+          ai_generated?: boolean;
+          /** Registro del contexto asociado cuando existe coincidencia en contextos. */
+          estimulo?: object | null;
+          /** Primera imagen encontrada para la pregunta cuando aplica. */
+          imagen?: object | null;
+          opciones?: {
+            id_item?: string;
+            indice_opcion?: number;
+            contenido_json?: object | null;
+            es_correcta?: boolean;
+            explicacion?: string | null;
+          }[];
+        }[];
+      };
     };
   }
 
@@ -4822,41 +5374,15 @@ export namespace V1 {
   /** Preguntas agrupadas por contexto/estímulo *\/
     grupos?: ({
   /** Texto del contexto/estímulo compartido. null si no hay contexto. *\/
-    id_estimulo?: string | null,
-  /** Representación visual del contexto (imagen, gráfica o tabla). Misma estructura que en diagnóstico/start. null si es solo texto. *\/
+    contexto?: string | null,
+  /** Representación visual del contexto (imagen, gráfica o tabla). null si es solo texto. *\/
     representacion_visual_id_estimulo?: {
-    tipo?: "tabla" | "grafica" | "imagen",
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
     version?: "v1",
-    descripcion?: string,
     tabla_markdown?: string | null,
-  /** Estructura de gráfica. Ver diagnóstico/start para detalle completo. *\/
-    grafica_json?: {
-    chart_type?: "bar" | "line" | "scatter" | "area",
-    x?: {
-    label?: string,
-    unit?: string | null,
-    values?: ((string | number))[],
-
-},
-    y?: {
-    label?: string,
-    unit?: string | null,
-
-},
-    series?: ({
-    name?: string,
-    data?: (number)[],
-
-})[],
-    annotations?: ({
-    type?: "reference_line",
-    axis?: "x" | "y",
-    value?: (number | string),
-    label?: string,
-
-})[],
-
-},
+  /** Estructura de gráfica serializada. *\/
+    grafica_json?: object | null,
+    imagen_url?: string | null,
     imagen_alt?: string | null,
     imagen_svg?: string | null,
 
@@ -4867,6 +5393,16 @@ export namespace V1 {
     enunciado?: string,
     id_clasificacion?: string,
     metadata?: object | null,
+    representacion_visual_enunciado?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_alt?: string | null,
+    imagen_svg?: string | null,
+
+},
     imagenes?: ({
     url?: string,
     alt?: string,
@@ -4881,6 +5417,7 @@ export namespace V1 {
     texto?: string,
 
 },
+    texto?: string,
     imagenes?: ({
     url?: string,
     alt?: string,
@@ -4922,36 +5459,15 @@ export namespace V1 {
       /** Preguntas agrupadas por contexto/estímulo */
       grupos?: {
         /** Texto del contexto/estímulo compartido. null si no hay contexto. */
-        id_estimulo?: string | null;
-        /** Representación visual del contexto (imagen, gráfica o tabla). Misma estructura que en diagnóstico/start. null si es solo texto. */
+        contexto?: string | null;
+        /** Representación visual del contexto (imagen, gráfica o tabla). null si es solo texto. */
         representacion_visual_id_estimulo?: {
-          tipo?: "tabla" | "grafica" | "imagen";
+          tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia";
           version?: "v1";
-          descripcion?: string;
           tabla_markdown?: string | null;
-          /** Estructura de gráfica. Ver diagnóstico/start para detalle completo. */
-          grafica_json?: {
-            chart_type?: "bar" | "line" | "scatter" | "area";
-            x?: {
-              label?: string;
-              unit?: string | null;
-              values?: (string | number)[];
-            };
-            y?: {
-              label?: string;
-              unit?: string | null;
-            };
-            series?: {
-              name?: string;
-              data?: number[];
-            }[];
-            annotations?: {
-              type?: "reference_line";
-              axis?: "x" | "y";
-              value?: number | string;
-              label?: string;
-            }[];
-          };
+          /** Estructura de gráfica serializada. */
+          grafica_json?: object | null;
+          imagen_url?: string | null;
           imagen_alt?: string | null;
           imagen_svg?: string | null;
         };
@@ -4961,6 +5477,15 @@ export namespace V1 {
           enunciado?: string;
           id_clasificacion?: string;
           metadata?: object | null;
+          representacion_visual_enunciado?: {
+            tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia";
+            version?: "v1";
+            tabla_markdown?: string | null;
+            grafica_json?: object | null;
+            imagen_url?: string | null;
+            imagen_alt?: string | null;
+            imagen_svg?: string | null;
+          };
           imagenes?: {
             url?: string;
             alt?: string;
@@ -4973,6 +5498,7 @@ export namespace V1 {
             contenido_json?: {
               texto?: string;
             };
+            texto?: string;
             imagenes?: {
               url?: string;
               alt?: string;
@@ -5168,7 +5694,7 @@ export namespace V1 {
 },
   /** Preguntas agrupadas por contexto con respuestas correctas reveladas *\/
     grupos?: ({
-    id_estimulo?: string | null,
+    contexto?: string | null,
   /** Misma estructura que en missions/start *\/
     representacion_visual_id_estimulo?: object | null,
     items?: ({
@@ -5179,6 +5705,8 @@ export namespace V1 {
     indice_respuesta?: number,
     id_clasificacion?: string,
     metadata?: object | null,
+  /** Representación visual del enunciado si aplica. *\/
+    representacion_visual_enunciado?: object | null,
     imagenes?: ({
     url?: string,
     alt?: string,
@@ -5192,6 +5720,7 @@ export namespace V1 {
     texto?: string,
 
 },
+    texto?: string,
     es_correcta?: boolean,
     explicacion?: string | null,
     imagenes?: ({
@@ -5249,7 +5778,7 @@ export namespace V1 {
       };
       /** Preguntas agrupadas por contexto con respuestas correctas reveladas */
       grupos?: {
-        id_estimulo?: string | null;
+        contexto?: string | null;
         /** Misma estructura que en missions/start */
         representacion_visual_id_estimulo?: object | null;
         items?: {
@@ -5260,6 +5789,8 @@ export namespace V1 {
           indice_respuesta?: number;
           id_clasificacion?: string;
           metadata?: object | null;
+          /** Representación visual del enunciado si aplica. */
+          representacion_visual_enunciado?: object | null;
           imagenes?: {
             url?: string;
             alt?: string;
@@ -5271,6 +5802,7 @@ export namespace V1 {
             contenido_json?: {
               texto?: string;
             };
+            texto?: string;
             es_correcta?: boolean;
             explicacion?: string | null;
             imagenes?: {
@@ -6240,9 +6772,18 @@ export namespace V1 {
     status?: string,
   /** Preguntas agrupadas por contexto/estímulo *\/
     grupos?: ({
-    id_estimulo?: string | null,
-  /** Representación visual del contexto. Misma estructura que en diagnóstico/start (tipo, version, descripcion, tabla_markdown, grafica_json, imagen_alt, imagen_svg). *\/
-    representacion_visual_id_estimulo?: object | null,
+    contexto?: string | null,
+  /** Representación visual del contexto. Misma estructura que en diagnóstico/start actual (tipo, version, tabla_markdown, grafica_json, imagen_url, imagen_svg, imagen_alt). *\/
+    representacion_visual_id_estimulo?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_svg?: string | null,
+    imagen_alt?: string | null,
+
+},
     items?: ({
   /** @format uuid *\/
     id_item?: string,
@@ -6252,6 +6793,16 @@ export namespace V1 {
     materia_nombre?: string | null,
     metadata?: object | null,
     ai_generated?: boolean,
+    representacion_visual_enunciado?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_svg?: string | null,
+    imagen_alt?: string | null,
+
+},
     imagenes?: (object)[],
   /** Opciones sin es_correcta ni explicacion. Incluye id_item del parent. *\/
     opciones?: ({
@@ -6262,6 +6813,7 @@ export namespace V1 {
     texto?: string,
 
 },
+    texto?: string,
     imagenes?: (object)[],
 
 })[],
@@ -6307,9 +6859,17 @@ export namespace V1 {
       status?: string;
       /** Preguntas agrupadas por contexto/estímulo */
       grupos?: {
-        id_estimulo?: string | null;
-        /** Representación visual del contexto. Misma estructura que en diagnóstico/start (tipo, version, descripcion, tabla_markdown, grafica_json, imagen_alt, imagen_svg). */
-        representacion_visual_id_estimulo?: object | null;
+        contexto?: string | null;
+        /** Representación visual del contexto. Misma estructura que en diagnóstico/start actual (tipo, version, tabla_markdown, grafica_json, imagen_url, imagen_svg, imagen_alt). */
+        representacion_visual_id_estimulo?: {
+          tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia";
+          version?: "v1";
+          tabla_markdown?: string | null;
+          grafica_json?: object | null;
+          imagen_url?: string | null;
+          imagen_svg?: string | null;
+          imagen_alt?: string | null;
+        };
         items?: {
           /** @format uuid */
           id_item?: string;
@@ -6319,6 +6879,15 @@ export namespace V1 {
           materia_nombre?: string | null;
           metadata?: object | null;
           ai_generated?: boolean;
+          representacion_visual_enunciado?: {
+            tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia";
+            version?: "v1";
+            tabla_markdown?: string | null;
+            grafica_json?: object | null;
+            imagen_url?: string | null;
+            imagen_svg?: string | null;
+            imagen_alt?: string | null;
+          };
           imagenes?: object[];
           /** Opciones sin es_correcta ni explicacion. Incluye id_item del parent. */
           opciones?: {
@@ -6328,6 +6897,7 @@ export namespace V1 {
             contenido_json?: {
               texto?: string;
             };
+            texto?: string;
             imagenes?: object[];
           }[];
         }[];
@@ -6922,24 +7492,124 @@ export class Api<
       }),
 
     /**
-     * No description
-     *
-     * @tags trainer
-     * @name GetQuestionsByClasificacion
-     * @summary Obtener preguntas AI generadas por clasificación (agrupadas por contexto)
-     * @request GET:/v1/trainer/questions
-     * @response `200` `void` Questions retrieved successfully, grouped by context
-     */
+ * No description
+ *
+ * @tags trainer
+ * @name GetQuestionsByClasificacion
+ * @summary Obtener preguntas AI generadas por clasificación (agrupadas por contexto)
+ * @request GET:/v1/trainer/questions
+ * @response `200` `{
+    modelo_llm?: string,
+    grupos?: ({
+    contexto?: string | null,
+    representacion_visual_id_estimulo?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_svg?: string | null,
+    imagen_alt?: string | null,
+
+},
+    items?: ({
+  /** @format uuid *\/
+    id_item?: string,
+    ai_generated?: boolean,
+    enunciado?: string,
+    opciones?: ({
+    indice_opcion?: number,
+    contenido_json?: object | null,
+    texto?: string,
+    es_correcta?: boolean,
+    explicacion?: string | null,
+
+})[],
+    indice_respuesta?: number,
+    justificacion?: string | null,
+    dificultad?: "NIVEL 1" | "NIVEL 2" | "NIVEL 3" | "NIVEL 4" | null,
+    representacion_visual_enunciado?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_svg?: string | null,
+    imagen_alt?: string | null,
+
+},
+    id_clasificacion?: string,
+
+})[],
+
+})[],
+
+}` Questions retrieved successfully, grouped by context
+ */
     getQuestionsByClasificacion: (
       query: {
         id_clasificacion: string;
       },
       params: RequestParams = {},
     ) =>
-      this.request<void, any>({
+      this.request<
+        {
+          modelo_llm?: string;
+          grupos?: {
+            contexto?: string | null;
+            representacion_visual_id_estimulo?: {
+              tipo?:
+                | "tabla"
+                | "grafica"
+                | "imagen"
+                | "caricatura"
+                | "infografia";
+              version?: "v1";
+              tabla_markdown?: string | null;
+              grafica_json?: object | null;
+              imagen_url?: string | null;
+              imagen_svg?: string | null;
+              imagen_alt?: string | null;
+            };
+            items?: {
+              /** @format uuid */
+              id_item?: string;
+              ai_generated?: boolean;
+              enunciado?: string;
+              opciones?: {
+                indice_opcion?: number;
+                contenido_json?: object | null;
+                texto?: string;
+                es_correcta?: boolean;
+                explicacion?: string | null;
+              }[];
+              indice_respuesta?: number;
+              justificacion?: string | null;
+              dificultad?: "NIVEL 1" | "NIVEL 2" | "NIVEL 3" | "NIVEL 4" | null;
+              representacion_visual_enunciado?: {
+                tipo?:
+                  | "tabla"
+                  | "grafica"
+                  | "imagen"
+                  | "caricatura"
+                  | "infografia";
+                version?: "v1";
+                tabla_markdown?: string | null;
+                grafica_json?: object | null;
+                imagen_url?: string | null;
+                imagen_svg?: string | null;
+                imagen_alt?: string | null;
+              };
+              id_clasificacion?: string;
+            }[];
+          }[];
+        },
+        any
+      >({
         path: `/v1/trainer/questions`,
         method: "GET",
         query: query,
+        format: "json",
         ...params,
       }),
 
@@ -6951,16 +7621,168 @@ export class Api<
  * @summary Obtener detalle de una pregunta por ID (id_item)
  * @request GET:/v1/trainer/questions/{id}
  * @response `200` `{
+  /** @example true *\/
     ok?: boolean,
-    data?: object,
+    data?: {
+    question?: {
+  /** @format uuid *\/
+    id_item?: string,
+    id_clasificacion?: string,
+    nombre_pregunta?: string | null,
+    enunciado?: string,
+    dificultad?: "NIVEL 1" | "NIVEL 2" | "NIVEL 3" | "NIVEL 4" | null,
+    estado_revision?: string | null,
+    ai_generated?: boolean,
+    created_at?: string,
+    indice_respuesta?: number,
+    justificacion?: string | null,
+    metadata?: object | null,
+    representacion_visual_enunciado?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_svg?: string | null,
+    imagen_alt?: string | null,
+
+},
+    imagenes?: ({
+    url?: string,
+    alt?: string | null,
+    orden?: number | null,
+
+})[],
+    opciones?: ({
+    indice_opcion?: number,
+    contenido_json?: object | null,
+    texto?: string,
+    es_correcta?: boolean,
+    explicacion?: string | null,
+    imagenes?: ({
+    url?: string,
+    alt?: string | null,
+    orden?: number | null,
+
+})[],
+
+})[],
+
+},
+    shared_context?: {
+    contexto?: string | null,
+    representacion_visual_id_estimulo?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_svg?: string | null,
+    imagen_alt?: string | null,
+
+},
+    group_info?: {
+    total_questions?: number,
+    current_question_index?: number,
+    is_first_question?: boolean,
+
+},
+    related_questions?: ({
+  /** @format uuid *\/
+    id_item?: string,
+    nombre_pregunta?: string,
+    order_in_group?: number,
+    is_current?: boolean,
+
+})[],
+
+},
+
+},
 
 }` Detalle de la pregunta con opciones
  */
     getQuestionById: (id: string, params: RequestParams = {}) =>
       this.request<
         {
+          /** @example true */
           ok?: boolean;
-          data?: object;
+          data?: {
+            question?: {
+              /** @format uuid */
+              id_item?: string;
+              id_clasificacion?: string;
+              nombre_pregunta?: string | null;
+              enunciado?: string;
+              dificultad?: "NIVEL 1" | "NIVEL 2" | "NIVEL 3" | "NIVEL 4" | null;
+              estado_revision?: string | null;
+              ai_generated?: boolean;
+              created_at?: string;
+              indice_respuesta?: number;
+              justificacion?: string | null;
+              metadata?: object | null;
+              representacion_visual_enunciado?: {
+                tipo?:
+                  | "tabla"
+                  | "grafica"
+                  | "imagen"
+                  | "caricatura"
+                  | "infografia";
+                version?: "v1";
+                tabla_markdown?: string | null;
+                grafica_json?: object | null;
+                imagen_url?: string | null;
+                imagen_svg?: string | null;
+                imagen_alt?: string | null;
+              };
+              imagenes?: {
+                url?: string;
+                alt?: string | null;
+                orden?: number | null;
+              }[];
+              opciones?: {
+                indice_opcion?: number;
+                contenido_json?: object | null;
+                texto?: string;
+                es_correcta?: boolean;
+                explicacion?: string | null;
+                imagenes?: {
+                  url?: string;
+                  alt?: string | null;
+                  orden?: number | null;
+                }[];
+              }[];
+            };
+            shared_context?: {
+              contexto?: string | null;
+              representacion_visual_id_estimulo?: {
+                tipo?:
+                  | "tabla"
+                  | "grafica"
+                  | "imagen"
+                  | "caricatura"
+                  | "infografia";
+                version?: "v1";
+                tabla_markdown?: string | null;
+                grafica_json?: object | null;
+                imagen_url?: string | null;
+                imagen_svg?: string | null;
+                imagen_alt?: string | null;
+              };
+              group_info?: {
+                total_questions?: number;
+                current_question_index?: number;
+                is_first_question?: boolean;
+              };
+              related_questions?: {
+                /** @format uuid */
+                id_item?: string;
+                nombre_pregunta?: string;
+                order_in_group?: number;
+                is_current?: boolean;
+              }[];
+            };
+          };
         },
         any
       >({
@@ -7231,8 +8053,43 @@ export class Api<
  * @request GET:/v1/trainer/preguntas
  * @secure
  * @response `200` `{
+  /** @example true *\/
     ok?: boolean,
-    data?: (object)[],
+    data?: ({
+  /** @format uuid *\/
+    id_item?: string,
+    enunciado?: string,
+    indice_respuesta?: number,
+    id_clasificacion?: string,
+    id_estimulo?: string | null,
+    metadata?: object | null,
+    ai_generated?: boolean,
+    justificacion?: string | null,
+    created_at?: string,
+    imagenes?: ({
+    id_item?: string,
+    url?: string,
+    alt?: string | null,
+    orden?: number | null,
+
+})[],
+    opciones?: ({
+    id_item?: string,
+    indice_opcion?: number,
+    contenido_json?: object | null,
+    es_correcta?: boolean,
+    imagenes?: ({
+    id_item?: string,
+    indice_opcion?: number,
+    url?: string,
+    alt?: string | null,
+    orden?: number | null,
+
+})[],
+
+})[],
+
+})[],
 
 }` Lista de preguntas agrupadas por clasificación
  */
@@ -7245,8 +8102,39 @@ export class Api<
     ) =>
       this.request<
         {
+          /** @example true */
           ok?: boolean;
-          data?: object[];
+          data?: {
+            /** @format uuid */
+            id_item?: string;
+            enunciado?: string;
+            indice_respuesta?: number;
+            id_clasificacion?: string;
+            id_estimulo?: string | null;
+            metadata?: object | null;
+            ai_generated?: boolean;
+            justificacion?: string | null;
+            created_at?: string;
+            imagenes?: {
+              id_item?: string;
+              url?: string;
+              alt?: string | null;
+              orden?: number | null;
+            }[];
+            opciones?: {
+              id_item?: string;
+              indice_opcion?: number;
+              contenido_json?: object | null;
+              es_correcta?: boolean;
+              imagenes?: {
+                id_item?: string;
+                indice_opcion?: number;
+                url?: string;
+                alt?: string | null;
+                orden?: number | null;
+              }[];
+            }[];
+          }[];
         },
         any
       >({
@@ -8565,7 +9453,7 @@ export class Api<
    * Texto completo del contexto/estímulo asociado al grupo de preguntas. Puede ser un párrafo de lectura, un enunciado de situación, un texto en inglés, etc. Es null cuando las preguntas no tienen contexto compartido.
    * @example "En una bodega, un trabajador observa un carro de carga sobre el piso. Sobre el carro actúan tres fuerzas en dirección horizontal..."
    *\/
-    id_estimulo?: string | null,
+    contexto?: string | null,
   /** Representación visual del contexto. Presente cuando el contexto tiene una imagen, gráfica o tabla asociada. null si el contexto es solo texto. *\/
     representacion_visual_id_estimulo?: {
   /**
@@ -8578,6 +9466,11 @@ export class Api<
    * @example "v1"
    *\/
     version?: string,
+  /**
+   * URL pública de la imagen cuando existe asset persistido
+   * @example "https://example.supabase.co/storage/v1/object/public/preguntas/img.png"
+   *\/
+    imagen_url?: string | null,
   /**
    * Texto alternativo descriptivo de la imagen
    * @example "Un carro representado como un rectángulo. Dos flechas hacia la derecha etiquetadas 25 N y 10 N. Una flecha hacia la izquierda etiquetada 50 N."
@@ -8691,6 +9584,17 @@ export class Api<
   /** Representación visual del enunciado de la pregunta (misma estructura que representacion_visual_id_estimulo) *\/
     representacion_visual_enunciado?: object | null,
 
+},
+  /** Representación visual del enunciado de la pregunta, ya extraída al nivel superior. *\/
+    representacion_visual_enunciado?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_svg?: string | null,
+    imagen_alt?: string | null,
+
 },
   /** Imágenes directas de la pregunta. Array vacío si no tiene imágenes. *\/
     imagenes?: ({
@@ -8718,6 +9622,11 @@ export class Api<
     texto?: string,
 
 },
+  /**
+   * Texto plano extraído desde contenido_json.texto
+   * @example "la fuerza de la cuerda por sí sola es capaz de mover el carro hacia la izquierda, sin considerar las demás fuerzas."
+   *\/
+    texto?: string,
   /** Imágenes de la opción. Array vacío si la opción no tiene imágenes. *\/
     imagenes?: ({
     url?: string,
@@ -8759,7 +9668,7 @@ export class Api<
              * Texto completo del contexto/estímulo asociado al grupo de preguntas. Puede ser un párrafo de lectura, un enunciado de situación, un texto en inglés, etc. Es null cuando las preguntas no tienen contexto compartido.
              * @example "En una bodega, un trabajador observa un carro de carga sobre el piso. Sobre el carro actúan tres fuerzas en dirección horizontal..."
              */
-            id_estimulo?: string | null;
+            contexto?: string | null;
             /** Representación visual del contexto. Presente cuando el contexto tiene una imagen, gráfica o tabla asociada. null si el contexto es solo texto. */
             representacion_visual_id_estimulo?: {
               /**
@@ -8772,6 +9681,11 @@ export class Api<
                * @example "v1"
                */
               version?: string;
+              /**
+               * URL pública de la imagen cuando existe asset persistido
+               * @example "https://example.supabase.co/storage/v1/object/public/preguntas/img.png"
+               */
+              imagen_url?: string | null;
               /**
                * Texto alternativo descriptivo de la imagen
                * @example "Un carro representado como un rectángulo. Dos flechas hacia la derecha etiquetadas 25 N y 10 N. Una flecha hacia la izquierda etiquetada 50 N."
@@ -8879,6 +9793,21 @@ export class Api<
                 /** Representación visual del enunciado de la pregunta (misma estructura que representacion_visual_id_estimulo) */
                 representacion_visual_enunciado?: object | null;
               };
+              /** Representación visual del enunciado de la pregunta, ya extraída al nivel superior. */
+              representacion_visual_enunciado?: {
+                tipo?:
+                  | "tabla"
+                  | "grafica"
+                  | "imagen"
+                  | "caricatura"
+                  | "infografia";
+                version?: "v1";
+                tabla_markdown?: string | null;
+                grafica_json?: object | null;
+                imagen_url?: string | null;
+                imagen_svg?: string | null;
+                imagen_alt?: string | null;
+              };
               /** Imágenes directas de la pregunta. Array vacío si no tiene imágenes. */
               imagenes?: {
                 /** URL de la imagen */
@@ -8903,6 +9832,11 @@ export class Api<
                    */
                   texto?: string;
                 };
+                /**
+                 * Texto plano extraído desde contenido_json.texto
+                 * @example "la fuerza de la cuerda por sí sola es capaz de mover el carro hacia la izquierda, sin considerar las demás fuerzas."
+                 */
+                texto?: string;
                 /** Imágenes de la opción. Array vacío si la opción no tiene imágenes. */
                 imagenes?: {
                   url?: string;
@@ -9716,14 +10650,21 @@ export class Api<
       query?: {
         /**
          * Página (default 1)
+         * @min 1
+         * @default 1
          * @example 1
          */
         page?: number;
         /**
          * Resultados por página (default 50)
+         * @min 1
+         * @max 100
+         * @default 50
          * @example 50
          */
         perPage?: number;
+        /** Orden primario del leaderboard (default score) */
+        sortBy?: "score" | "xp";
       },
       params: RequestParams = {},
     ) =>
@@ -10161,9 +11102,18 @@ export class Api<
     estado?: string,
   /** Preguntas agrupadas por contexto/estímulo *\/
     grupos?: ({
-    id_estimulo?: string | null,
-  /** Representación visual del contexto. Misma estructura que en diagnóstico/start (tipo, version, descripcion, tabla_markdown, grafica_json, imagen_alt, imagen_svg). *\/
-    representacion_visual_id_estimulo?: object | null,
+    contexto?: string | null,
+  /** Representación visual del contexto. Misma estructura actual que diagnóstico/start. *\/
+    representacion_visual_id_estimulo?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_svg?: string | null,
+    imagen_alt?: string | null,
+
+},
     items?: ({
   /** @format uuid *\/
     id_item?: string,
@@ -10172,6 +11122,16 @@ export class Api<
     id_materia?: string | null,
     materia_nombre?: string | null,
     metadata?: object | null,
+    representacion_visual_enunciado?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_svg?: string | null,
+    imagen_alt?: string | null,
+
+},
     imagenes?: ({
     url?: string,
     alt?: string,
@@ -10185,6 +11145,7 @@ export class Api<
     texto?: string,
 
 },
+    texto?: string,
     imagenes?: ({
     url?: string,
     alt?: string,
@@ -10216,9 +11177,22 @@ export class Api<
             estado?: string;
             /** Preguntas agrupadas por contexto/estímulo */
             grupos?: {
-              id_estimulo?: string | null;
-              /** Representación visual del contexto. Misma estructura que en diagnóstico/start (tipo, version, descripcion, tabla_markdown, grafica_json, imagen_alt, imagen_svg). */
-              representacion_visual_id_estimulo?: object | null;
+              contexto?: string | null;
+              /** Representación visual del contexto. Misma estructura actual que diagnóstico/start. */
+              representacion_visual_id_estimulo?: {
+                tipo?:
+                  | "tabla"
+                  | "grafica"
+                  | "imagen"
+                  | "caricatura"
+                  | "infografia";
+                version?: "v1";
+                tabla_markdown?: string | null;
+                grafica_json?: object | null;
+                imagen_url?: string | null;
+                imagen_svg?: string | null;
+                imagen_alt?: string | null;
+              };
               items?: {
                 /** @format uuid */
                 id_item?: string;
@@ -10227,6 +11201,20 @@ export class Api<
                 id_materia?: string | null;
                 materia_nombre?: string | null;
                 metadata?: object | null;
+                representacion_visual_enunciado?: {
+                  tipo?:
+                    | "tabla"
+                    | "grafica"
+                    | "imagen"
+                    | "caricatura"
+                    | "infografia";
+                  version?: "v1";
+                  tabla_markdown?: string | null;
+                  grafica_json?: object | null;
+                  imagen_url?: string | null;
+                  imagen_svg?: string | null;
+                  imagen_alt?: string | null;
+                };
                 imagenes?: {
                   url?: string;
                   alt?: string;
@@ -10238,6 +11226,7 @@ export class Api<
                   contenido_json?: {
                     texto?: string;
                   };
+                  texto?: string;
                   imagenes?: {
                     url?: string;
                     alt?: string;
@@ -10272,7 +11261,7 @@ export class Api<
     clasificacion?: object,
   /** Preguntas agrupadas por contexto con respuestas reveladas *\/
     grupos?: ({
-    id_estimulo?: string | null,
+    contexto?: string | null,
   /** Representación visual del contexto. Misma estructura que en diagnóstico/start. *\/
     representacion_visual_id_estimulo?: object | null,
     items?: ({
@@ -10284,6 +11273,8 @@ export class Api<
     id_materia?: string,
     materia_nombre?: string,
     metadata?: object | null,
+  /** Representación visual del enunciado si aplica. *\/
+    representacion_visual_enunciado?: object | null,
   /** true si es Comunicación Escrita *\/
     isOpenTextQuestion?: boolean,
     imagenes?: ({
@@ -10353,7 +11344,7 @@ export class Api<
             clasificacion?: object;
             /** Preguntas agrupadas por contexto con respuestas reveladas */
             grupos?: {
-              id_estimulo?: string | null;
+              contexto?: string | null;
               /** Representación visual del contexto. Misma estructura que en diagnóstico/start. */
               representacion_visual_id_estimulo?: object | null;
               items?: {
@@ -10365,6 +11356,8 @@ export class Api<
                 id_materia?: string;
                 materia_nombre?: string;
                 metadata?: object | null;
+                /** Representación visual del enunciado si aplica. */
+                representacion_visual_enunciado?: object | null;
                 /** true si es Comunicación Escrita */
                 isOpenTextQuestion?: boolean;
                 imagenes?: {
@@ -10733,8 +11726,50 @@ export class Api<
  * @request GET:/v1/exams/practice/{materiaId}
  * @secure
  * @response `200` `{
+  /** @example true *\/
     ok?: boolean,
-    data?: object,
+    data?: {
+    materia?: {
+    id_materia?: string,
+    nombre?: string,
+    institution_type?: string | null,
+
+},
+    preguntas?: ({
+  /** @format uuid *\/
+    id_item?: string,
+    enunciado?: string,
+    indice_respuesta?: number,
+    id_clasificacion?: string,
+    id_estimulo?: string | null,
+    metadata?: object | null,
+    ai_generated?: boolean,
+    imagenes?: ({
+    id_item?: string,
+    url?: string,
+    alt?: string | null,
+    orden?: number | null,
+
+})[],
+    opciones?: ({
+    id_item?: string,
+    indice_opcion?: number,
+    contenido_json?: object | null,
+    es_correcta?: boolean,
+    imagenes?: ({
+    id_item?: string,
+    indice_opcion?: number,
+    url?: string,
+    alt?: string | null,
+    orden?: number | null,
+
+})[],
+
+})[],
+
+})[],
+
+},
 
 }` Preguntas de práctica para la materia
  */
@@ -10748,8 +11783,44 @@ export class Api<
     ) =>
       this.request<
         {
+          /** @example true */
           ok?: boolean;
-          data?: object;
+          data?: {
+            materia?: {
+              id_materia?: string;
+              nombre?: string;
+              institution_type?: string | null;
+            };
+            preguntas?: {
+              /** @format uuid */
+              id_item?: string;
+              enunciado?: string;
+              indice_respuesta?: number;
+              id_clasificacion?: string;
+              id_estimulo?: string | null;
+              metadata?: object | null;
+              ai_generated?: boolean;
+              imagenes?: {
+                id_item?: string;
+                url?: string;
+                alt?: string | null;
+                orden?: number | null;
+              }[];
+              opciones?: {
+                id_item?: string;
+                indice_opcion?: number;
+                contenido_json?: object | null;
+                es_correcta?: boolean;
+                imagenes?: {
+                  id_item?: string;
+                  indice_opcion?: number;
+                  url?: string;
+                  alt?: string | null;
+                  orden?: number | null;
+                }[];
+              }[];
+            }[];
+          };
         },
         any
       >({
@@ -10770,8 +11841,44 @@ export class Api<
  * @request GET:/v1/exams/practice/theme/{tematicaId}
  * @secure
  * @response `200` `{
+  /** @example true *\/
     ok?: boolean,
-    data?: object,
+    data?: {
+    materia?: {
+    id_materia?: string,
+    nombre?: string,
+    institution_type?: string | null,
+
+},
+    tematica?: {
+    texto?: string,
+
+},
+    preguntas?: ({
+  /** @format uuid *\/
+    id_item?: string,
+    enunciado?: string,
+    indice_respuesta?: number,
+    id_clasificacion?: string,
+    id_estimulo?: string | null,
+    metadata?: object | null,
+    ai_generated?: boolean,
+  /** Registro del contexto asociado cuando existe coincidencia en contextos. *\/
+    estimulo?: object | null,
+  /** Primera imagen encontrada para la pregunta cuando aplica. *\/
+    imagen?: object | null,
+    opciones?: ({
+    id_item?: string,
+    indice_opcion?: number,
+    contenido_json?: object | null,
+    es_correcta?: boolean,
+    explicacion?: string | null,
+
+})[],
+
+})[],
+
+},
 
 }` Preguntas de práctica para la temática
  */
@@ -10787,8 +11894,39 @@ export class Api<
     ) =>
       this.request<
         {
+          /** @example true */
           ok?: boolean;
-          data?: object;
+          data?: {
+            materia?: {
+              id_materia?: string;
+              nombre?: string;
+              institution_type?: string | null;
+            };
+            tematica?: {
+              texto?: string;
+            };
+            preguntas?: {
+              /** @format uuid */
+              id_item?: string;
+              enunciado?: string;
+              indice_respuesta?: number;
+              id_clasificacion?: string;
+              id_estimulo?: string | null;
+              metadata?: object | null;
+              ai_generated?: boolean;
+              /** Registro del contexto asociado cuando existe coincidencia en contextos. */
+              estimulo?: object | null;
+              /** Primera imagen encontrada para la pregunta cuando aplica. */
+              imagen?: object | null;
+              opciones?: {
+                id_item?: string;
+                indice_opcion?: number;
+                contenido_json?: object | null;
+                es_correcta?: boolean;
+                explicacion?: string | null;
+              }[];
+            }[];
+          };
         },
         any
       >({
@@ -10999,41 +12137,15 @@ export class Api<
   /** Preguntas agrupadas por contexto/estímulo *\/
     grupos?: ({
   /** Texto del contexto/estímulo compartido. null si no hay contexto. *\/
-    id_estimulo?: string | null,
-  /** Representación visual del contexto (imagen, gráfica o tabla). Misma estructura que en diagnóstico/start. null si es solo texto. *\/
+    contexto?: string | null,
+  /** Representación visual del contexto (imagen, gráfica o tabla). null si es solo texto. *\/
     representacion_visual_id_estimulo?: {
-    tipo?: "tabla" | "grafica" | "imagen",
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
     version?: "v1",
-    descripcion?: string,
     tabla_markdown?: string | null,
-  /** Estructura de gráfica. Ver diagnóstico/start para detalle completo. *\/
-    grafica_json?: {
-    chart_type?: "bar" | "line" | "scatter" | "area",
-    x?: {
-    label?: string,
-    unit?: string | null,
-    values?: ((string | number))[],
-
-},
-    y?: {
-    label?: string,
-    unit?: string | null,
-
-},
-    series?: ({
-    name?: string,
-    data?: (number)[],
-
-})[],
-    annotations?: ({
-    type?: "reference_line",
-    axis?: "x" | "y",
-    value?: (number | string),
-    label?: string,
-
-})[],
-
-},
+  /** Estructura de gráfica serializada. *\/
+    grafica_json?: object | null,
+    imagen_url?: string | null,
     imagen_alt?: string | null,
     imagen_svg?: string | null,
 
@@ -11044,6 +12156,16 @@ export class Api<
     enunciado?: string,
     id_clasificacion?: string,
     metadata?: object | null,
+    representacion_visual_enunciado?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_alt?: string | null,
+    imagen_svg?: string | null,
+
+},
     imagenes?: ({
     url?: string,
     alt?: string,
@@ -11058,6 +12180,7 @@ export class Api<
     texto?: string,
 
 },
+    texto?: string,
     imagenes?: ({
     url?: string,
     alt?: string,
@@ -11096,36 +12219,20 @@ export class Api<
           /** Preguntas agrupadas por contexto/estímulo */
           grupos?: {
             /** Texto del contexto/estímulo compartido. null si no hay contexto. */
-            id_estimulo?: string | null;
-            /** Representación visual del contexto (imagen, gráfica o tabla). Misma estructura que en diagnóstico/start. null si es solo texto. */
+            contexto?: string | null;
+            /** Representación visual del contexto (imagen, gráfica o tabla). null si es solo texto. */
             representacion_visual_id_estimulo?: {
-              tipo?: "tabla" | "grafica" | "imagen";
+              tipo?:
+                | "tabla"
+                | "grafica"
+                | "imagen"
+                | "caricatura"
+                | "infografia";
               version?: "v1";
-              descripcion?: string;
               tabla_markdown?: string | null;
-              /** Estructura de gráfica. Ver diagnóstico/start para detalle completo. */
-              grafica_json?: {
-                chart_type?: "bar" | "line" | "scatter" | "area";
-                x?: {
-                  label?: string;
-                  unit?: string | null;
-                  values?: (string | number)[];
-                };
-                y?: {
-                  label?: string;
-                  unit?: string | null;
-                };
-                series?: {
-                  name?: string;
-                  data?: number[];
-                }[];
-                annotations?: {
-                  type?: "reference_line";
-                  axis?: "x" | "y";
-                  value?: number | string;
-                  label?: string;
-                }[];
-              };
+              /** Estructura de gráfica serializada. */
+              grafica_json?: object | null;
+              imagen_url?: string | null;
               imagen_alt?: string | null;
               imagen_svg?: string | null;
             };
@@ -11135,6 +12242,20 @@ export class Api<
               enunciado?: string;
               id_clasificacion?: string;
               metadata?: object | null;
+              representacion_visual_enunciado?: {
+                tipo?:
+                  | "tabla"
+                  | "grafica"
+                  | "imagen"
+                  | "caricatura"
+                  | "infografia";
+                version?: "v1";
+                tabla_markdown?: string | null;
+                grafica_json?: object | null;
+                imagen_url?: string | null;
+                imagen_alt?: string | null;
+                imagen_svg?: string | null;
+              };
               imagenes?: {
                 url?: string;
                 alt?: string;
@@ -11147,6 +12268,7 @@ export class Api<
                 contenido_json?: {
                   texto?: string;
                 };
+                texto?: string;
                 imagenes?: {
                   url?: string;
                   alt?: string;
@@ -11357,7 +12479,7 @@ export class Api<
 },
   /** Preguntas agrupadas por contexto con respuestas correctas reveladas *\/
     grupos?: ({
-    id_estimulo?: string | null,
+    contexto?: string | null,
   /** Misma estructura que en missions/start *\/
     representacion_visual_id_estimulo?: object | null,
     items?: ({
@@ -11368,6 +12490,8 @@ export class Api<
     indice_respuesta?: number,
     id_clasificacion?: string,
     metadata?: object | null,
+  /** Representación visual del enunciado si aplica. *\/
+    representacion_visual_enunciado?: object | null,
     imagenes?: ({
     url?: string,
     alt?: string,
@@ -11381,6 +12505,7 @@ export class Api<
     texto?: string,
 
 },
+    texto?: string,
     es_correcta?: boolean,
     explicacion?: string | null,
     imagenes?: ({
@@ -11429,7 +12554,7 @@ export class Api<
           };
           /** Preguntas agrupadas por contexto con respuestas correctas reveladas */
           grupos?: {
-            id_estimulo?: string | null;
+            contexto?: string | null;
             /** Misma estructura que en missions/start */
             representacion_visual_id_estimulo?: object | null;
             items?: {
@@ -11440,6 +12565,8 @@ export class Api<
               indice_respuesta?: number;
               id_clasificacion?: string;
               metadata?: object | null;
+              /** Representación visual del enunciado si aplica. */
+              representacion_visual_enunciado?: object | null;
               imagenes?: {
                 url?: string;
                 alt?: string;
@@ -11451,6 +12578,7 @@ export class Api<
                 contenido_json?: {
                   texto?: string;
                 };
+                texto?: string;
                 es_correcta?: boolean;
                 explicacion?: string | null;
                 imagenes?: {
@@ -12540,9 +13668,18 @@ export class Api<
     status?: string,
   /** Preguntas agrupadas por contexto/estímulo *\/
     grupos?: ({
-    id_estimulo?: string | null,
-  /** Representación visual del contexto. Misma estructura que en diagnóstico/start (tipo, version, descripcion, tabla_markdown, grafica_json, imagen_alt, imagen_svg). *\/
-    representacion_visual_id_estimulo?: object | null,
+    contexto?: string | null,
+  /** Representación visual del contexto. Misma estructura que en diagnóstico/start actual (tipo, version, tabla_markdown, grafica_json, imagen_url, imagen_svg, imagen_alt). *\/
+    representacion_visual_id_estimulo?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_svg?: string | null,
+    imagen_alt?: string | null,
+
+},
     items?: ({
   /** @format uuid *\/
     id_item?: string,
@@ -12552,6 +13689,16 @@ export class Api<
     materia_nombre?: string | null,
     metadata?: object | null,
     ai_generated?: boolean,
+    representacion_visual_enunciado?: {
+    tipo?: "tabla" | "grafica" | "imagen" | "caricatura" | "infografia",
+    version?: "v1",
+    tabla_markdown?: string | null,
+    grafica_json?: object | null,
+    imagen_url?: string | null,
+    imagen_svg?: string | null,
+    imagen_alt?: string | null,
+
+},
     imagenes?: (object)[],
   /** Opciones sin es_correcta ni explicacion. Incluye id_item del parent. *\/
     opciones?: ({
@@ -12562,6 +13709,7 @@ export class Api<
     texto?: string,
 
 },
+    texto?: string,
     imagenes?: (object)[],
 
 })[],
@@ -12604,9 +13752,22 @@ export class Api<
           status?: string;
           /** Preguntas agrupadas por contexto/estímulo */
           grupos?: {
-            id_estimulo?: string | null;
-            /** Representación visual del contexto. Misma estructura que en diagnóstico/start (tipo, version, descripcion, tabla_markdown, grafica_json, imagen_alt, imagen_svg). */
-            representacion_visual_id_estimulo?: object | null;
+            contexto?: string | null;
+            /** Representación visual del contexto. Misma estructura que en diagnóstico/start actual (tipo, version, tabla_markdown, grafica_json, imagen_url, imagen_svg, imagen_alt). */
+            representacion_visual_id_estimulo?: {
+              tipo?:
+                | "tabla"
+                | "grafica"
+                | "imagen"
+                | "caricatura"
+                | "infografia";
+              version?: "v1";
+              tabla_markdown?: string | null;
+              grafica_json?: object | null;
+              imagen_url?: string | null;
+              imagen_svg?: string | null;
+              imagen_alt?: string | null;
+            };
             items?: {
               /** @format uuid */
               id_item?: string;
@@ -12616,6 +13777,20 @@ export class Api<
               materia_nombre?: string | null;
               metadata?: object | null;
               ai_generated?: boolean;
+              representacion_visual_enunciado?: {
+                tipo?:
+                  | "tabla"
+                  | "grafica"
+                  | "imagen"
+                  | "caricatura"
+                  | "infografia";
+                version?: "v1";
+                tabla_markdown?: string | null;
+                grafica_json?: object | null;
+                imagen_url?: string | null;
+                imagen_svg?: string | null;
+                imagen_alt?: string | null;
+              };
               imagenes?: object[];
               /** Opciones sin es_correcta ni explicacion. Incluye id_item del parent. */
               opciones?: {
@@ -12625,6 +13800,7 @@ export class Api<
                 contenido_json?: {
                   texto?: string;
                 };
+                texto?: string;
                 imagenes?: object[];
               }[];
             }[];