@arcadialdev/arcality 2.4.35 → 2.4.37

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcadialdev/arcality",
-  "version": "2.4.35",
+  "version": "2.4.37",
   "description": "AI-powered QA testing tool — Autonomous web testing agent by Arcadial",
   "main": "index.js",
   "scripts": {

package/tests/_helpers/agentic-runner.bundle.spec.js

@@ -939,11 +939,11 @@ ${relevantFailures.map((m) => `- ${m.prompt}`).join("\n")}
             const role = htmlEl.getAttribute("role") || "";
             const text = (htmlEl.innerText || htmlEl.getAttribute("aria-label") || htmlEl.getAttribute("title") || "").trim().replace(/\s+/g, " ");
             const textLower = text.toLowerCase();
-            const isCriticalFailure = (textLower.includes("error") || textLower.includes("fall\xF3") || textLower.includes("no se puede") || textLower.includes("ya existe") || textLower.includes("existe") || textLower.includes("inv\xE1lido") || textLower.includes("incorrecto") || textLower.includes("ligado") || textLower.includes("depende") || textLower.includes("duplicado") || textLower.includes("repetido") || /* Validaciones ZOD / Wizard de campos de formulario */
+            const isCriticalFailure = (textLower.includes("error") || textLower.includes("fall\xF3") || textLower.includes("no se puede") || textLower.includes("ya existe") || textLower.includes("inv\xE1lido") || textLower.includes("incorrecto") || textLower.includes("ligado") || textLower.includes("depende") || textLower.includes("duplicado") || textLower.includes("repetido") || /* Validaciones ZOD / Wizard de campos de formulario */
             textLower.includes("debe ser mayor") || textLower.includes("debe ser menor") || textLower.includes("debe ser igual") || textLower.includes("debe ser mayor o igual") || textLower.includes("debe ser menor o igual") || /* ZOD date messages (Spanish) */
             textLower.includes("debe ser posterior") || textLower.includes("debe ser anterior") || textLower.includes("debe ser una fecha") || textLower.includes("fecha debe ser") || textLower.includes("posterior o igual a la fecha") || textLower.includes("anterior o igual a la fecha") || textLower.includes("posterior a la fecha") || textLower.includes("anterior a la fecha") || textLower.includes("fecha") && (textLower.includes("actual") || textLower.includes("pasada") || textLower.includes("futura") || textLower.includes("requerida") || textLower.includes("inv\xE1lida") || textLower.includes("incorrecta") || textLower.includes("posterior") || textLower.includes("anterior")) || /* ZOD number/range messages */
-            textLower.includes("debe ser un n\xFAmero") || textLower.includes("debe ser positivo") || textLower.includes("debe ser negativo") || textLower.includes("m\xEDnimo") && textLower.includes("caracteres") || textLower.includes("m\xE1ximo") && textLower.includes("caracteres") || textLower.includes("al menos") || textLower.includes("como m\xE1ximo") || /* Generic ZOD/form required */
-            textLower.includes("campo requerido") || textLower.includes("campo obligatorio") || textLower.includes("requerido") || textLower.includes("obligatorio") || textLower.includes("no puede estar vac\xEDo") || textLower.includes("no puede ser") || textLower.includes("no es v\xE1lido") || textLower.includes("no es correcto") || textLower.includes("recuerda llenar") || textLower.includes("completa los campos") || textLower.includes("campos obligatorios") || textLower.includes("formato incorrecto") || textLower.includes("formato inv\xE1lido") || textLower.includes("valor no permitido")) && text.length < 250;
+            textLower.includes("debe ser un n\xFAmero") || textLower.includes("debe ser positivo") || textLower.includes("debe ser negativo") || textLower.includes("m\xEDnimo") && textLower.includes("caracteres") || textLower.includes("m\xE1ximo") && textLower.includes("caracteres") || /* Generic ZOD/form required — must be specific, NOT broad instructional text */
+            textLower.includes("campo requerido") || textLower.includes("campo obligatorio") || textLower === "requerido" || textLower === "obligatorio" || textLower.includes("este campo es requerido") || textLower.includes("este campo es obligatorio") || textLower.includes("no puede estar vac\xEDo") || textLower.includes("no puede ser") || textLower.includes("no es v\xE1lido") || textLower.includes("no es correcto") || textLower.includes("formato incorrecto") || textLower.includes("formato inv\xE1lido") || textLower.includes("valor no permitido")) && text.length < 200 && !textLower.includes("recuerda") && !textLower.includes("antes de guardar");
             const isCriticalSuccess = (textLower.includes("exitosamente") || textLower.includes("guardado") || textLower.includes("creado") || textLower.includes("success") || textLower.includes("correctamente") && text.length < 100) && text.length < 200;
             const isCriticalFeedback = isCriticalFailure || isCriticalSuccess;
             if (!isCriticalFeedback && (tag === "span" || tag === "p" || tag === "label" || tag === "i" || tag === "svg" || tag === "img" || tag === "div")) {
@@ -956,6 +956,48 @@ ${relevantFailures.map((m) => `- ${m.prompt}`).join("\n")}
             const idx = startIdx + localCount++;
             htmlEl.setAttribute("agent-idx", idx.toString());
             let name = text || htmlEl.getAttribute("aria-label") || htmlEl.getAttribute("title") || htmlEl.getAttribute("placeholder");
+            if (!name && (tag === "input" || tag === "select" || htmlEl.getAttribute("role") === "combobox")) {
+              const labelledBy = htmlEl.getAttribute("aria-labelledby");
+              if (labelledBy) {
+                const labelEl = document.getElementById(labelledBy);
+                if (labelEl)
+                  name = labelEl.innerText.trim();
+              }
+              if (!name && htmlEl.id) {
+                const forLabel = document.querySelector(`label[for="${htmlEl.id}"]`);
+                if (forLabel)
+                  name = forLabel.innerText.trim();
+              }
+              if (!name) {
+                const parentLabel = htmlEl.closest("label");
+                if (parentLabel)
+                  name = parentLabel.innerText.replace(htmlEl.textContent || "", "").trim();
+              }
+              if (!name) {
+                let prev = htmlEl.previousElementSibling;
+                let tries = 0;
+                while (prev && tries < 3) {
+                  const prevText = (prev.innerText || "").trim();
+                  if (prevText && prevText.length > 1 && prevText.length < 60) {
+                    name = prevText;
+                    break;
+                  }
+                  prev = prev.previousElementSibling;
+                  tries++;
+                }
+              }
+              if (!name) {
+                const container = htmlEl.closest("div, fieldset, section");
+                if (container) {
+                  const labelInContainer = container.querySelector('label, [class*="label"], [class*="placeholder"]');
+                  if (labelInContainer) {
+                    const labelText = (labelInContainer.innerText || "").trim();
+                    if (labelText && labelText.length < 60)
+                      name = labelText;
+                  }
+                }
+              }
+            }
             if (!name) {
               const iconMatch = htmlEl.outerHTML.match(/fa-([a-z0-9-]+)|md-([a-z0-9-]+)|bi-([a-z0-9-]+)/i);
               if (iconMatch) {
@@ -1205,10 +1247,18 @@ ${relevantFailures.map((m) => `- ${m.prompt}`).join("\n")}
           return c.selector === memStep.action_data?.selector || cleanMemName !== "" && (cleanMemName === cleanCurrName || cleanCurrName.includes(cleanMemName));
         });
         if (!foundComponent && memStep.action_data?.action !== "wait") {
-          console.log(`>>ARCALITY_STATUS>> \u23F3 Componente target no visible ("${memStep.componentName}"). Forzando espera de transici\xF3n DOM...`);
           console.log(`>>ARCALITY_STATUS>> \u{1F50D} Descartado (Componente visual no encontrado: ${memStep.componentName})`);
           return null;
         }
+        if (foundComponent && memStep.action_data?.action === "fill") {
+          const compType = (foundComponent.type || "").toLowerCase();
+          const compName = (foundComponent.name || "").toLowerCase();
+          const looksLikeDropdown = compType.includes("select") || compType.includes("combobox") || compName.includes("tipo") || compName.includes("type") || compName.includes("categor\xEDa") || compName.includes("estado") || compName.includes("frecuencia") || compName.includes("alcance");
+          if (looksLikeDropdown) {
+            console.log(`>>ARCALITY_STATUS>> \u{1F50D} Descartado (fill en dropdown detectado: ${foundComponent.name}). Delegando a IA.`);
+            return null;
+          }
+        }
         const memCompName = memStep.componentName || "";
         if (memCompName.length > 80) {
           console.log(`>>ARCALITY_STATUS>> \u{1F50D} Descartado (Mensaje enorme o nombre inconsistente: ${memCompName.substring(0, 20)}...)`);
@@ -1463,6 +1513,10 @@ These are NOT optional. You MUST use these tools in these situations:
 # CRITICAL RULES
 1. **NEVER BLIND-RETRY**: If an action fails, you MUST investigate with \`inspect_element_details\` before retrying. Repeating the exact same failed action is FORBIDDEN.
 2. **NO REPEAT ACTIONS**: Check HISTORY. If you already filled a field or clicked a button, do NOT do it again unless the UI clearly reset OR the button belongs to a different step/modal/section mentioned in the mission (e.g., Save in modal vs Save in main form).
+3. **GROUP ACTIONS**: You MUST group non-conflicting actions in a single turn to save time and tokens. You can \`fill\` multiple text inputs in the SAME turn.
+   - NEVER use \`click\` on a text field before using \`fill\`. The \`fill\` action automatically focuses the field.
+   - Example: \`fill\` Nombre, \`fill\` Fecha, \`fill\` Descripci\xF3n all in one single turn.
+   - BUT keep dropdown interactions isolated: Turn A = \`click\` dropdown. Turn B = \`click\` option.
 
 3. **CURRENT STATE > MEMORY**: What you see in CURRENT COMPONENTS is the truth. SUCCESS MEMORY is a guide, not gospel.
 4. **PAGE TRANSITIONS**: If URL contains '/edit' or you see a 'Save' button, you ARE in the edit view. Don't go back.
@@ -1493,9 +1547,7 @@ These are NOT optional. You MUST use these tools in these situations:
 # WIZARD & MULTI-STEP FORMS (CRITICAL)
 When a form is divided into numbered steps (e.g., Step 1 \u2192 Step 2 \u2192 Step 3):
 
-1. **VALIDATION ERROR ON SAVE = STEP HAS INVALID DATA**: If you see a \u{1F6D1} [ERROR_CR\xCDTICO] after clicking Save/Next and you are on step N, it means a PREVIOUS step contains bad data. You MUST navigate BACK to that step.
-   - Look for a "Back" / "Anterior" / "Periodo" / step-number button and click it to return.
-   - NEVER retry the Save button without first fixing the invalid data in the previous step.
+1. **VALIDATION ERROR ON ADVANCE**: If you click "Next/Siguiente" and the UI DOES NOT advance to the next step, AND you see a \u{1F6D1} [ERROR_CR\xCDTICO], you must fix the data on the CURRENT step. DO NOT GO BACK to previous steps simply because you see an error, unless the error explicitly states that a previous step's data is invalid.
 
 2. **DATE VALIDATION ERRORS \u2014 MANDATORY PROTOCOL (ZOD-AWARE)**:
    - ZOD generates Spanish validation messages such as:
@@ -1506,8 +1558,8 @@ When a form is divided into numbered steps (e.g., Step 1 \u2192 Step 2 \u2192 St
    - ANY \u{1F6D1} [ERROR_CR\xCDTICO] containing FECHA + (POSTERIOR/ANTERIOR/ACTUAL/PASADA/FUTURA) is a **ZOD DATE VALIDATION ERROR**.
    - **RECOVERY PROTOCOL** (follow in order, NEVER skip):
      1. STOP \u2014 do NOT click Save/Siguiente again with the same data.
-     2. Identify which wizard step contains the failing date field (check HISTORY \u2014 usually Step 1 or Step 2).
-     3. Click the Back/Anterior/step-number button to return to that step.
+     2. Identify which wizard step contains the failing date field (check HISTORY).
+     3. If you are NOT on that step, click the Back/Anterior button to return to it.
      4. Locate the date input using \`validate_element_state\` with 'has_value' to confirm its current (bad) value.
      5. Clear and re-fill the date using \`interact_native_control\` with control_type \`'date'\` and a value \u2265 TODAY in YYYY-MM-DD format.
      6. TODAY: \`${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}\` \u2014 use this exact expression to compute the date dynamically.
@@ -1515,7 +1567,9 @@ When a form is divided into numbered steps (e.g., Step 1 \u2192 Step 2 \u2192 St
 
 3. **NEVER LOOP ON THE SAME STEP**: If you've been on the same wizard step for 3+ turns without advancing, go back one step and verify the data is correct before trying to advance again.
 
-4. **STEP VERIFICATION**: Before clicking Next/Save on any step, VERIFY that date fields have future-or-today dates. Use \`validate_element_state\` with 'has_value' to confirm.`
+4. **STEP VERIFICATION**: Before clicking Next/Save on any step, VERIFY that date fields have future-or-today dates. Use \`validate_element_state\` with 'has_value' to confirm.
+
+5. **FINAL PREVIEW STEP**: If you reach a final step like "Previsualizaci\xF3n", "Resumen", or see a "Terminar" / "Finalizar" button, your objective is ALMOST COMPLETE. Do NOT go back to previous steps just because you see read-only data. Click the final submit button ("Terminar", "Guardar", "Finalizar") to complete the mission.`
       }
     ];
     if (this.testInfo) {
@@ -1647,7 +1701,12 @@ ${history.slice(-25).join("\n") || "None"}`
       const textResponse = message.content.find((c) => c.type === "text")?.text || "";
       if (toolCalls.length === 0) {
         console.log(`(${((Date.now() - startTime) / 1e3).toFixed(1)}s)`);
-        return { thought: textResponse || "No action decided", actions: [], usage: totalUsage };
+        console.log(`>>ARCALITY_STATUS>> \u26A0\uFE0F Agente devolvi\xF3 texto sin acci\xF3n. Reinyectando instrucci\xF3n mandatoria...`);
+        anthropicMessages.push({
+          role: "user",
+          content: [{ type: "text", text: `MANDATORY: You MUST call one of the available tools right now. You are NOT allowed to return plain text only. If you are unsure, call 'perform_ui_actions' with the most logical next action based on the mission and history. If you are truly stuck, call 'report_inability_to_proceed'. DO NOT return text without a tool call.` }]
+        });
+        continue;
       }
       const toolResults = [];
       let uiActionCall = null;
@@ -2863,14 +2922,17 @@ function captureValidationRule(errorMessage, context) {
               }
             }
             const lastAction = history[history.length - 1];
-            if (lastAction && lastAction.includes(`click en "${desc}"`)) {
+            const isGenericName = !desc || desc === "[input]" || desc === "[button]" || desc === "[select]" || desc === "[div]" || desc.trim().length < 3;
+            if (!isGenericName && lastAction && lastAction.includes(`click en "${desc}"`)) {
               const isDotsTrigger = desc.includes("dots") || desc.includes("vert") || desc.includes("menu") || desc.includes("opciones");
               const sameActionCount = history.filter((h) => h.includes(`click en "${desc}"`)).length;
-              const toleranceLimit = allowRepeatedNames ? 3 : 1;
-              if (isDotsTrigger && sameActionCount < 2) {
+              const toleranceLimit = allowRepeatedNames ? 4 : 2;
+              if (isDotsTrigger && sameActionCount < 3) {
                 console.log(`    \u26A0\uFE0F Re-intentando click en men\xFA "${desc}"...`);
               } else if (allowRepeatedNames && sameActionCount < toleranceLimit) {
                 console.log(`    \u26A0\uFE0F Click repetido permitido por contexto de misi\xF3n en "${desc}"...`);
+              } else if (sameActionCount < toleranceLimit) {
+                console.log(`    \u26A0\uFE0F Re-intento ${sameActionCount} en "${desc}"...`);
               } else {
                 const bodyText = await page.innerText("body").catch(() => "");
                 if (bodyText.match(/ligado|depende|no se puede/i)) {
@@ -2881,9 +2943,9 @@ function captureValidationRule(errorMessage, context) {
                   break;
                 }
                 console.log(`
-\u{1F6D1} [AUTO-STOP] Bloqueando click duplicado en "${desc}". Forzando re-evaluaci\xF3n.`);
-                history.push(`Turno ${stepCount}: Bloqueado click repetido en "${desc}" (Evitando bucle)`);
-                await page.waitForTimeout(1e3);
+\u{1F6D1} [AUTO-STOP] Bloqueando click repetido en "${desc}" (${sameActionCount} veces). Forzando re-evaluaci\xF3n.`);
+                history.push(`Turno ${stepCount}: \u{1F6D1} [AUTO-STOP] El click en "${desc}" fue bloqueado despu\xE9s de ${sameActionCount} repeticiones. Usa un IDX diferente o intenta hacer scroll para revelar el elemento. Si es un dropdown que no abre, usa interact_native_control.`);
+                await page.waitForTimeout(800);
                 break;
               }
             }