explorbot 0.1.32-beta.1 → 0.2.1

package/src/command-handler.ts

@@ -178,7 +178,7 @@ export class CommandHandler implements InputManager {
   }
 
   private async executeBrowserCommand(input: string): Promise<void> {
-    const action = this.explorBot.getExplorer().createAction();
+    const action = this.explorBot.getExplorer().action();
     await action.execute(input);
   }
 

package/src/commands/compact-command.ts

@@ -1,12 +1,11 @@
 import { basename } from 'node:path';
 import chalk from 'chalk';
-import type { ExperienceFile } from '../ai/experience-compactor.js';
+import { COMPACT_MAX_LENGTH } from '../ai/experience-compactor.js';
+import type { ExperienceFile } from '../experience-tracker.js';
 import type { ExperienceTracker } from '../experience-tracker.js';
 import { tag } from '../utils/logger.js';
 import { BaseCommand, type Suggestion } from './base-command.js';
 
-const COMPACT_THRESHOLD = 5000;
-
 export class CompactCommand extends BaseCommand {
   name = 'compact';
   description = 'Compact stored experience files; optionally filtered by filename or URL substring';
@@ -22,7 +21,7 @@ export class CompactCommand extends BaseCommand {
     const dryRun = !!opts.dryRun;
     const merge = opts.merge !== false;
 
-    const tracker = this.explorBot.getExperienceTracker();
+    const tracker = this.explorBot.experienceTracker();
     const files = this.resolveTarget(tracker, target);
 
     if (files === null) {
@@ -62,7 +61,7 @@ export class CompactCommand extends BaseCommand {
   private buildDryRunSuggestions(compactor: ReturnType<typeof this.explorBot.agentExperienceCompactor>, files: ExperienceFile[], target?: string): Suggestion[] {
     const wouldTouch = files.filter((f) => {
       const stripped = compactor.stripNonUsefulEntries(f.content);
-      return stripped !== f.content || stripped.length >= COMPACT_THRESHOLD || compactor.isRecent(f);
+      return stripped !== f.content || stripped.length >= COMPACT_MAX_LENGTH || compactor.isRecent(f);
     });
     if (wouldTouch.length === 0) return [];
     const argsPart = target ? ` ${target}` : '';
@@ -73,7 +72,7 @@ export class CompactCommand extends BaseCommand {
   private async runFullSweep(compactor: ReturnType<typeof this.explorBot.agentExperienceCompactor>, merge: boolean): Promise<{ merged: number; compacted: number }> {
     if (!merge) {
       tag('info').log('Compacting all experience files (merge skipped)…');
-      const compacted = await compactor.compactFiles(this.explorBot.getExperienceTracker().getAllExperience());
+      const compacted = await compactor.compactFiles(this.explorBot.experienceTracker().getAllExperience());
       return { merged: 0, compacted };
     }
 
@@ -119,7 +118,7 @@ export class CompactCommand extends BaseCommand {
       const charsRemoved = chars - strippedChars;
       const willStrip = stripped !== file.content;
       const willReview = compactor.isRecent(file);
-      const willAi = strippedChars >= COMPACT_THRESHOLD;
+      const willAi = strippedChars >= COMPACT_MAX_LENGTH;
 
       if (willStrip) wouldStrip++;
       if (willReview) wouldAiReview++;
@@ -148,7 +147,7 @@ export class CompactCommand extends BaseCommand {
     lines.push(`  ${chalk.dim('Files matched:')}      ${chalk.bold(String(files.length))}`);
     lines.push(`  ${chalk.dim('Would strip:')}        ${chalk.bold(String(wouldStrip))} ${chalk.dim('(remove legacy / FAILED / Visual click, rename to FLOW/ACTION)')}`);
     lines.push(`  ${chalk.dim('Would ai-review:')}    ${chalk.bold(String(wouldAiReview))} ${chalk.dim('(recent files ≤30d — quality/reusability check)')}`);
-    lines.push(`  ${chalk.dim('Would ai-compact:')}   ${chalk.bold(String(wouldAiCompact))} ${chalk.dim(`(over ${COMPACT_THRESHOLD} chars after strip)`)}`);
+    lines.push(`  ${chalk.dim('Would ai-compact:')}   ${chalk.bold(String(wouldAiCompact))} ${chalk.dim(`(over ${COMPACT_MAX_LENGTH} chars after strip)`)}`);
     lines.push(`  ${chalk.dim('Total chars:')}        ${chalk.bold(String(totalChars))}`);
 
     tag('info').log(lines.join('\n'));

package/src/commands/context-aria-command.ts

@@ -6,7 +6,7 @@ export class ContextAriaCommand extends BaseCommand {
   description = 'Print full ARIA snapshot for current page';
 
   async execute(_args: string): Promise<void> {
-    const state = this.explorBot.getExplorer().getStateManager().getCurrentState();
+    const state = this.explorBot.stateManager().getCurrentState();
 
     if (!state) {
       throw new Error('No active page to snapshot');

package/src/commands/context-command.ts

@@ -1,9 +1,11 @@
 import { ActionResult } from '../action-result.js';
 import { Researcher } from '../ai/researcher.js';
+import { visuallyAnnotateContainers } from '../ai/researcher/coordinates.js';
 import { outputPath } from '../config.js';
 import { type ContextData, type ContextMode, formatContextSummary } from '../utils/context-formatter.js';
 import { tag } from '../utils/logger.js';
 import { extractValidContainers } from '../utils/research-parser.js';
+import { annotatePageElements } from '../utils/web-annotate.js';
 import { BaseCommand, type Suggestion } from './base-command.js';
 
 export class ContextCommand extends BaseCommand {
@@ -25,7 +27,7 @@ export class ContextCommand extends BaseCommand {
 
   async execute(args: string): Promise<void> {
     const explorer = this.explorBot.getExplorer();
-    const state = explorer.getStateManager().getCurrentState();
+    const state = this.explorBot.stateManager().getCurrentState();
 
     if (!state) {
       throw new Error('No active page to show context for');
@@ -34,17 +36,17 @@ export class ContextCommand extends BaseCommand {
     const { opts } = this.parseArgs(args);
     const isVisual = !!(opts.visual || opts.screenshot);
 
-    await explorer.annotateElements();
+    await explorer.withPage(annotatePageElements);
 
     if (isVisual) {
       const cachedResearch = Researcher.getCachedResearch(state);
       const containers = cachedResearch ? extractValidContainers(cachedResearch) : [];
-      await explorer.visuallyAnnotateElements({ containers });
+      await explorer.withPage((page) => visuallyAnnotateContainers(page, containers));
     }
 
-    const actionResult = await explorer.createAction().capturePageState({ includeScreenshot: isVisual });
-    const experienceTracker = explorer.getStateManager().getExperienceTracker();
-    const knowledgeTracker = this.explorBot.getKnowledgeTracker();
+    const actionResult = await explorer.capture({ screenshot: isVisual });
+    const experienceTracker = this.explorBot.experienceTracker();
+    const knowledgeTracker = this.explorBot.knowledgeTracker();
 
     let mode: ContextMode = 'compact';
     if (opts.full) {

package/src/commands/context-data-command.ts

@@ -8,7 +8,7 @@ export class ContextDataCommand extends BaseCommand {
 
   async execute(_args: string): Promise<void> {
     const explorer = this.explorBot.getExplorer();
-    const state = explorer.getStateManager().getCurrentState();
+    const state = this.explorBot.stateManager().getCurrentState();
 
     if (!state) {
       throw new Error('No active page to extract data from');
@@ -18,7 +18,7 @@ export class ContextDataCommand extends BaseCommand {
 
     if (!actionResult.html || actionResult.html.trim().length < 100) {
       tag('info').log('Capturing fresh page content...');
-      const freshResult = await explorer.createAction().capturePageState();
+      const freshResult = await explorer.capture();
       const table = await this.explorBot.agentResearcher().extractData(freshResult);
       tag('multiline').log(table);
       return;

package/src/commands/context-experience-command.ts

@@ -10,14 +10,14 @@ export class ContextExperienceCommand extends BaseCommand {
 
   async execute(_args: string): Promise<void> {
     const explorer = this.explorBot.getExplorer();
-    const state = explorer.getStateManager().getCurrentState();
+    const state = this.explorBot.stateManager().getCurrentState();
 
     if (!state) {
       throw new Error('No active page');
     }
 
     const actionResult = ActionResult.fromState(state);
-    const experienceTracker = explorer.getStateManager().getExperienceTracker();
+    const experienceTracker = this.explorBot.experienceTracker();
     const experience = experienceTracker.getRelevantExperience(actionResult);
 
     if (experience.length === 0) {

package/src/commands/context-html-command.ts

@@ -8,7 +8,7 @@ export class ContextHtmlCommand extends BaseCommand {
 
   async execute(_args: string): Promise<void> {
     const explorer = this.explorBot.getExplorer();
-    const manager = explorer.getStateManager();
+    const manager = this.explorBot.stateManager();
     const state = manager.getCurrentState();
 
     if (!state) {
@@ -19,7 +19,7 @@ export class ContextHtmlCommand extends BaseCommand {
 
     if (!actionResult.html || actionResult.html.trim().length < 100) {
       tag('info').log('Capturing fresh page content...');
-      actionResult = await explorer.createAction().capturePageState();
+      actionResult = await explorer.capture();
     }
 
     const html = await actionResult.combinedHtml();

package/src/commands/context-knowledge-command.ts

@@ -10,14 +10,14 @@ export class ContextKnowledgeCommand extends BaseCommand {
 
   async execute(_args: string): Promise<void> {
     const explorer = this.explorBot.getExplorer();
-    const state = explorer.getStateManager().getCurrentState();
+    const state = this.explorBot.stateManager().getCurrentState();
 
     if (!state) {
       throw new Error('No active page');
     }
 
     const actionResult = ActionResult.fromState(state);
-    const knowledgeTracker = this.explorBot.getKnowledgeTracker();
+    const knowledgeTracker = this.explorBot.knowledgeTracker();
     const knowledge = knowledgeTracker.getRelevantKnowledge(actionResult);
 
     if (knowledge.length === 0) {

package/src/commands/drill-command.ts

@@ -13,7 +13,7 @@ export class DrillCommand extends BaseCommand {
     const knowledgePath = this.parseKnowledgeArg(args);
     const maxComponents = this.parseMaxArg(args);
 
-    const state = this.explorBot.getExplorer().getStateManager().getCurrentState();
+    const state = this.explorBot.stateManager().getCurrentState();
     if (!state) {
       throw new Error('No active page to drill');
     }

package/src/commands/experience-command.ts

@@ -20,7 +20,7 @@ export class ExperienceCommand extends BaseCommand {
     }
     const recency = opts.recent ? 'recent' : opts.old ? 'old' : undefined;
 
-    const tracker = this.explorBot.getExperienceTracker();
+    const tracker = this.explorBot.experienceTracker();
     const [first, second] = remaining;
 
     const combinedRef = first?.match(/^([A-Z]+)[.\-]?(\d+)$/i);

package/src/commands/explore-command.ts

@@ -4,6 +4,7 @@ import { outputPath } from '../config.js';
 import { normalizeUrl } from '../state-manager.js';
 import { Stats } from '../stats.js';
 import { type Plan, type Test, TestResult } from '../test-plan.js';
+import { browserErrorMessage } from '../utils/browser-errors.ts';
 import { getCliName } from '../utils/cli-name.ts';
 import { ErrorPageError, getStateErrorPageError } from '../utils/error-page.ts';
 import { tag } from '../utils/logger.js';
@@ -38,7 +39,7 @@ export class ExploreCommand extends BaseCommand {
   private priorityFilter?: Set<string>;
 
   private getCurrentPageUrl(): string | undefined {
-    const state = this.explorBot.getExplorer().getStateManager().getCurrentState();
+    const state = this.explorBot.stateManager().getCurrentState();
     return state?.fullUrl || state?.url;
   }
 
@@ -56,7 +57,7 @@ export class ExploreCommand extends BaseCommand {
     Stats.mode ??= 'explore';
     Stats.focus ??= feature;
     const mainUrl = this.getCurrentPageUrl();
-    const error = getStateErrorPageError(this.explorBot.getExplorer().getStateManager().getCurrentState());
+    const error = getStateErrorPageError(this.explorBot.stateManager().getCurrentState());
     if (error) {
       tag('warning').log(error.message);
       return;
@@ -74,7 +75,7 @@ export class ExploreCommand extends BaseCommand {
       this.printResults();
       return;
     }
-    if (mainUrl) await this.explorBot.visit(mainUrl);
+    if (mainUrl) await this.explorBot.visit(mainUrl).catch((err) => tag('warning').log(`Could not return to ${mainUrl}: ${browserErrorMessage(err)}`));
     const savedPath = this.explorBot.savePlans(this.completedPlans);
     this.printResults();
     await this.explorBot.printSessionAnalysis();

package/src/commands/freesail-command.ts

@@ -35,7 +35,7 @@ export class FreesailCommand extends BaseCommand {
       async (ctx) => {
         if (maxTests != null && testsRun >= maxTests) ctx.stop();
 
-        const stateManager = this.explorBot.getExplorer().getStateManager();
+        const stateManager = this.explorBot.stateManager();
         const state = stateManager.getCurrentState();
 
         if (state && !Researcher.getCachedResearch(state)) {
@@ -70,7 +70,7 @@ export class FreesailCommand extends BaseCommand {
         }
 
         tag('info').log(`Navigating to: ${suggestion.target} - ${suggestion.reason}`);
-        await this.explorBot.openFreshTab();
+        await this.explorBot.openTab();
         await this.explorBot.visit(suggestion.target);
         this.explorBot.clearPlan();
       },

package/src/commands/knows-command.ts

@@ -23,7 +23,7 @@ export class KnowsCommand extends BaseCommand {
 
   async execute(args: string, limit = 0): Promise<void> {
     const url = args.trim();
-    const tracker = this.explorBot.getKnowledgeTracker();
+    const tracker = this.explorBot.knowledgeTracker();
 
     if (!url) {
       const allKnowledge = tracker.listAllKnowledge();

package/src/commands/learn-command.ts

@@ -13,12 +13,14 @@ export class LearnCommand extends BaseCommand {
 
     if (!note) {
       const AddKnowledge = (await import('../components/AddKnowledge.js')).default;
-      const state = this.explorBot.getExplorer().getStateManager().getCurrentState();
+      const explorer = this.explorBot.getExplorer();
+      const state = this.explorBot.stateManager().getCurrentState();
       const initialUrl = state?.url || '';
 
       const { unmount } = render(
         React.createElement(AddKnowledge, {
           initialUrl,
+          knowledgeTracker: this.explorBot.knowledgeTracker(),
           onComplete: () => unmount(),
           onCancel: () => unmount(),
         }),
@@ -31,14 +33,14 @@ export class LearnCommand extends BaseCommand {
     }
 
     const explorer = this.explorBot.getExplorer();
-    const state = explorer.getStateManager().getCurrentState();
+    const state = this.explorBot.stateManager().getCurrentState();
 
     if (!state) {
       throw new Error('No active page to attach knowledge');
     }
 
     const targetUrl = state.url || state.fullUrl || '/';
-    explorer.getKnowledgeTracker().addKnowledge(targetUrl, note);
+    this.explorBot.knowledgeTracker().addKnowledge(targetUrl, note);
     tag('success').log('Knowledge saved for current page');
   }
 }

package/src/commands/path-command.ts

@@ -16,7 +16,7 @@ export class PathCommand extends BaseCommand {
   async execute(args: string): Promise<void> {
     const { opts } = this.parseArgs(args);
     const showLinks = !!opts.links;
-    const stateManager = this.explorBot.getExplorer().getStateManager();
+    const stateManager = this.explorBot.stateManager();
     const history = stateManager.getStateHistory();
 
     if (history.length === 0) {

package/src/commands/research-command.ts

@@ -27,7 +27,7 @@ export class ResearchCommand extends BaseCommand {
       await this.explorBot.agentNavigator().visit(target);
     }
 
-    const state = this.explorBot.getExplorer().getStateManager().getCurrentState();
+    const state = this.explorBot.stateManager().getCurrentState();
     if (!state) {
       throw new Error('No active page to research');
     }

package/src/commands/test-command.ts

@@ -48,7 +48,7 @@ export class TestCommand extends BaseCommand {
       if (matching.length > 0) {
         toExecute.push(...matching);
       } else {
-        const state = this.explorBot.getExplorer().getStateManager().getCurrentState();
+        const state = this.explorBot.stateManager().getCurrentState();
         if (!state) {
           throw new Error('No page loaded. Please navigate to a page first.');
         }

package/src/components/AddKnowledge.tsx

@@ -1,15 +1,16 @@
 import { Box, Text, useInput } from 'ink';
 import React, { useEffect, useState } from 'react';
-import { KnowledgeTracker } from '../knowledge-tracker.js';
+import type { KnowledgeTracker } from '../knowledge-tracker.js';
 import InputReadline from './InputReadline.js';
 
 interface AddKnowledgeProps {
   initialUrl?: string;
+  knowledgeTracker: KnowledgeTracker;
   onComplete?: () => void;
   onCancel?: () => void;
 }
 
-const AddKnowledge: React.FC<AddKnowledgeProps> = ({ initialUrl = '', onComplete, onCancel }) => {
+const AddKnowledge: React.FC<AddKnowledgeProps> = ({ initialUrl = '', knowledgeTracker, onComplete, onCancel }) => {
   const [urlPattern, setUrlPattern] = useState(initialUrl);
   const [description, setDescription] = useState('');
   const [activeField, setActiveField] = useState<'url' | 'description'>(initialUrl ? 'description' : 'url');
@@ -20,18 +21,16 @@ const AddKnowledge: React.FC<AddKnowledgeProps> = ({ initialUrl = '', onComplete
 
   useEffect(() => {
     try {
-      const knowledgeTracker = new KnowledgeTracker();
       const urls = knowledgeTracker.getExistingUrls();
       setSuggestedUrls(urls);
     } catch (error) {
       console.error('Failed to load suggestions:', error);
     }
-  }, []);
+  }, [knowledgeTracker]);
 
   useEffect(() => {
     if (urlPattern.trim()) {
       try {
-        const knowledgeTracker = new KnowledgeTracker();
         const knowledge = knowledgeTracker.getKnowledgeForUrl(urlPattern);
         setExistingKnowledge(knowledge);
       } catch (error) {
@@ -41,7 +40,7 @@ const AddKnowledge: React.FC<AddKnowledgeProps> = ({ initialUrl = '', onComplete
     } else {
       setExistingKnowledge([]);
     }
-  }, [urlPattern]);
+  }, [urlPattern, knowledgeTracker]);
 
   const handleSave = () => {
     if (!urlPattern.trim() || !description.trim()) {
@@ -49,7 +48,6 @@ const AddKnowledge: React.FC<AddKnowledgeProps> = ({ initialUrl = '', onComplete
     }
 
     try {
-      const knowledgeTracker = new KnowledgeTracker();
       const result = knowledgeTracker.addKnowledge(urlPattern.trim(), description.trim());
       const action = result.isNewFile ? 'Created' : 'Updated';
       console.log(`\nKnowledge ${action} in: ${result.filename}`);

package/src/components/App.tsx

@@ -68,7 +68,7 @@ export function App({ explorBot, initialShowInput = false, exitOnEmptyInput = fa
       });
     });
 
-    const manager = explorBot.getExplorer().getStateManager();
+    const manager = explorBot.stateManager();
 
     unsubscribe = manager.onStateChange((transition: StateTransition) => {
       if (mounted) {
@@ -142,7 +142,7 @@ export function App({ explorBot, initialShowInput = false, exitOnEmptyInput = fa
       if (!mounted) return;
       setChecklistData({
         config: explorBot.getConfig(),
-        knowledgeTracker: explorBot.getKnowledgeTracker(),
+        knowledgeTracker: explorBot.knowledgeTracker(),
       });
       setShowWelcome(true);
       setShowInput(true);
@@ -334,7 +334,7 @@ export function App({ explorBot, initialShowInput = false, exitOnEmptyInput = fa
         {showSessionTimer && <SessionTimer startedAt={sessionStartedAtRef.current} />}
       </Box>
 
-      {showWelcome && <WelcomeCommands hasKnowledge={explorBot.getKnowledgeTracker().listAllKnowledge().length > 0} />}
+      {showWelcome && <WelcomeCommands hasKnowledge={explorBot.knowledgeTracker().listAllKnowledge().length > 0} />}
       {showInput && <Box height={1} />}
       {interruptPrompt && showInput && (
         <Box paddingX={1}>