explorbot 0.1.23 → 0.1.25

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "explorbot",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "description": "CLI app built with React Ink, CodeceptJS, and Playwright",
   "license": "Elastic-2.0",
   "type": "module",

package/dist/src/ai/rules.js

@@ -127,6 +127,11 @@ export const fileUploadRule = dedent `
   Works with drag-and-drop upload zones.
   </file_upload>
 `;
+export const formRequirementsRule = dedent `
+  <form_requirements>
+  Before filling a form that persists data (create/update), read each control's requirements (required, type/format, length, placeholder/aria-describedby hints) from <page_aria> and page HTML — call context() if not visible — and enter values that satisfy them. Search/filter/sort forms that only change the view do not need this.
+  </form_requirements>
+`;
 // in rage mode we do not protect from irreversible actions
 export const protectionRule = dedent `
   <important>
@@ -260,6 +265,8 @@ export const actionRule = dedent `
   If locator doesn't work, try CSS or XPath locators.
   If nothing works, use I.clickXY(x, y) as last resort.
 
+  For checkboxes, prefer I.checkOption/I.uncheckOption over I.click.
+
 
   ### I.fillField
 
@@ -346,6 +353,19 @@ export const actionRule = dedent `
     I.selectOption('form select[name=account]', 'Premium');
   </example>
 
+  ### I.checkOption / I.uncheckOption
+
+  Set a checkbox/radio to a definite state — idempotent, never toggles. Use for checkboxes instead of I.click. Run via form(), not click().
+
+  I.checkOption(<locator>, <context>)
+  I.uncheckOption(<locator>, <context>)
+
+  <example>
+    I.checkOption('Subscribe');
+    I.checkOption({ role: 'checkbox', text: 'Agree' });
+    I.uncheckOption('Subscribe', '.preferences');
+  </example>
+
   ### I.attachFile
 
   Attaches a file to a file input element.

package/dist/src/ai/tester.js

@@ -14,7 +14,7 @@ import { ErrorPageError } from "../utils/error-page.js";
 import { HooksRunner } from "../utils/hooks-runner.js";
 import { createDebug, tag } from "../utils/logger.js";
 import { loop } from "../utils/loop.js";
-import { actionRule, focusedElementRule, locatorRule, multipleTabsRule, protectionRule, sectionContextRule } from "./rules.js";
+import { actionRule, focusedElementRule, formRequirementsRule, locatorRule, multipleTabsRule, protectionRule, sectionContextRule } from "./rules.js";
 import { TaskAgent } from "./task-agent.js";
 import { createCodeceptJSTools, createSpecialContextTools } from "./tools.js";
 const debugLog = createDebug('explorbot:tester');
@@ -668,7 +668,7 @@ export class Tester extends TaskAgent {
     - When filling complex form with lot of actions performed, use see() to look which fields were filled and which are not
     - When verify() fails, use see() to visually confirm the result — visual confirmation is equally valid evidence
     - For visual state verification (active tabs, selected items, counts, colors), prefer see() over DOM-based verify()
-    - When click() fails and element is visually present, use visualClick() as fallback
+    - When click() fails on an element you can see — or believe is there but may look different — you MUST try visualClick() before giving up; don't repeat visualClick in a row
     - If you land on a "Not Found", 404, or error page that is NOT part of the scenario, call reset() immediately to return to the initial page and try again
     - If you see a server error page (500, 503, etc.), record it with record({ notes: ["Server error on /path"], status: "fail" }) and call reset() to continue testing
     </rules>
@@ -691,6 +691,8 @@ export class Tester extends TaskAgent {
 
     ${sectionContextRule}
 
+    ${formRequirementsRule}
+
     ${this.provider.getSystemPromptForAgent('tester', this.explorer.getStateManager().getCurrentState()?.url) || ''}
     `;
     }

package/dist/src/ai/tools.js

@@ -262,6 +262,7 @@ export function createCodeceptJSTools(explorer, task) {
 
         Use cases:
         - Typing into input fields (I.fillField, I.type)
+        - Setting checkboxes/radios to a definite state (I.checkOption, I.uncheckOption)
         - Working with iframes (switch context with I.switchTo)
         - Performing multiple form actions in a single batch
         - Complex interactions requiring sequential commands
@@ -269,6 +270,7 @@ export function createCodeceptJSTools(explorer, task) {
         Example - filling a form with context (PREFERRED):
         I.fillField('Username', 'John', '.login-form')
         I.selectOption('Country', 'USA', '.address-section')
+        I.checkOption('Agree', '.terms-section')
         I.attachFile('input[type="file"]', 'path/to/file', '.upload-section')
 
         Example - filling a form with ARIA locators:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "explorbot",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "description": "CLI app built with React Ink, CodeceptJS, and Playwright",
   "license": "Elastic-2.0",
   "type": "module",

package/src/ai/rules.ts

@@ -131,6 +131,12 @@ export const fileUploadRule = dedent`
   </file_upload>
 `;
 
+export const formRequirementsRule = dedent`
+  <form_requirements>
+  Before filling a form that persists data (create/update), read each control's requirements (required, type/format, length, placeholder/aria-describedby hints) from <page_aria> and page HTML — call context() if not visible — and enter values that satisfy them. Search/filter/sort forms that only change the view do not need this.
+  </form_requirements>
+`;
+
 // in rage mode we do not protect from irreversible actions
 export const protectionRule = dedent`
   <important>
@@ -270,6 +276,8 @@ export const actionRule = dedent`
   If locator doesn't work, try CSS or XPath locators.
   If nothing works, use I.clickXY(x, y) as last resort.
 
+  For checkboxes, prefer I.checkOption/I.uncheckOption over I.click.
+
 
   ### I.fillField
 
@@ -356,6 +364,19 @@ export const actionRule = dedent`
     I.selectOption('form select[name=account]', 'Premium');
   </example>
 
+  ### I.checkOption / I.uncheckOption
+
+  Set a checkbox/radio to a definite state — idempotent, never toggles. Use for checkboxes instead of I.click. Run via form(), not click().
+
+  I.checkOption(<locator>, <context>)
+  I.uncheckOption(<locator>, <context>)
+
+  <example>
+    I.checkOption('Subscribe');
+    I.checkOption({ role: 'checkbox', text: 'Agree' });
+    I.uncheckOption('Subscribe', '.preferences');
+  </example>
+
   ### I.attachFile
 
   Attaches a file to a file input element.

package/src/ai/tester.ts

@@ -25,7 +25,7 @@ import { Navigator } from './navigator.ts';
 import type { Pilot } from './pilot.ts';
 import { Provider } from './provider.ts';
 import { Researcher } from './researcher.ts';
-import { actionRule, focusedElementRule, locatorRule, multipleTabsRule, protectionRule, sectionContextRule } from './rules.ts';
+import { actionRule, focusedElementRule, formRequirementsRule, locatorRule, multipleTabsRule, protectionRule, sectionContextRule } from './rules.ts';
 import { TaskAgent } from './task-agent.ts';
 import { createCodeceptJSTools, createSpecialContextTools } from './tools.ts';
 
@@ -750,7 +750,7 @@ export class Tester extends TaskAgent implements Agent {
     - When filling complex form with lot of actions performed, use see() to look which fields were filled and which are not
     - When verify() fails, use see() to visually confirm the result — visual confirmation is equally valid evidence
     - For visual state verification (active tabs, selected items, counts, colors), prefer see() over DOM-based verify()
-    - When click() fails and element is visually present, use visualClick() as fallback
+    - When click() fails on an element you can see — or believe is there but may look different — you MUST try visualClick() before giving up; don't repeat visualClick in a row
     - If you land on a "Not Found", 404, or error page that is NOT part of the scenario, call reset() immediately to return to the initial page and try again
     - If you see a server error page (500, 503, etc.), record it with record({ notes: ["Server error on /path"], status: "fail" }) and call reset() to continue testing
     </rules>
@@ -773,6 +773,8 @@ export class Tester extends TaskAgent implements Agent {
 
     ${sectionContextRule}
 
+    ${formRequirementsRule}
+
     ${this.provider.getSystemPromptForAgent('tester', this.explorer.getStateManager().getCurrentState()?.url) || ''}
     `;
   }

package/src/ai/tools.ts

@@ -307,6 +307,7 @@ export function createCodeceptJSTools(explorer: Explorer, task: Task) {
 
         Use cases:
         - Typing into input fields (I.fillField, I.type)
+        - Setting checkboxes/radios to a definite state (I.checkOption, I.uncheckOption)
         - Working with iframes (switch context with I.switchTo)
         - Performing multiple form actions in a single batch
         - Complex interactions requiring sequential commands
@@ -314,6 +315,7 @@ export function createCodeceptJSTools(explorer: Explorer, task: Task) {
         Example - filling a form with context (PREFERRED):
         I.fillField('Username', 'John', '.login-form')
         I.selectOption('Country', 'USA', '.address-section')
+        I.checkOption('Agree', '.terms-section')
         I.attachFile('input[type="file"]', 'path/to/file', '.upload-section')
 
         Example - filling a form with ARIA locators: