explorbot 0.0.1 → 0.1.0

package/dist/src/api/request-result.js

@@ -174,4 +174,3 @@ export class RequestResult {
         return cmd;
     }
 }
-//# sourceMappingURL=request-result.js.map

package/dist/src/api/request-store.js

@@ -106,4 +106,3 @@ export class RequestStore {
 function normalizePathPattern(urlPath) {
     return urlPath.replace(/\/[0-9a-f]{24}\b/g, '/{id}').replace(/\/\d+\b/g, '/{id}');
 }
-//# sourceMappingURL=request-store.js.map

package/dist/src/api/spec-reader.js

@@ -145,4 +145,3 @@ function matchesEndpoint(specPath, endpoint) {
         return true;
     return false;
 }
-//# sourceMappingURL=spec-reader.js.map

package/dist/src/api/xhr-capture.js

@@ -88,4 +88,3 @@ export class XhrCapture {
         this.store.addCapturedRequest(result);
     }
 }
-//# sourceMappingURL=xhr-capture.js.map

package/dist/src/browser-server.js

@@ -64,4 +64,3 @@ async function getAliveEndpoint() {
     return null;
 }
 export { readEndpoint, removeEndpointFile, isServerRunning, launchServer, getEndpointFilePath, getAliveEndpoint };
-//# sourceMappingURL=browser-server.js.map

package/dist/src/command-handler.js

@@ -360,4 +360,3 @@ export class CommandHandler {
         return 0;
     }
 }
-//# sourceMappingURL=command-handler.js.map

package/dist/src/commands/add-rule-command.js

@@ -49,4 +49,3 @@ export class AddRuleCommand extends BaseCommand {
         return filePath;
     }
 }
-//# sourceMappingURL=add-rule-command.js.map

package/dist/src/commands/base-command.js

@@ -11,4 +11,3 @@ export class BaseCommand {
         return this.name === commandName || this.aliases.includes(commandName);
     }
 }
-//# sourceMappingURL=base-command.js.map

package/dist/src/commands/clean-command.js

@@ -64,4 +64,3 @@ export class CleanCommand extends BaseCommand {
         tag('success').log(`Cleaned ${count} ${target.description} files from ${dir}`);
     }
 }
-//# sourceMappingURL=clean-command.js.map

package/dist/src/commands/context-aria-command.js

@@ -15,4 +15,3 @@ export class ContextAriaCommand extends BaseCommand {
         tag('multiline').log(`ARIA Snapshot:\n\n${ariaSnapshot}`);
     }
 }
-//# sourceMappingURL=context-aria-command.js.map

package/dist/src/commands/context-command.js

@@ -15,13 +15,13 @@ export class ContextCommand extends BaseCommand {
             throw new Error('No active page to show context for');
         }
         const isVisual = args.includes('--visual') || args.includes('--screenshot');
-        await explorer.annotateElements();
+        const { ariaSnapshot } = await explorer.annotateElements();
         if (isVisual) {
             const cachedResearch = Researcher.getCachedResearch(state);
             const containers = cachedResearch ? extractValidContainers(cachedResearch) : [];
             await explorer.visuallyAnnotateElements({ containers });
         }
-        const actionResult = await explorer.createAction().capturePageState({ includeScreenshot: isVisual });
+        const actionResult = await explorer.createAction().capturePageState({ includeScreenshot: isVisual, ariaSnapshot });
         const experienceTracker = explorer.getStateManager().getExperienceTracker();
         const knowledgeTracker = this.explorBot.getKnowledgeTracker();
         let mode = 'compact';
@@ -54,4 +54,3 @@ export class ContextCommand extends BaseCommand {
         }
     }
 }
-//# sourceMappingURL=context-command.js.map

package/dist/src/commands/context-data-command.js

@@ -22,4 +22,3 @@ export class ContextDataCommand extends BaseCommand {
         tag('multiline').log(table);
     }
 }
-//# sourceMappingURL=context-data-command.js.map

package/dist/src/commands/context-experience-command.js

@@ -38,4 +38,3 @@ export class ContextExperienceCommand extends BaseCommand {
         tag('multiline').log(lines.join('\n'));
     }
 }
-//# sourceMappingURL=context-experience-command.js.map

package/dist/src/commands/context-html-command.js

@@ -23,4 +23,3 @@ export class ContextHtmlCommand extends BaseCommand {
         tag('html').log(html);
     }
 }
-//# sourceMappingURL=context-html-command.js.map

package/dist/src/commands/context-knowledge-command.js

@@ -33,4 +33,3 @@ export class ContextKnowledgeCommand extends BaseCommand {
         tag('multiline').log(lines.join('\n'));
     }
 }
-//# sourceMappingURL=context-knowledge-command.js.map

package/dist/src/commands/debug-command.js

@@ -9,4 +9,3 @@ export class DebugCommand extends BaseCommand {
         tag('info').log(`Debug mode ${enabled ? 'enabled' : 'disabled'}`);
     }
 }
-//# sourceMappingURL=debug-command.js.map

package/dist/src/commands/drill-command.js

@@ -26,4 +26,3 @@ export class DrillCommand extends BaseCommand {
         return match ? Number.parseInt(match[1], 10) : undefined;
     }
 }
-//# sourceMappingURL=drill-command.js.map

package/dist/src/commands/exit-command.js

@@ -23,4 +23,3 @@ export class ExitCommand extends BaseCommand {
         process.exit(0);
     }
 }
-//# sourceMappingURL=exit-command.js.map

package/dist/src/commands/explore-command.js

@@ -1,6 +1,7 @@
 import figureSet from 'figures';
 import path from 'node:path';
 import { getStyles } from '../ai/planner/styles.js';
+import { getCliName } from "../utils/cli-name.js";
 import { jsonToTable } from '../utils/markdown-parser.js';
 import { tag } from '../utils/logger.js';
 import { BaseCommand } from './base-command.js';
@@ -71,7 +72,7 @@ export class ExploreCommand extends BaseCommand {
         }
     }
     printResults(savedPath) {
-        const allTests = this.completedPlans.flatMap((plan) => plan.tests.filter((t) => t.status !== 'pending').map((test) => ({ test, planTitle: plan.title })));
+        const allTests = this.completedPlans.flatMap((plan) => plan.tests.filter((t) => t.startTime != null).map((test) => ({ test, planTitle: plan.title })));
         if (allTests.length === 0)
             return;
         const hasSubPages = this.completedPlans.length > 1;
@@ -103,7 +104,7 @@ export class ExploreCommand extends BaseCommand {
         tag('info').log(`${figureSet.tick} ${allTests.length} tests completed`);
         if (savedPath) {
             const relativePath = path.relative(process.cwd(), savedPath);
-            tag('info').log(`Re-run tests: explorbot test ${relativePath} <index>`);
+            tag('info').log(`Re-run tests: ${getCliName()} test ${relativePath} <index>`);
         }
     }
     isLimitReached() {
@@ -121,4 +122,3 @@ export class ExploreCommand extends BaseCommand {
         }
     }
 }
-//# sourceMappingURL=explore-command.js.map

package/dist/src/commands/freesail-command.js

@@ -81,4 +81,3 @@ function parseArgs(args) {
     }
     return { strategy, scope, maxTests };
 }
-//# sourceMappingURL=freesail-command.js.map

package/dist/src/commands/help-command.js

@@ -4,4 +4,3 @@ export class HelpCommand extends BaseCommand {
     description = 'Show available commands';
     async execute(_args) { }
 }
-//# sourceMappingURL=help-command.js.map

package/dist/src/commands/index.js

@@ -60,4 +60,3 @@ const commandClasses = [
 export function createCommands(explorBot) {
     return commandClasses.map((Cmd) => new Cmd(explorBot));
 }
-//# sourceMappingURL=index.js.map

package/dist/src/commands/init-command.js

@@ -0,0 +1,117 @@
+import { existsSync, mkdirSync, statSync, writeFileSync } from 'node:fs';
+import { dirname, extname, join, resolve } from 'node:path';
+import { log, tag } from '../utils/logger.js';
+import dedent from 'dedent';
+import chalk from 'chalk';
+import { getCliName } from "../utils/cli-name.js";
+const DEFAULT_CONFIG_TEMPLATE = `import { createOpenRouter } from '@openrouter/ai-sdk-provider';
+// import { '<your provider here>' } from '<your provider package here>';
+
+// Vercel AI SDK is used to connect to AI providers.
+// Bring your own provider or use OpenRouter (one API key, many providers).
+// https://github.com/testomatio/explorbot/blob/main/docs/providers.md
+const openrouter = createOpenRouter({
+  apiKey: process.env.OPENROUTER_API_KEY,
+});
+
+const config = {
+  web: {
+    // use application host without path prefix (e.g., http://localhost:3000)
+    url: 'http://<your-app-host-here>',
+  },
+
+  ai: {
+    // fast model with tool calling capabilities
+    model: openrouter('<your base model here>'),
+    // vision model for screenshot analysis
+    visionModel: openrouter('<your vision model here>'),
+    // agentic model for decision making
+    agenticModel: openrouter('<your agentic model here>'),
+  },
+};
+
+export default config;
+`;
+const DEFAULT_ENV_TEMPLATE = dedent `
+# AI provider API keys
+OPENROUTER_API_KEY=
+
+# OPENAI_API_KEY=
+# ANTHROPIC_API_KEY=
+# GROQ_API_KEY=
+
+# Langfuse Tracing
+LANGFUSE_SECRET_KEY=
+LANGFUSE_PUBLIC_KEY=
+LANGFUSE_BASE_URL=
+
+# Testomat.io API key to publish run results
+TESTOMATIO=
+`;
+export function runInitCommand(options) {
+    const configPath = options.configPath ?? './explorbot.config.js';
+    const force = options.force ?? false;
+    const customPath = options.path;
+    const originalCwd = process.cwd();
+    if (customPath) {
+        const dir = resolve(customPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+            log(`Created directory: ${dir}`);
+        }
+        process.chdir(dir);
+        log(`Working in directory: ${dir}`);
+    }
+    try {
+        let outPath = resolve(configPath);
+        if (existsSync(outPath) && statSync(outPath).isDirectory()) {
+            outPath = join(outPath, 'explorbot.config.js');
+        }
+        else if (!extname(outPath)) {
+            outPath = join(outPath, 'explorbot.config.js');
+        }
+        const dir = dirname(outPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+            log(`Created directory: ${dir}`);
+        }
+        if (existsSync(outPath) && !force) {
+            log(`Config file already exists: ${outPath}`);
+            log('Use --force to overwrite existing file');
+            process.exit(1);
+        }
+        writeFileSync(outPath, DEFAULT_CONFIG_TEMPLATE, 'utf8');
+        log(`Created config file: ${outPath}`);
+        const envPath = resolve(process.cwd(), '.env');
+        if (!existsSync(envPath)) {
+            writeFileSync(envPath, `${DEFAULT_ENV_TEMPLATE}\n`, 'utf8');
+            log(`Created env file: ${envPath}`);
+        }
+        else {
+            log(`Env file already exists: ${envPath}`);
+        }
+        log('');
+        log('Next steps:');
+        log('1. Configure AI provider in .env');
+        log('2. Set AI models config file');
+        log('3. Set web application URL in the config file');
+        log('4. Add initial knowledge (how to authorize to the application, etc.)');
+        tag('substep').log(chalk.yellow(`${getCliName()} learn * 'to aurhorize use these credentials: admin@example.com / secret123'`));
+        tag('substep').log('You can use ${env.LOGIN} and ${env.PASSWORD} to reference environment variables.');
+        log('5. Launch application on a relative URL');
+        tag('substep').log(chalk.yellow(`${getCliName()} start /dashboard`));
+        if (!existsSync('./output')) {
+            mkdirSync('./output', { recursive: true });
+            log('Created directory: ./output');
+        }
+    }
+    catch (error) {
+        log('Failed to create config file:', error);
+        process.exit(1);
+    }
+    finally {
+        if (process.cwd() !== originalCwd) {
+            process.chdir(originalCwd);
+        }
+    }
+}

package/dist/src/commands/knows-command.js

@@ -51,4 +51,3 @@ export class KnowsCommand extends BaseCommand {
         tag('multiline').log(`Found ${matching.length} matching knowledge entries for: ${url}\n\n${formatKnowledgeList(knowledgeList)}`);
     }
 }
-//# sourceMappingURL=knows-command.js.map

package/dist/src/commands/learn-command.js

@@ -32,4 +32,3 @@ export class LearnCommand extends BaseCommand {
         tag('success').log('Knowledge saved for current page');
     }
 }
-//# sourceMappingURL=learn-command.js.map

package/dist/src/commands/navigate-command.js

@@ -13,4 +13,3 @@ export class NavigateCommand extends BaseCommand {
         tag('success').log(`Navigation requested: ${destination}`);
     }
 }
-//# sourceMappingURL=navigate-command.js.map

package/dist/src/commands/path-command.js

@@ -67,4 +67,3 @@ export class PathCommand extends BaseCommand {
         tag('multiline').log(lines.join('\n'));
     }
 }
-//# sourceMappingURL=path-command.js.map

package/dist/src/commands/plan-clear-command.js

@@ -10,4 +10,3 @@ export class PlanClearCommand extends BaseCommand {
         await this.explorBot.plan(args.trim() || undefined, { fresh: true });
     }
 }
-//# sourceMappingURL=plan-clear-command.js.map

package/dist/src/commands/plan-command.js

@@ -8,17 +8,22 @@ export class PlanCommand extends BaseCommand {
         { flags: '--fresh', description: 'Regenerate plan from scratch' },
         { flags: '--clear', description: 'Clear plan before regenerating' },
         { flags: '--style <name>', description: 'Planning style (normal, curious, psycho, performer)' },
+        { flags: '--focus <feature>', description: 'Focus area for test planning' },
     ];
     async execute(args) {
         const clear = args.includes('--clear');
         const fresh = args.includes('--fresh') || clear;
         const styleMatch = args.match(/--style\s+(\S+)/);
         const style = styleMatch?.[1];
-        const focus = args
+        const focusMatch = args.match(/--focus\s+("[^"]+"|'[^']+'|\S+)/);
+        const focusFromFlag = focusMatch?.[1]?.replace(/^["']|["']$/g, '');
+        const focusFromText = args
             .replace('--clear', '')
             .replace('--fresh', '')
             .replace(/--style\s+\S+/, '')
+            .replace(/--focus\s+("[^"]+"|'[^']+'|\S+)/, '')
             .trim();
+        const focus = focusFromFlag || focusFromText;
         if (clear) {
             this.explorBot.clearPlan();
             tag('success').log('Plan cleared');
@@ -33,4 +38,3 @@ export class PlanCommand extends BaseCommand {
         }
     }
 }
-//# sourceMappingURL=plan-command.js.map

package/dist/src/commands/plan-edit-command.js

@@ -5,4 +5,3 @@ export class PlanEditCommand extends BaseCommand {
     suggestions = ['/plan:edit - toggle tests on/off'];
     async execute(_args) { }
 }
-//# sourceMappingURL=plan-edit-command.js.map

package/dist/src/commands/plan-load-command.js

@@ -13,4 +13,3 @@ export class PlanLoadCommand extends BaseCommand {
         tag('success').log(`Plan loaded: ${plan.title} with ${plan.tests.length} tests`);
     }
 }
-//# sourceMappingURL=plan-load-command.js.map

package/dist/src/commands/plan-reload-command.js

@@ -20,4 +20,3 @@ export class PlanReloadCommand extends BaseCommand {
         tag('success').log(`Plan regenerated with ${plan.tests.length} tests`);
     }
 }
-//# sourceMappingURL=plan-reload-command.js.map

package/dist/src/commands/plan-save-command.js

@@ -19,4 +19,3 @@ export class PlanSaveCommand extends BaseCommand {
         }
     }
 }
-//# sourceMappingURL=plan-save-command.js.map

package/dist/src/commands/research-command.js

@@ -35,4 +35,3 @@ export class ResearchCommand extends BaseCommand {
         }
     }
 }
-//# sourceMappingURL=research-command.js.map

package/dist/src/commands/start-command.js

@@ -9,4 +9,3 @@ export class StartCommand extends BaseCommand {
         await new ExploreCommand(this.explorBot).execute(args);
     }
 }
-//# sourceMappingURL=start-command.js.map

package/dist/src/commands/status-command.js

@@ -16,4 +16,3 @@ export class StatusCommand extends BaseCommand {
         });
     }
 }
-//# sourceMappingURL=status-command.js.map

package/dist/src/commands/test-command.js

@@ -82,4 +82,3 @@ function parseTestIndices(input, total) {
     }
     return [...indices].sort((a, b) => a - b);
 }
-//# sourceMappingURL=test-command.js.map

package/dist/src/components/ActivityPane.js

@@ -52,4 +52,3 @@ const ActivityPane = React.memo(({ isInputVisible = false }) => {
             getDots())));
 });
 export default ActivityPane;
-//# sourceMappingURL=ActivityPane.js.map

package/dist/src/components/AddKnowledge.js

@@ -119,4 +119,3 @@ const AddKnowledge = ({ initialUrl = '', onComplete, onCancel }) => {
                 ": Exit"))));
 };
 export default AddKnowledge;
-//# sourceMappingURL=AddKnowledge.js.map

package/dist/src/components/AddRule.js

@@ -114,4 +114,3 @@ const AddRule = ({ initialAgent = '', initialName = '', onComplete, onCancel })
                 ": Exit"))));
 };
 export default AddRule;
-//# sourceMappingURL=AddRule.js.map

package/dist/src/components/App.js

@@ -310,4 +310,3 @@ export function App({ explorBot, initialShowInput = false, exitOnEmptyInput = fa
             React.createElement(Autocomplete, null)),
         React.createElement(PlanPane, { completedPlans: completedPlans, activePlan: activePlanInfo })));
 }
-//# sourceMappingURL=App.js.map

package/dist/src/components/Autocomplete.js

@@ -40,4 +40,3 @@ const Autocomplete = () => {
     }))))));
 };
 export default Autocomplete;
-//# sourceMappingURL=Autocomplete.js.map

package/dist/src/components/InputPane.js

@@ -204,4 +204,3 @@ const InputPane = ({ commandHandler, exitOnEmptyInput = false, onSubmit, onComma
             }, visible: showAutocomplete })));
 };
 export default InputPane;
-//# sourceMappingURL=InputPane.js.map

package/dist/src/components/InputReadline.js

@@ -595,4 +595,3 @@ const InputReadline = React.memo(({ commandHandler, exitOnEmptyInput = false, on
     })));
 });
 export default InputReadline;
-//# sourceMappingURL=InputReadline.js.map

package/dist/src/components/LogPane.js

@@ -120,4 +120,3 @@ const LogPane = React.memo(({ verboseMode }) => {
     return React.createElement(Box, { flexDirection: "column" }, visibleLogs.map((log, index) => renderLogEntry(log, index)).filter(Boolean));
 });
 export default LogPane;
-//# sourceMappingURL=LogPane.js.map

package/dist/src/components/PlanEditor.js

@@ -123,4 +123,3 @@ const PlanEditor = ({ tasks, onClose, isActive }) => {
                 " enabled"))));
 };
 export default PlanEditor;
-//# sourceMappingURL=PlanEditor.js.map

package/dist/src/components/PlanPane.js

@@ -48,4 +48,3 @@ function formatStats(plan) {
     return parts.join(' ');
 }
 export default PlanPane;
-//# sourceMappingURL=PlanPane.js.map

package/dist/src/components/SessionTimer.js

@@ -23,4 +23,3 @@ const SessionTimer = ({ startedAt }) => {
             pad(seconds))));
 };
 export default SessionTimer;
-//# sourceMappingURL=SessionTimer.js.map

package/dist/src/components/StateTransitionPane.js

@@ -104,4 +104,3 @@ const StateTransitionPane = ({ transition, currentState }) => {
                     React.createElement(Text, { color: "green" }, diff.to))))))));
 };
 export default StateTransitionPane;
-//# sourceMappingURL=StateTransitionPane.js.map

package/dist/src/components/StatusPane.js

@@ -34,4 +34,3 @@ export const StatusPane = ({ onComplete }) => {
             React.createElement(Row, { label: "Time", value: Stats.getElapsedTime() }),
             tokenRows.map(([model, tokens]) => (React.createElement(Row, { key: model, label: model, value: `${Stats.humanizeTokens(tokens.total)} tokens` })))))));
 };
-//# sourceMappingURL=StatusPane.js.map

package/dist/src/components/TaskPane.js

@@ -93,4 +93,3 @@ const TaskPane = React.memo(({ tasks, scrollOffset = 0 }) => {
                 " more")))));
 });
 export default TaskPane;
-//# sourceMappingURL=TaskPane.js.map

package/dist/src/components/Welcome.js

@@ -49,4 +49,3 @@ const Welcome = () => {
                 React.createElement(Text, { color: "cyan", bold: true }, configInfo.playwrightUrl))))));
 };
 export default Welcome;
-//# sourceMappingURL=Welcome.js.map

package/dist/src/components/WelcomeChecklist.js

@@ -93,4 +93,3 @@ const WelcomeChecklist = ({ config, knowledgeTracker }) => {
         items.map((item, index) => (React.createElement(ChecklistRow, { key: index, item: item })))));
 };
 export default WelcomeChecklist;
-//# sourceMappingURL=WelcomeChecklist.js.map

package/dist/src/components/WelcomeCommands.js

@@ -58,4 +58,3 @@ const WelcomeCommands = ({ hasKnowledge }) => {
                 React.createElement(Text, { color: "gray", dimColor: true }, cmd.examples.join('  '))))))))));
 };
 export default WelcomeCommands;
-//# sourceMappingURL=WelcomeCommands.js.map

package/dist/src/components/autocomplete-store.js

@@ -19,4 +19,3 @@ export const setAutocompleteState = (next) => {
     }
 };
 export const useAutocompleteState = () => useSyncExternalStore(subscribe, getSnapshot);
-//# sourceMappingURL=autocomplete-store.js.map

package/dist/src/components/parse-keypress.js

@@ -171,4 +171,3 @@ export default function parseKeypress(value = '') {
     }
     return key;
 }
-//# sourceMappingURL=parse-keypress.js.map

package/dist/src/config.js

@@ -246,4 +246,3 @@ export class ConfigParser {
 export function outputPath(...segments) {
     return path.join(ConfigParser.getInstance().getOutputDir(), ...segments);
 }
-//# sourceMappingURL=config.js.map

package/dist/src/execution-controller.js

@@ -89,4 +89,3 @@ export class ExecutionController extends EventEmitter {
     }
 }
 export const executionController = ExecutionController.getInstance();
-//# sourceMappingURL=execution-controller.js.map

package/dist/src/experience-tracker.js

@@ -291,4 +291,3 @@ ${filteredCode}
         return results;
     }
 }
-//# sourceMappingURL=experience-tracker.js.map

package/dist/src/explorbot.js

@@ -84,7 +84,7 @@ export class ExplorBot {
         await this.explorer.openFreshTab();
     }
     getCurrentState() {
-        return this.explorer.getStateManager().getCurrentState();
+        return this.explorer?.getStateManager().getCurrentState() ?? null;
     }
     getExplorer() {
         return this.explorer;
@@ -345,4 +345,3 @@ export class ExplorBot {
         this.currentPlan = plan;
     }
 }
-//# sourceMappingURL=explorbot.js.map