explorbot 0.1.31 → 0.1.32-beta.1

package/dist/src/commands/freesail-command.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from './base-command.js';
+export declare class FreesailCommand extends BaseCommand {
+    name: string;
+    description: string;
+    aliases: string[];
+    tuiEnabled: boolean;
+    options: {
+        flags: string;
+        description: string;
+    }[];
+    execute(args: string): Promise<void>;
+}

package/dist/src/commands/help-command.d.ts

@@ -0,0 +1,6 @@
+import { BaseCommand } from './base-command.js';
+export declare class HelpCommand extends BaseCommand {
+    name: string;
+    description: string;
+    execute(_args: string): Promise<void>;
+}

package/dist/src/commands/index.d.ts

@@ -0,0 +1,4 @@
+import type { ExplorBot } from '../explorbot.js';
+import type { BaseCommand } from './base-command.js';
+export { BaseCommand } from './base-command.js';
+export declare function createCommands(explorBot: ExplorBot): BaseCommand[];

package/dist/src/commands/init-command.d.ts

@@ -0,0 +1,7 @@
+export declare function runInitCommand(options: InitCommandOptions): void;
+type InitCommandOptions = {
+    configPath?: string;
+    force?: boolean;
+    path?: string;
+};
+export {};

package/dist/src/commands/knows-command.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from './base-command.js';
+export declare function formatKnowledgeList(knowledge: Array<{
+    url: string;
+    firstLine: string;
+}>, limit?: number): string;
+export declare class KnowsCommand extends BaseCommand {
+    name: string;
+    description: string;
+    execute(args: string, limit?: number): Promise<void>;
+}

package/dist/src/commands/learn-command.d.ts

@@ -0,0 +1,7 @@
+import { BaseCommand, type Suggestion } from './base-command.js';
+export declare class LearnCommand extends BaseCommand {
+    name: string;
+    description: string;
+    suggestions: Suggestion[];
+    execute(args: string): Promise<void>;
+}

package/dist/src/commands/navigate-command.d.ts

@@ -0,0 +1,7 @@
+import { BaseCommand, type Suggestion } from './base-command.js';
+export declare class NavigateCommand extends BaseCommand {
+    name: string;
+    description: string;
+    suggestions: Suggestion[];
+    execute(args: string): Promise<void>;
+}

package/dist/src/commands/path-command.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from './base-command.js';
+export declare class PathCommand extends BaseCommand {
+    name: string;
+    description: string;
+    options: {
+        flags: string;
+        description: string;
+    }[];
+    execute(args: string): Promise<void>;
+}

package/dist/src/commands/plan-clear-command.d.ts

@@ -0,0 +1,7 @@
+import { BaseCommand, type Suggestion } from './base-command.js';
+export declare class PlanClearCommand extends BaseCommand {
+    name: string;
+    description: string;
+    suggestions: Suggestion[];
+    execute(args: string): Promise<void>;
+}

package/dist/src/commands/plan-command.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand, type Suggestion } from './base-command.js';
+export declare class PlanCommand extends BaseCommand {
+    name: string;
+    description: string;
+    suggestions: Suggestion[];
+    options: {
+        flags: string;
+        description: string;
+    }[];
+    execute(args: string): Promise<void>;
+    printNextSteps(): void;
+    printPlanSummary(): void;
+    updateSuggestions(): void;
+}

package/dist/src/commands/plan-edit-command.d.ts

@@ -0,0 +1,7 @@
+import { BaseCommand, type Suggestion } from './base-command.js';
+export declare class PlanEditCommand extends BaseCommand {
+    name: string;
+    description: string;
+    suggestions: Suggestion[];
+    execute(_args: string): Promise<void>;
+}

package/dist/src/commands/plan-load-command.d.ts

@@ -0,0 +1,7 @@
+import { BaseCommand, type Suggestion } from './base-command.js';
+export declare class PlanLoadCommand extends BaseCommand {
+    name: string;
+    description: string;
+    suggestions: Suggestion[];
+    execute(args: string): Promise<void>;
+}

package/dist/src/commands/plan-reload-command.d.ts

@@ -0,0 +1,7 @@
+import { BaseCommand, type Suggestion } from './base-command.js';
+export declare class PlanReloadCommand extends BaseCommand {
+    name: string;
+    description: string;
+    suggestions: Suggestion[];
+    execute(args: string): Promise<void>;
+}

package/dist/src/commands/plan-save-command.d.ts

@@ -0,0 +1,7 @@
+import { BaseCommand, type Suggestion } from './base-command.js';
+export declare class PlanSaveCommand extends BaseCommand {
+    name: string;
+    description: string;
+    suggestions: Suggestion[];
+    execute(args: string): Promise<void>;
+}

package/dist/src/commands/plans-command.d.ts

@@ -0,0 +1,21 @@
+import { Plan } from '../test-plan.js';
+import { BaseCommand } from './base-command.js';
+export declare class PlansCommand extends BaseCommand {
+    name: string;
+    description: string;
+    options: {
+        flags: string;
+        description: string;
+    }[];
+    execute(args: string): Promise<void>;
+    getPlanFiles(): PlanFile[];
+    printPlans(files: PlanFile[]): void;
+    printPlanDetails(plan: Plan, file: PlanFile): void;
+    resolvePlanFile(target: string, files: PlanFile[]): PlanFile;
+}
+interface PlanFile {
+    name: string;
+    path: string;
+    modifiedAt: number;
+}
+export {};

package/dist/src/commands/rerun-command.d.ts

@@ -0,0 +1,7 @@
+import { BaseCommand } from './base-command.js';
+export declare class RerunCommand extends BaseCommand {
+    name: string;
+    description: string;
+    tuiEnabled: boolean;
+    execute(args: string): Promise<void>;
+}

package/dist/src/commands/research-command.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand, type Suggestion } from './base-command.js';
+export declare class ResearchCommand extends BaseCommand {
+    name: string;
+    description: string;
+    suggestions: Suggestion[];
+    options: {
+        flags: string;
+        description: string;
+    }[];
+    execute(args: string): Promise<void>;
+}

package/dist/src/commands/runs-command.d.ts

@@ -0,0 +1,7 @@
+import { BaseCommand } from './base-command.js';
+export declare class RunsCommand extends BaseCommand {
+    name: string;
+    description: string;
+    tuiEnabled: boolean;
+    execute(args: string): Promise<void>;
+}

package/dist/src/commands/start-command.d.ts

@@ -0,0 +1,7 @@
+import { BaseCommand, type Suggestion } from './base-command.js';
+export declare class StartCommand extends BaseCommand {
+    name: string;
+    description: string;
+    suggestions: Suggestion[];
+    execute(args: string): Promise<void>;
+}

package/dist/src/commands/status-command.d.ts

@@ -0,0 +1,6 @@
+import { BaseCommand } from './base-command.js';
+export declare class StatusCommand extends BaseCommand {
+    name: string;
+    description: string;
+    execute(_args: string): Promise<void>;
+}

package/dist/src/commands/test-command.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand, type Suggestion } from './base-command.js';
+export declare class TestCommand extends BaseCommand {
+    name: string;
+    description: string;
+    options: {
+        flags: string;
+        description: string;
+    }[];
+    suggestions: Suggestion[];
+    execute(args: string): Promise<void>;
+}

package/dist/src/components/ActivityPane.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+interface ActivityPaneProps {
+    isInputVisible?: boolean;
+}
+declare const ActivityPane: React.FC<ActivityPaneProps>;
+export default ActivityPane;

package/dist/src/components/AddKnowledge.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+interface AddKnowledgeProps {
+    initialUrl?: string;
+    onComplete?: () => void;
+    onCancel?: () => void;
+}
+declare const AddKnowledge: React.FC<AddKnowledgeProps>;
+export default AddKnowledge;

package/dist/src/components/AddRule.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+interface AddRuleProps {
+    initialAgent?: string;
+    initialName?: string;
+    onComplete?: () => void;
+    onCancel?: () => void;
+}
+declare const AddRule: React.FC<AddRuleProps>;
+export default AddRule;

package/dist/src/components/App.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { ExplorBot } from '../explorbot.js';
+interface AppProps {
+    explorBot: ExplorBot;
+    initialShowInput?: boolean;
+    exitOnEmptyInput?: boolean;
+}
+export declare function App({ explorBot, initialShowInput, exitOnEmptyInput }: AppProps): React.JSX.Element;
+export {};

package/dist/src/components/Autocomplete.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+declare const Autocomplete: React.FC;
+export default Autocomplete;

package/dist/src/components/InputPane.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import type { CommandHandler } from '../command-handler.js';
+interface InputPaneProps {
+    commandHandler: CommandHandler;
+    exitOnEmptyInput?: boolean;
+    onSubmit?: (value: string) => Promise<void>;
+    onCommandStart?: () => void;
+    onCommandComplete?: () => void;
+    isActive?: boolean;
+    visible?: boolean;
+}
+declare const InputPane: React.FC<InputPaneProps>;
+export default InputPane;

package/dist/src/components/InputReadline.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import type { CommandHandler } from '../command-handler.js';
+interface InputReadlineProps {
+    commandHandler?: CommandHandler;
+    exitOnEmptyInput?: boolean;
+    onSubmit?: (value: string) => void | Promise<void>;
+    onChange?: (value: string) => void;
+    onCommandStart?: () => void;
+    onCommandComplete?: () => void;
+    isActive?: boolean;
+    visible?: boolean;
+    value?: string;
+    placeholder?: string;
+    showPrompt?: boolean;
+}
+declare const InputReadline: React.FC<InputReadlineProps>;
+export default InputReadline;

package/dist/src/components/LogPane.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+interface LogPaneProps {
+    verboseMode: boolean;
+}
+declare const LogPane: React.FC<LogPaneProps>;
+export default LogPane;

package/dist/src/components/PlanEditor.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { Test } from '../test-plan.js';
+interface PlanEditorProps {
+    tasks: Test[];
+    onClose: () => void;
+    isActive: boolean;
+}
+declare const PlanEditor: React.FC<PlanEditorProps>;
+export default PlanEditor;

package/dist/src/components/PlanPane.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+interface PlanPaneProps {
+    completedPlans: PlanSummary[];
+    activePlan: PlanSummary | null;
+}
+declare const PlanPane: React.FC<PlanPaneProps>;
+export default PlanPane;
+export interface PlanSummary {
+    title: string;
+    testCount: number;
+    passed: number;
+    failed: number;
+}

package/dist/src/components/SessionTimer.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+type SessionTimerProps = {
+    startedAt: number;
+};
+declare const SessionTimer: React.FC<SessionTimerProps>;
+export default SessionTimer;

package/dist/src/components/StateTransitionPane.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { StateTransition, WebPageState } from '../state-manager.js';
+interface StateTransitionPaneProps {
+    transition?: StateTransition;
+    currentState?: WebPageState;
+}
+declare const StateTransitionPane: React.FC<StateTransitionPaneProps>;
+export default StateTransitionPane;

package/dist/src/components/StatusPane.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+export declare const StatusPane: React.FC<{
+    onComplete?: () => void;
+}>;

package/dist/src/components/TaskPane.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { Test } from '../test-plan.js';
+export declare const WINDOW_SIZE = 7;
+interface TaskPaneProps {
+    tasks: Test[];
+    scrollOffset?: number;
+}
+declare const TaskPane: React.FC<TaskPaneProps>;
+export default TaskPane;

package/dist/src/components/Welcome.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+declare const Welcome: React.FC;
+export default Welcome;

package/dist/src/components/WelcomeChecklist.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { ExplorbotConfig } from '../config.js';
+import type { KnowledgeTracker } from '../knowledge-tracker.js';
+interface WelcomeChecklistProps {
+    config: ExplorbotConfig;
+    knowledgeTracker: KnowledgeTracker;
+}
+declare const WelcomeChecklist: React.FC<WelcomeChecklistProps>;
+export default WelcomeChecklist;

package/dist/src/components/WelcomeCommands.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+interface WelcomeCommandsProps {
+    hasKnowledge: boolean;
+}
+declare const WelcomeCommands: React.FC<WelcomeCommandsProps>;
+export default WelcomeCommands;

package/dist/src/components/autocomplete-store.d.ts

@@ -0,0 +1,10 @@
+import type { CommandAutocompleteSuggestion } from '../command-handler.js';
+interface AutocompleteState {
+    suggestions: CommandAutocompleteSuggestion[];
+    argumentHint?: string;
+    selectedIndex: number;
+    visible: boolean;
+}
+export declare const setAutocompleteState: (next: AutocompleteState) => void;
+export declare const useAutocompleteState: () => AutocompleteState;
+export {};

package/dist/src/components/parse-keypress.d.ts

@@ -0,0 +1,12 @@
+import { Buffer } from 'node:buffer';
+export declare const nonAlphanumericKeys: string[];
+export default function parseKeypress(value?: string | Buffer): {
+    name: string;
+    ctrl: boolean;
+    meta: boolean;
+    shift: boolean;
+    option: boolean;
+    sequence: string;
+    raw: string | undefined;
+    code: string | undefined;
+};

package/dist/src/config.d.ts

@@ -0,0 +1,251 @@
+interface PlaywrightConfig {
+    browser: 'chromium' | 'firefox' | 'webkit';
+    url: string;
+    show?: boolean;
+    windowSize?: string;
+    slowMo?: number;
+    chromium?: {
+        args?: string[];
+    };
+    firefox?: {
+        args?: string[];
+    };
+    webkit?: {
+        args?: string[];
+    };
+    timeout?: number;
+    waitForAction?: number;
+    waitForNavigation?: 'load' | 'domcontentloaded' | 'networkidle';
+    waitForTimeout?: number;
+    spinnerSelectors?: string[];
+    ignoreHTTPSErrors?: boolean;
+    userAgent?: string;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    args?: string[];
+}
+type PlaywrightHookFn = (ctx: {
+    page: any;
+    url: string;
+}) => Promise<void> | void;
+type CodeceptJSHookFn = (ctx: {
+    I: any;
+    url: string;
+}) => Promise<void> | void;
+interface PlaywrightHook {
+    type: 'playwright';
+    hook: PlaywrightHookFn;
+}
+interface CodeceptJSHook {
+    type: 'codeceptjs';
+    hook: CodeceptJSHookFn;
+}
+type Hook = PlaywrightHook | CodeceptJSHook;
+type HookPatternMap = Record<string, Hook>;
+type HookConfig = Hook | HookPatternMap;
+interface HooksConfig {
+    beforeHook?: HookConfig;
+    afterHook?: HookConfig;
+}
+interface AgentConfig extends HooksConfig {
+    model?: any;
+    enabled?: boolean;
+    systemPrompt?: string;
+    rules?: RuleEntry[];
+    providerOptions?: Record<string, any>;
+    reasoning?: 'provider-default' | 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
+}
+interface ResearcherAgentConfig extends AgentConfig {
+    excludeSelectors?: string[];
+    includeSelectors?: string[];
+    stopWords?: string[];
+    maxElementsToExplore?: number;
+    maxExpandableClicks?: number;
+    retries?: number;
+    sections?: string[];
+    focusSections?: string[];
+    errorPageTimeout?: number;
+}
+interface TesterAgentConfig extends AgentConfig {
+    progressCheckInterval?: number;
+}
+interface PilotAgentConfig extends AgentConfig {
+    stepsToReview?: number;
+}
+interface NavigatorAgentConfig extends AgentConfig {
+    addHtmlOnTry?: number;
+    maxAttempts?: number;
+    verifyAttempts?: number;
+    verifyTimeout?: number;
+}
+type HealFn = (ctx: {
+    I: any;
+}) => Promise<void> | void;
+interface HealRecipe {
+    priority?: number;
+    steps?: string[];
+    fn: (context: {
+        step: any;
+        error: Error;
+        prevSteps?: any[];
+    }) => HealFn | Promise<HealFn | null> | null;
+}
+interface RerunnerAgentConfig extends AgentConfig {
+    healLimit?: number;
+    ariaSnapshotLimit?: number;
+    retryFailedStep?: Record<string, any>;
+    screenshotOnFail?: Record<string, any>;
+    recipes?: Record<string, HealRecipe>;
+}
+interface PlannerAgentConfig extends AgentConfig {
+    styles?: string[];
+    stylesDir?: string;
+}
+interface ScreencastConfig {
+    size?: {
+        width: number;
+        height: number;
+    };
+    quality?: number;
+}
+interface HistorianAgentConfig extends AgentConfig {
+    framework?: 'codeceptjs' | 'playwright';
+    screencast?: boolean | ScreencastConfig;
+}
+interface AgentsConfig {
+    tester?: TesterAgentConfig;
+    navigator?: NavigatorAgentConfig;
+    researcher?: ResearcherAgentConfig;
+    planner?: PlannerAgentConfig;
+    pilot?: PilotAgentConfig;
+    driller?: AgentConfig;
+    'experience-compactor'?: AgentConfig;
+    captain?: AgentConfig;
+    quartermaster?: AgentConfig;
+    historian?: HistorianAgentConfig;
+    fisherman?: AgentConfig;
+    chief?: AgentConfig;
+    curler?: AgentConfig;
+    rerunner?: RerunnerAgentConfig;
+    analyst?: AgentConfig;
+}
+interface AIConfig {
+    model: any;
+    apiKey?: string;
+    config?: Record<string, any>;
+    langfuse?: {
+        enabled?: boolean;
+        publicKey?: string;
+        secretKey?: string;
+        baseUrl?: string;
+    };
+    tools?: {
+        enabled: boolean;
+        maxConcurrency: number;
+        timeout: number;
+    };
+    vision?: boolean;
+    visionModel?: any;
+    agenticModel?: any;
+    maxAttempts?: number;
+    retryDelay?: number;
+    agents?: AgentsConfig;
+}
+interface HtmlConfig {
+    minimal?: {
+        include?: string[];
+        exclude?: string[];
+    };
+    combined?: {
+        include?: string[];
+        exclude?: string[];
+    };
+    text?: {
+        include?: string[];
+        exclude?: string[];
+    };
+}
+interface ActionConfig {
+    delay?: number;
+    retries?: number;
+}
+interface ReporterConfig {
+    enabled?: boolean;
+    html?: boolean;
+    markdown?: boolean;
+    runGroup?: string | null;
+}
+type ApiHookFn = (ctx: {
+    headers: Record<string, string>;
+    baseEndpoint: string;
+}) => Promise<Record<string, string> | undefined> | Record<string, string> | undefined;
+interface ApiConfig {
+    baseEndpoint?: string;
+    spec?: string[];
+    headers?: Record<string, string>;
+    bootstrap?: ApiHookFn;
+    teardown?: ApiHookFn;
+}
+interface WebConfig {
+    url: string;
+}
+interface ExplorbotConfig {
+    web?: WebConfig;
+    playwright: PlaywrightConfig;
+    ai: AIConfig;
+    html?: HtmlConfig;
+    action?: ActionConfig;
+    dirs?: {
+        knowledge: string;
+        experience: string;
+        output: string;
+    };
+    experience?: {
+        maxReadLines?: number;
+    };
+    reporter?: ReporterConfig;
+    api?: ApiConfig;
+    stepsFile?: string;
+    files?: Record<string, string>;
+    dynamicPageRegex?: string;
+}
+type RuleEntry = string | Record<string, string>;
+export declare const EXPLORBOT_CONFIG_PATHS: string[];
+export type { ExplorbotConfig, PlaywrightConfig, AIConfig, HtmlConfig, ActionConfig, AgentConfig, AgentsConfig, HistorianAgentConfig, ResearcherAgentConfig, NavigatorAgentConfig, PlannerAgentConfig, RerunnerAgentConfig, HealRecipe, Hook, HookConfig, HooksConfig, PlaywrightHook, CodeceptJSHook, HookPatternMap, RuleEntry, ReporterConfig, ApiConfig, WebConfig, ApiHookFn, };
+export declare class ConfigParser {
+    static instance: ConfigParser;
+    config: ExplorbotConfig | null;
+    configPath: string | null;
+    runtimeBaseUrlOverride: string | null;
+    constructor();
+    static loadEnv(filePath: string): void;
+    static getInstance(): ConfigParser;
+    loadConfig(options?: {
+        config?: string;
+        path?: string;
+        baseUrl?: string;
+    }): Promise<ExplorbotConfig>;
+    getConfig(): ExplorbotConfig;
+    getConfigPath(): string | null;
+    getOutputDir(): string;
+    getStatesDir(): string;
+    getPlansDir(): string;
+    getTestsDir(): string;
+    static resetForTesting(): void;
+    static setupTestConfig(): void;
+    static getTestDirectories(): string[];
+    static cleanupAllTestDirectories(): void;
+    findConfigFile(): string | null;
+    loadConfigModule(configPath: string): Promise<any>;
+    resolveConfig(config: ExplorbotConfig, options?: {
+        baseUrl?: string;
+    }): ExplorbotConfig;
+    validateConfig(config: ExplorbotConfig): void;
+    getNestedValue(obj: any, path: string): any;
+    mergeWithDefaults(config: Partial<ExplorbotConfig>): ExplorbotConfig;
+    deepMerge(target: any, source: any): any;
+    ensureDirectory(path: string): void;
+}
+export declare function outputPath(...segments: string[]): string;