explorbot 0.0.1 → 0.1.0

package/dist/src/explorer.js

@@ -15,6 +15,7 @@ import { StateManager } from './state-manager.js';
 import { RequestStore } from "./api/request-store.js";
 import { XhrCapture } from "./api/xhr-capture.js";
 import { createDebug, log, tag } from './utils/logger.js';
+import { WebElement, extractElementData } from "./utils/web-element.js";
 const debugLog = createDebug('explorbot:explorer');
 const FATAL_BROWSER_ERRORS = /Frame was detached|Target closed|Execution context was destroyed|Protocol error|Session closed/i;
 class Explorer {
@@ -243,19 +244,7 @@ class Explorer {
         return action;
     }
     async annotateElements() {
-        const page = this.playwrightHelper.page;
-        const roles = ['button', 'link', 'textbox', 'searchbox', 'checkbox', 'radio', 'switch', 'combobox', 'tab', 'menuitem', 'menuitemcheckbox', 'menuitemradio', 'option', 'slider', 'spinbutton', 'treeitem'];
-        let idx = 1;
-        for (const role of roles) {
-            const elements = await page.getByRole(role).all();
-            for (const el of elements) {
-                await el.evaluate((node, i) => {
-                    node.setAttribute('data-explorbot-eidx', String(i));
-                }, idx);
-                idx++;
-            }
-        }
-        return idx - 1;
+        return annotatePageElements(this.playwrightHelper.page);
     }
     async visuallyAnnotateElements(opts) {
         return visuallyAnnotateContainers(this.playwrightHelper.page, opts?.containers || []);
@@ -269,7 +258,7 @@ class Explorer {
             for (const el of elements) {
                 const attr = await el.getAttribute('data-explorbot-eidx');
                 if (attr)
-                    result.push(Number.parseInt(attr, 10));
+                    result.push(attr);
             }
             return result;
         }
@@ -286,8 +275,7 @@ class Explorer {
             const page = this.playwrightHelper.page;
             const base = container ? page.locator(container) : page;
             const el = locator.startsWith('//') ? base.locator(`xpath=${locator}`) : base.locator(locator);
-            const eidx = await el.first().getAttribute('data-explorbot-eidx');
-            return eidx ? Number.parseInt(eidx, 10) : null;
+            return await el.first().getAttribute('data-explorbot-eidx');
         }
         catch (error) {
             if (this.isFatalBrowserError(error)) {
@@ -607,5 +595,58 @@ function toCodeceptjsTest(test) {
     codeceptjsTest.notes = test.getPrintableNotes();
     return codeceptjsTest;
 }
+const REF_LINE_PATTERN = /^(\s*)-\s+(\w+)\s*(?:"([^"]*)")?.*?\[ref=(e\d+)\]/;
+const ANNOTATABLE_ROLES = new Set(['button', 'link', 'textbox', 'searchbox', 'checkbox', 'radio', 'switch', 'combobox', 'tab', 'menuitem', 'menuitemcheckbox', 'menuitemradio', 'option', 'slider', 'spinbutton', 'treeitem']);
+function parseAriaRefs(ariaSnapshot) {
+    const entries = [];
+    for (const line of ariaSnapshot.split('\n')) {
+        const match = line.match(REF_LINE_PATTERN);
+        if (!match)
+            continue;
+        if (!ANNOTATABLE_ROLES.has(match[2]))
+            continue;
+        entries.push({ role: match[2], name: match[3] || '', ref: match[4] });
+    }
+    return entries;
+}
+export async function annotatePageElements(page) {
+    const ariaSnapshot = await page.locator('body').ariaSnapshot({ forAI: true });
+    const refEntries = parseAriaRefs(ariaSnapshot);
+    const byRole = new Map();
+    for (const { role, name, ref } of refEntries) {
+        let list = byRole.get(role);
+        if (!list) {
+            list = [];
+            byRole.set(role, list);
+        }
+        list.push({ name, ref });
+    }
+    const elements = [];
+    for (const [role, entries] of byRole) {
+        try {
+            const rawList = await page.getByRole(role).evaluateAll((domElements, [data, extractFnStr]) => {
+                const extract = new Function(`return ${extractFnStr}`)();
+                const results = [];
+                let ariaIdx = 0;
+                for (const el of domElements) {
+                    if (ariaIdx >= data.length)
+                        break;
+                    el.setAttribute('data-explorbot-eidx', data[ariaIdx].ref);
+                    const elData = extract(el);
+                    if (elData)
+                        results.push(elData);
+                    ariaIdx++;
+                }
+                return results;
+            }, [entries, extractElementData.toString()]);
+            for (const raw of rawList) {
+                elements.push(WebElement.fromRawData(raw, role));
+            }
+        }
+        catch {
+            debugLog(`Failed to annotate role=${role}`);
+        }
+    }
+    return { ariaSnapshot, elements };
+}
 export default Explorer;
-//# sourceMappingURL=explorer.js.map

package/dist/src/index.js

@@ -53,4 +53,3 @@ else {
     // Default to explore command
     exploreCommand(options);
 }
-//# sourceMappingURL=index.js.map

package/dist/src/knowledge-tracker.js

@@ -3,6 +3,7 @@ import { dirname, join } from 'node:path';
 import matter from 'gray-matter';
 import { ActionResult } from './action-result.js';
 import { ConfigParser } from './config.js';
+import { getCliName } from "./utils/cli-name.js";
 import { createDebug } from './utils/logger.js';
 const debugLog = createDebug('explorbot:knowledge-tracker');
 export class KnowledgeTracker {
@@ -63,7 +64,7 @@ export class KnowledgeTracker {
         const config = configParser.getConfig();
         const configPath = configParser.getConfigPath();
         if (!configPath) {
-            throw new Error('No explorbot configuration found. Please run "explorbot init" first.');
+            throw new Error(`No explorbot configuration found. Please run "${getCliName()} init" first.`);
         }
         const projectRoot = dirname(configPath);
         const knowledgeDir = join(projectRoot, config.dirs?.knowledge || 'knowledge');
@@ -181,4 +182,3 @@ export class KnowledgeTracker {
         return result;
     }
 }
-//# sourceMappingURL=knowledge-tracker.js.map

package/dist/src/observability.js

@@ -123,4 +123,3 @@ export const Observability = {
         return current?.span;
     },
 };
-//# sourceMappingURL=observability.js.map

package/dist/src/reporter.js

@@ -182,4 +182,3 @@ export class Reporter {
         return;
     }
 }
-//# sourceMappingURL=reporter.js.map

package/dist/src/state-manager.js

@@ -424,4 +424,3 @@ export function normalizeUrl(url) {
         return url.replace(/^\/+|\/+$/g, '');
     }
 }
-//# sourceMappingURL=state-manager.js.map

package/dist/src/stats.js

@@ -41,4 +41,3 @@ export class Stats {
         return totalTokens > 0;
     }
 }
-//# sourceMappingURL=stats.js.map

package/dist/src/test-plan.js

@@ -340,4 +340,3 @@ export class Plan {
         return planToAiContext(this, options);
     }
 }
-//# sourceMappingURL=test-plan.js.map

package/dist/src/utils/aria.js

@@ -585,4 +585,3 @@ export const compactAriaSnapshot = (snapshot, keepNamed = false) => {
     const nodes = parseAriaSnapshot(snapshot, keepNamed);
     return serializeAriaNodes(nodes);
 };
-//# sourceMappingURL=aria.js.map

package/dist/src/utils/cli-name.js

@@ -0,0 +1,16 @@
+import path from 'node:path';
+let cached;
+export function getCliName() {
+    if (cached)
+        return cached;
+    const ua = process.env.npm_config_user_agent || '';
+    if (ua.includes('bun'))
+        cached = 'bunx explorbot';
+    else if (ua.includes('npm'))
+        cached = 'npx explorbot';
+    else if (process.argv[1]?.endsWith('.ts'))
+        cached = `bun ${path.relative(process.cwd(), process.argv[1])}`;
+    else
+        cached = 'explorbot';
+    return cached;
+}

package/dist/src/utils/code-extractor.js

@@ -18,4 +18,3 @@ export function extractCodeBlocks(aiResponse) {
     }
     return codeBlocks;
 }
-//# sourceMappingURL=code-extractor.js.map

package/dist/src/utils/context-formatter.js

@@ -202,4 +202,3 @@ function formatContextFull(data) {
     }
     return lines.join('\n');
 }
-//# sourceMappingURL=context-formatter.js.map

package/dist/src/utils/error-page.js

@@ -16,4 +16,3 @@ export function isErrorPage(actionResult) {
         return true;
     return false;
 }
-//# sourceMappingURL=error-page.js.map

package/dist/src/utils/expandable.js

@@ -32,4 +32,3 @@ export function buildExpandableXPathInsideContainers(containers) {
     })
         .filter((x) => x !== null);
 }
-//# sourceMappingURL=expandable.js.map

package/dist/src/utils/hooks-runner.js

@@ -74,4 +74,3 @@ export class HooksRunner {
         }
     }
 }
-//# sourceMappingURL=hooks-runner.js.map

package/dist/src/utils/html-diff.js

@@ -731,4 +731,3 @@ function generateSummary(added, removed, similarity) {
     }
     return parts.join(', ');
 }
-//# sourceMappingURL=html-diff.js.map

package/dist/src/utils/html.js

@@ -1160,4 +1160,3 @@ export function extractTargetedHtml(html, locator) {
     }
     return '';
 }
-//# sourceMappingURL=html.js.map

package/dist/src/utils/logger.js

@@ -462,4 +462,3 @@ export const setLogCallback = registerLogPane;
 export const pluralize = (count, singular, plural) => {
     return count === 1 ? singular : plural || `${singular}s`;
 };
-//# sourceMappingURL=logger.js.map

package/dist/src/utils/loop.js

@@ -123,4 +123,3 @@ export async function loop(handler, options) {
     };
     return Observability.run(name, metadata, run);
 }
-//# sourceMappingURL=loop.js.map

package/dist/src/utils/markdown-parser.js

@@ -114,4 +114,3 @@ export function findTableLineRange(markdown) {
         return { start, end: lines.length };
     return null;
 }
-//# sourceMappingURL=markdown-parser.js.map

package/dist/src/utils/markdown-query.js

@@ -390,4 +390,3 @@ export class MarkdownQuery {
 export function mdq(source) {
     return new MarkdownQuery(source);
 }
-//# sourceMappingURL=markdown-query.js.map

package/dist/src/utils/markdown-terminal.js

@@ -37,4 +37,3 @@ export function parseMarkdownToTerminal(markdown) {
     const result = marked.parse(dedent(markdown));
     return result.replace(/^ {4}\*/gm, '*');
 }
-//# sourceMappingURL=markdown-terminal.js.map

package/dist/src/utils/research-parser.js

@@ -1,2 +1 @@
 export { RESEARCH_COLUMN_ORDER, extractContainerFromBlockquote, extractValidContainers, formatResearchSummary, mapRowToElement, parseResearchSections, rebuildSectionMarkdown, } from "../ai/researcher/parser.js";
-//# sourceMappingURL=research-parser.js.map

package/dist/src/utils/retry.js

@@ -52,4 +52,3 @@ export async function withRetry(operation, options = {}) {
     }
     throw lastError;
 }
-//# sourceMappingURL=retry.js.map

package/dist/src/utils/rules-loader.js

@@ -101,4 +101,3 @@ function loadStyleFile(agentName, name) {
     const builtInPath = join(BUILT_IN_DIR, agentName, 'styles', `${name}.md`);
     throw new Error(`Style "${name}" not found for agent "${agentName}". Searched: ${userPath}, ${builtInPath}`);
 }
-//# sourceMappingURL=rules-loader.js.map

package/dist/src/utils/strings.js

@@ -11,4 +11,3 @@ export function sanitizeFilename(name) {
         .replace(/^_+|_+$/g, '')
         .slice(0, 50);
 }
-//# sourceMappingURL=strings.js.map

package/dist/src/utils/test-plan-markdown.js

@@ -298,4 +298,3 @@ export function planToAiContext(plan, options) {
     }
     return content;
 }
-//# sourceMappingURL=test-plan-markdown.js.map

package/dist/src/utils/throttle.js

@@ -13,4 +13,3 @@ export async function throttle(fn, intervalSeconds = DEFAULT_INTERVAL_SECONDS) {
 export function __clearThrottleCacheForTests() {
     lastExecutionByKey.clear();
 }
-//# sourceMappingURL=throttle.js.map

package/dist/src/utils/unique-names.js

@@ -10,4 +10,3 @@ export function uniqSessionName() {
     const randomNum = Math.floor(Math.random() * 999);
     return `${name}${randomNum}`;
 }
-//# sourceMappingURL=unique-names.js.map

package/dist/src/utils/url-matcher.js

@@ -45,4 +45,3 @@ export function extractStatePath(url) {
         return url;
     }
 }
-//# sourceMappingURL=url-matcher.js.map

package/dist/src/utils/web-element.js

@@ -3,6 +3,7 @@ const KEY_DISPLAY_ATTRS = ['role', 'id', 'class', 'aria-label'];
 const KEY_ATTRS = ['role', 'aria-label', 'id', 'name', 'type', 'href'];
 export class WebElement {
     tag;
+    role;
     xpath;
     clickXPath;
     attrs;
@@ -12,6 +13,7 @@ export class WebElement {
     y;
     constructor(data) {
         this.tag = data.tag;
+        this.role = data.role || data.attrs.role || '';
         this.xpath = data.xpath;
         this.clickXPath = data.clickXPath;
         this.attrs = data.attrs;
@@ -33,8 +35,7 @@ export class WebElement {
         return `(${this.x}, ${this.y})`;
     }
     get eidx() {
-        const val = this.attrs['data-explorbot-eidx'] || this.attrs.eidx;
-        return val ? Number.parseInt(val, 10) : null;
+        return this.attrs['data-explorbot-eidx'] || this.attrs.eidx || null;
     }
     get isNavigationLink() {
         if (this.tag !== 'a')
@@ -46,9 +47,10 @@ export class WebElement {
         const cls = this.attrs.class || '';
         return cls.split(/\s+/).filter((c) => c.length > 2 && !isDynamicId(c) && !isGenericClass(c));
     }
-    static fromRawData(d) {
+    static fromRawData(d, role) {
         return new WebElement({
             tag: d.tag,
+            role,
             xpath: '',
             clickXPath: buildClickableXPath({ tag: d.tag, allAttrs: d.allAttrs, text: d.text }),
             attrs: d.allAttrs,
@@ -111,7 +113,7 @@ export class WebElement {
         return { totalFound: result.totalFound, elements: result.matches.map((m) => WebElement.fromXPathMatch(m)) };
     }
 }
-function extractElementData(el) {
+export function extractElementData(el) {
     const rect = el.getBoundingClientRect();
     if (rect.width === 0 && rect.height === 0)
         return null;
@@ -128,4 +130,3 @@ function extractElementData(el) {
         y: Math.round(rect.y + rect.height / 2),
     };
 }
-//# sourceMappingURL=web-element.js.map

package/dist/src/utils/xpath.js

@@ -107,4 +107,3 @@ export async function evaluateXPath(html, xpath) {
         dom.window.close();
     }
 }
-//# sourceMappingURL=xpath.js.map

package/package.json

@@ -1,14 +1,28 @@
 {
   "name": "explorbot",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "CLI app built with React Ink, CodeceptJS, and Playwright",
   "license": "Elastic-2.0",
   "type": "module",
   "main": "dist/src/index.js",
+  "exports": {
+    ".": {
+      "bun": "./src/index.tsx",
+      "import": "./dist/src/index.js"
+    }
+  },
   "bin": {
     "explorbot": "./dist/bin/explorbot-cli.js"
   },
-  "files": ["dist/", "rules/", "assets/sample-files/", "prompts/"],
+  "files": [
+    "dist/",
+    "src/**/*.ts",
+    "src/**/*.tsx",
+    "bin/**/*.ts",
+    "boat/api-tester/src/**/*.ts",
+    "rules/",
+    "assets/sample-files/"
+  ],
   "scripts": {
     "build": "bun run src/index.tsx build && bun run build:bin",
     "build:bin": "bun build bin/explorbot-cli.ts --outdir bin --target node --external commander --format esm",
@@ -35,7 +49,17 @@
     "check:fix": "biome check --write .",
     "langfuse:export": "bun run .claude/skills/explorbot-debug/langfuse-export.ts"
   },
-  "keywords": ["cli", "react", "ink", "codeceptjs", "playwright"],
+  "keywords": [
+    "cli",
+    "react",
+    "ink",
+    "codeceptjs",
+    "playwright"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/testomatio/explorbot"
+  },
   "author": "",
   "dependencies": {
     "@ai-sdk/anthropic": "^3.0",
@@ -53,7 +77,7 @@
     "@opentelemetry/sdk-trace-base": "^2.2.0",
     "@opentelemetry/semantic-conventions": "^1.38.0",
     "@scalar/openapi-parser": "^0.25.6",
-    "@testomatio/reporter": "2.7.3",
+    "@testomatio/reporter": "^2.7.6",
     "ai": "^6.0.6",
     "axe-core": "^4.11.1",
     "bash-tool": "^1.3.15",