explorbot 0.0.1

package/dist/src/config.js

@@ -0,0 +1,249 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { existsSync, mkdirSync, readFileSync, rmSync } from 'node:fs';
+import path, { dirname, join, resolve } from 'node:path';
+import { parseEnv } from 'node:util';
+import { log } from './utils/logger.js';
+const config = {
+    playwright: {
+        browser: 'chromium',
+        url: 'http://localhost:3000',
+    },
+    ai: {
+        model: null,
+    },
+};
+export const EXPLORBOT_CONFIG_PATHS = ['explorbot.config.js', 'explorbot.config.mjs', 'explorbot.config.ts'];
+export class ConfigParser {
+    static instance;
+    config = null;
+    configPath = null;
+    constructor() { }
+    static loadEnv(filePath) {
+        const resolved = resolve(filePath);
+        if (!existsSync(resolved))
+            return;
+        Object.assign(process.env, parseEnv(readFileSync(resolved, 'utf8')));
+    }
+    static getInstance() {
+        if (!ConfigParser.instance) {
+            ConfigParser.instance = new ConfigParser();
+        }
+        return ConfigParser.instance;
+    }
+    async loadConfig(options) {
+        if (this.config && !options?.config && !options?.path) {
+            return this.config;
+        }
+        // Store the initial working directory for reference
+        if (!process.env.INITIAL_CWD) {
+            process.env.INITIAL_CWD = process.cwd();
+        }
+        const originalCwd = process.cwd();
+        if (options?.path) {
+            const resolvedWorkingPath = resolve(options.path);
+            process.chdir(resolvedWorkingPath);
+        }
+        ConfigParser.loadEnv('.env');
+        try {
+            const resolvedPath = options?.config || this.findConfigFile();
+            if (!resolvedPath) {
+                throw new Error('No configuration file found. Please create explorbot.config.js or explorbot.config.ts');
+            }
+            const configModule = await this.loadConfigModule(resolvedPath);
+            const loadedConfig = configModule.default || configModule;
+            if (!loadedConfig) {
+                throw new Error('Configuration file is empty or invalid');
+            }
+            this.config = this.resolveConfig(loadedConfig);
+            this.configPath = resolvedPath;
+            log(`Configuration loaded from: ${resolvedPath}`);
+            // Restore original directory after successful config load
+            if (options?.path && originalCwd !== process.cwd()) {
+                process.chdir(originalCwd);
+            }
+            return this.config;
+        }
+        catch (error) {
+            // Restore original directory on error
+            if (options?.path && originalCwd !== process.cwd()) {
+                process.chdir(originalCwd);
+            }
+            throw new Error(`Failed to load configuration: ${error}`);
+        }
+    }
+    getConfig() {
+        if (!this.config) {
+            throw new Error('Configuration not loaded. Call loadConfig() first.');
+        }
+        return this.config;
+    }
+    getConfigPath() {
+        return this.configPath;
+    }
+    getOutputDir() {
+        const config = this.getConfig();
+        const configPath = this.getConfigPath();
+        if (!configPath)
+            throw new Error('Config path not found');
+        return path.join(path.dirname(configPath), config.dirs?.output || 'output');
+    }
+    getStatesDir() {
+        return outputPath('states');
+    }
+    getPlansDir() {
+        return outputPath('plans');
+    }
+    // For testing purposes only
+    static resetForTesting() {
+        if (ConfigParser.instance) {
+            ConfigParser.instance.config = null;
+            ConfigParser.instance.configPath = null;
+        }
+    }
+    // For testing purposes only - sets up minimal default config
+    static setupTestConfig() {
+        const instance = ConfigParser.getInstance();
+        // Create unique directory names for this test run to ensure isolation
+        const testId = `${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+        const testBaseDir = join(process.cwd(), 'test-dirs', testId);
+        instance.config = {
+            playwright: {
+                url: 'https://example.com',
+                browser: 'chromium',
+                show: false,
+            },
+            ai: {
+                model: { modelId: 'test-model', provider: 'test' },
+                config: {},
+                vision: false,
+            },
+            dirs: {
+                knowledge: join(testBaseDir, 'knowledge'),
+                experience: join(testBaseDir, 'experience'),
+                output: join(testBaseDir, 'output'),
+            },
+        };
+        instance.configPath = join(testBaseDir, 'test-config');
+    }
+    // For testing purposes only - get test directories for cleanup
+    static getTestDirectories() {
+        const instance = ConfigParser.getInstance();
+        if (!instance.config?.dirs)
+            return [];
+        return [instance.config.dirs.knowledge, instance.config.dirs.experience, instance.config.dirs.output, dirname(instance.configPath || '')].filter((dir) => dir?.includes('test-dirs'));
+    }
+    // For testing purposes only - clean up all test directories
+    static cleanupAllTestDirectories() {
+        try {
+            const testDirsBase = join(process.cwd(), 'test-dirs');
+            if (existsSync(testDirsBase)) {
+                rmSync(testDirsBase, { recursive: true, force: true });
+            }
+        }
+        catch (error) {
+            // Ignore cleanup errors
+        }
+    }
+    findConfigFile() {
+        const possiblePaths = [...EXPLORBOT_CONFIG_PATHS, 'config/explorbot.config.js', 'config/explorbot.config.mjs', 'config/explorbot.config.ts', 'src/config/explorbot.config.js', 'src/config/explorbot.config.mjs', 'src/config/explorbot.config.ts'];
+        for (const path of possiblePaths) {
+            const fullPath = resolve(process.cwd(), path);
+            if (existsSync(fullPath)) {
+                return fullPath;
+            }
+        }
+        return null;
+    }
+    async loadConfigModule(configPath) {
+        const ext = configPath.split('.').pop();
+        if (ext === 'ts') {
+            try {
+                const module = await import(__rewriteRelativeImportExtension(configPath));
+                return module;
+            }
+            catch (error) {
+                const require = (await import('node:module')).createRequire(import.meta.url);
+                return require(configPath);
+            }
+        }
+        else if (ext === 'js' || ext === 'mjs') {
+            const module = await import(__rewriteRelativeImportExtension(configPath));
+            return module;
+        }
+        else {
+            const content = readFileSync(configPath, 'utf8');
+            return JSON.parse(content);
+        }
+    }
+    resolveConfig(config) {
+        if (config.web?.url && !config.playwright?.url) {
+            config.playwright = config.playwright || { browser: 'chromium', url: '' };
+            config.playwright.url = config.web.url;
+        }
+        return config;
+    }
+    validateConfig(config) {
+        if (!config.ai?.model) {
+            throw new Error('Missing required configuration field: ai.model');
+        }
+        const url = config.playwright?.url || config.web?.url;
+        if (!url) {
+            throw new Error('Missing required configuration: web.url or playwright.url');
+        }
+        try {
+            new URL(url);
+        }
+        catch {
+            throw new Error(`Invalid URL in configuration: ${url}`);
+        }
+    }
+    getNestedValue(obj, path) {
+        return path.split('.').reduce((current, key) => current?.[key], obj);
+    }
+    mergeWithDefaults(config) {
+        const defaults = {
+            playwright: {
+                browser: 'chromium',
+                show: false, // we need headless
+            },
+            action: {
+                delay: 1000,
+                retries: 3,
+            },
+            dirs: {
+                knowledge: 'knowledge',
+                experience: 'experience',
+                output: 'output',
+            },
+        };
+        return this.deepMerge(defaults, config);
+    }
+    deepMerge(target, source) {
+        const result = { ...target };
+        for (const key in source) {
+            if (source[key] && typeof source[key] === 'object' && !Array.isArray(source[key]) && source[key].constructor === Object) {
+                result[key] = this.deepMerge(result[key] || {}, source[key]);
+            }
+            else {
+                result[key] = source[key];
+            }
+        }
+        return result;
+    }
+    ensureDirectory(path) {
+        if (!existsSync(path)) {
+            mkdirSync(path, { recursive: true });
+        }
+    }
+}
+export function outputPath(...segments) {
+    return path.join(ConfigParser.getInstance().getOutputDir(), ...segments);
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"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"}

package/dist/src/execution-controller.js

@@ -0,0 +1,92 @@
+import { EventEmitter } from 'node:events';
+import * as readline from 'node:readline';
+import { clearActivity } from "./activity.js";
+export class ExecutionController extends EventEmitter {
+    static instance;
+    interrupted = false;
+    inputCallback = null;
+    interruptResolvers = [];
+    abortController = null;
+    constructor() {
+        super();
+    }
+    static getInstance() {
+        if (!ExecutionController.instance) {
+            ExecutionController.instance = new ExecutionController();
+        }
+        return ExecutionController.instance;
+    }
+    setInputCallback(callback) {
+        this.inputCallback = callback;
+    }
+    startExecution() {
+        this.interrupted = false;
+        this.abortController = new AbortController();
+    }
+    getAbortSignal() {
+        return this.abortController?.signal;
+    }
+    interrupt() {
+        clearActivity();
+        if (this.interrupted)
+            return;
+        this.interrupted = true;
+        this.abortController?.abort();
+        this.emit('interrupt');
+        for (const resolve of this.interruptResolvers) {
+            resolve();
+        }
+        this.interruptResolvers = [];
+        this.emit('idle');
+    }
+    isInterrupted() {
+        return this.interrupted;
+    }
+    waitForInterrupt() {
+        if (this.interrupted) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            this.interruptResolvers.push(resolve);
+        });
+    }
+    async checkInterrupt() {
+        if (!this.interrupted)
+            return null;
+        const userInput = await this.requestInput('Execution interrupted. What should we do instead?');
+        this.interrupted = false;
+        return userInput;
+    }
+    async handleInterrupt(prompt) {
+        const message = prompt || 'Execution interrupted. Enter new instruction (or "stop"/"exit" to cancel):';
+        const userInput = await this.requestInput(message);
+        this.interrupted = false;
+        return userInput;
+    }
+    async requestInput(prompt) {
+        if (this.inputCallback) {
+            return await this.inputCallback(prompt);
+        }
+        return await this.readlineInput(prompt);
+    }
+    async readlineInput(prompt) {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        return new Promise((resolve) => {
+            rl.question(`${prompt}\n> `, (answer) => {
+                rl.close();
+                const trimmed = answer.trim();
+                resolve(trimmed || null);
+            });
+        });
+    }
+    reset() {
+        this.interrupted = false;
+        this.interruptResolvers = [];
+        this.abortController = null;
+    }
+}
+export const executionController = ExecutionController.getInstance();
+//# sourceMappingURL=execution-controller.js.map

package/dist/src/execution-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-controller.js","sourceRoot":"","sources":["../../src/execution-controller.ts"],"names":[],"mappings":"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"}

package/dist/src/experience-tracker.js

@@ -0,0 +1,294 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import matter from 'gray-matter';
+import { ConfigParser } from './config.js';
+import { KnowledgeTracker } from './knowledge-tracker.js';
+import { createDebug, tag } from './utils/logger.js';
+import { mdq } from './utils/markdown-query.js';
+import { extractStatePath } from './utils/url-matcher.js';
+const debugLog = createDebug('explorbot:experience');
+const DEFAULT_MAX_EXPERIENCE_LINES = 100;
+export class ExperienceTracker {
+    experienceDir;
+    disabled;
+    knowledgeTracker;
+    constructor(options = {}) {
+        const configParser = ConfigParser.getInstance();
+        const config = configParser.getConfig();
+        const configPath = configParser.getConfigPath();
+        this.disabled = options.disabled ?? false;
+        this.knowledgeTracker = new KnowledgeTracker();
+        // Resolve experience directory relative to the config file location (project root)
+        if (configPath) {
+            const projectRoot = dirname(configPath);
+            this.experienceDir = join(projectRoot, config.dirs?.experience || 'experience');
+        }
+        else {
+            this.experienceDir = config.dirs?.experience || 'experience';
+        }
+        if (!this.disabled) {
+            this.ensureDirectory(this.experienceDir);
+        }
+    }
+    getExperienceDirectories() {
+        const directories = [this.experienceDir];
+        // Also check for experience directory in current working directory
+        const cwdExperienceDir = join(process.cwd(), 'experience');
+        debugLog('Checking for experience directory in CWD:', cwdExperienceDir);
+        debugLog('CWD experience dir exists:', existsSync(cwdExperienceDir));
+        debugLog('CWD experience dir different from main:', cwdExperienceDir !== this.experienceDir);
+        if (existsSync(cwdExperienceDir) && cwdExperienceDir !== this.experienceDir) {
+            directories.push(cwdExperienceDir);
+            debugLog('Added CWD experience directory:', cwdExperienceDir);
+        }
+        // Also check for experience directory in the directory where the script was run from
+        // This is useful when running from subdirectories like 'example'
+        const scriptCwd = process.env.INITIAL_CWD || process.cwd();
+        const scriptExperienceDir = join(scriptCwd, 'experience');
+        debugLog('Checking for experience directory in script CWD:', scriptExperienceDir);
+        debugLog('Script CWD experience dir exists:', existsSync(scriptExperienceDir));
+        if (existsSync(scriptExperienceDir) && scriptExperienceDir !== this.experienceDir && !directories.includes(scriptExperienceDir)) {
+            directories.push(scriptExperienceDir);
+            debugLog('Added script CWD experience directory:', scriptExperienceDir);
+        }
+        debugLog('Final experience directories:', directories);
+        return directories;
+    }
+    ensureDirectory(dir) {
+        if (this.disabled) {
+            return;
+        }
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+    readExperienceFile(stateHash) {
+        const filePath = this.getExperienceFilePath(stateHash);
+        const fileContent = readFileSync(filePath, 'utf8');
+        const { content, data } = matter(fileContent);
+        return { content, data };
+    }
+    writeExperienceFile(stateHash, content, frontmatter) {
+        if (this.disabled) {
+            return;
+        }
+        const filePath = this.getExperienceFilePath(stateHash);
+        const fileContent = matter.stringify(content, frontmatter || {});
+        writeFileSync(filePath, fileContent, 'utf8');
+    }
+    hasRecentExperience(stateHash, prefix = '') {
+        if (this.disabled) {
+            return false;
+        }
+        if (prefix) {
+            stateHash = `${prefix}_${stateHash}`;
+        }
+        const filePath = this.getExperienceFilePath(stateHash);
+        if (!existsSync(filePath)) {
+            return false;
+        }
+        const stats = statSync(filePath);
+        return stats.mtime.getTime() > Date.now() - 1000 * 60 * 60 * 24;
+    }
+    getExperienceFilePath(stateHash) {
+        return join(this.experienceDir, `${stateHash}.md`);
+    }
+    ensureExperienceFile(state) {
+        if (this.disabled) {
+            return '';
+        }
+        const stateHash = state.getStateHash();
+        const filePath = this.getExperienceFilePath(stateHash);
+        if (!existsSync(filePath)) {
+            const frontmatter = {
+                url: state.url ? extractStatePath(state.url) : '',
+                title: state.title,
+            };
+            this.writeExperienceFile(stateHash, '', frontmatter);
+        }
+        return filePath;
+    }
+    updateSummary(state, summary) {
+        if (this.disabled)
+            return;
+        const stateHash = state.getStateHash();
+        this.ensureExperienceFile(state);
+        const { content, data } = this.readExperienceFile(stateHash);
+        data.summary = summary;
+        this.writeExperienceFile(stateHash, content, data);
+        debugLog(`Updated summary for ${stateHash}`);
+    }
+    isWritingDisabled(state) {
+        return this.knowledgeTracker.getRelevantKnowledge(state).some((k) => k.noExperienceWriting === true || k.noExperienceWriting === 'true');
+    }
+    async saveSuccessfulResolution(state, originalMessage, code, explanation) {
+        if (this.disabled || this.isWritingDisabled(state))
+            return;
+        this.ensureExperienceFile(state);
+        const stateHash = state.getStateHash();
+        const { content, data } = this.readExperienceFile(stateHash);
+        if (content.includes(code)) {
+            debugLog('Skipping duplicate successful resolution', code);
+            return;
+        }
+        const filteredCode = code.replace(/I\.amOnPage\s*\([^)]*\)/gs, '');
+        const newEntryContent = `### SUCCEEDED: ${originalMessage.split('\n')[0]}
+
+${explanation ? `Solution: ${explanation}` : ''}
+
+\`\`\`javascript
+${filteredCode}
+\`\`\`
+`;
+        const updatedContent = `${newEntryContent}\n\n${content}`;
+        this.writeExperienceFile(stateHash, updatedContent, data);
+        tag('substep').log(` Added successful resolution to: ${stateHash}.md`);
+    }
+    getAllExperience() {
+        const allFiles = [];
+        for (const experienceDir of this.getExperienceDirectories()) {
+            if (!existsSync(experienceDir)) {
+                continue;
+            }
+            try {
+                const files = readdirSync(experienceDir)
+                    .filter((file) => file.endsWith('.md'))
+                    .map((file) => join(experienceDir, file));
+                for (const file of files) {
+                    try {
+                        const content = readFileSync(file, 'utf8');
+                        const parsed = matter(content);
+                        allFiles.push({
+                            filePath: file,
+                            data: parsed.data,
+                            content: parsed.content,
+                        });
+                    }
+                    catch (error) {
+                        debugLog(`Failed to read experience file ${file}:`, error);
+                    }
+                }
+            }
+            catch (error) {
+                debugLog(`Failed to read experience directory ${experienceDir}:`, error);
+            }
+        }
+        return allFiles;
+    }
+    getRelevantExperience(state, options) {
+        const relevantKnowledge = this.knowledgeTracker.getRelevantKnowledge(state);
+        const readingDisabled = relevantKnowledge.some((knowledge) => knowledge.noExperienceReading === true || knowledge.noExperienceReading === 'true');
+        if (readingDisabled) {
+            return [];
+        }
+        const config = ConfigParser.getInstance().getConfig();
+        const maxLines = config.experience?.maxReadLines ?? DEFAULT_MAX_EXPERIENCE_LINES;
+        return this.getAllExperience()
+            .filter((experience) => {
+            const experienceState = experience.data;
+            return state.isRelevantExperienceRecord(experienceState, {
+                includeDescendantExperience: options?.includeDescendantExperience,
+            });
+        })
+            .map((experience) => {
+            const lines = experience.content.split('\n');
+            if (lines.length <= maxLines)
+                return experience;
+            return { ...experience, content: lines.slice(0, maxLines).join('\n') };
+        });
+    }
+    /**
+     * Clean up experience tracker (for testing)
+     */
+    cleanup() {
+        // Clear any in-memory state if needed
+        // The actual files will be cleaned up by test cleanup
+    }
+    saveSessionExperience(state, entry) {
+        if (this.disabled || this.isWritingDisabled(state))
+            return;
+        this.ensureExperienceFile(state);
+        const stateHash = state.getStateHash();
+        const { content, data } = this.readExperienceFile(stateHash);
+        if (entry.relatedUrls?.length) {
+            const currentPath = extractStatePath(state.url || '');
+            const existingRelated = Array.isArray(data.related) ? data.related : [];
+            const allRelated = [...new Set([...existingRelated, ...entry.relatedUrls])];
+            data.related = allRelated.filter((url) => url !== currentPath);
+        }
+        const sessionContent = this.trimSessionContent(this.generateSessionContent(entry));
+        if (!sessionContent)
+            return;
+        const updatedContent = `${sessionContent}\n${content}`;
+        this.writeExperienceFile(stateHash, updatedContent, data);
+        tag('substep').log(`Added session experience to: ${stateHash}.md`);
+    }
+    generateSessionContent(entry) {
+        let content = `## Successful Flow: ${entry.scenario}\n\n`;
+        for (const step of entry.steps) {
+            content += `* ${step.message}\n\n`;
+            if (step.code) {
+                content += '```js\n';
+                content += `${step.code}\n`;
+                content += '```\n\n';
+            }
+            if (step.discovery) {
+                const discoveries = step.discovery.split('\n').filter((d) => d.trim());
+                for (const discovery of discoveries) {
+                    content += `> ${discovery.trim()}\n\n`;
+                }
+            }
+        }
+        content += '---\n';
+        return content;
+    }
+    trimSessionContent(content) {
+        const q = mdq(content);
+        if (q.query('heading').count() === 0)
+            return null;
+        if (q.query('code').count() === 0)
+            return null;
+        let result = content;
+        const codeBlocks = q.query('code').each();
+        if (codeBlocks.length > 2) {
+            for (const block of codeBlocks.slice(2)) {
+                result = result.replace(block.text(), '');
+            }
+        }
+        const blockquotes = mdq(result).query('blockquote').each();
+        if (blockquotes.length > 5) {
+            for (const bq of blockquotes.slice(5)) {
+                result = result.replace(bq.text(), '');
+            }
+        }
+        const lines = result.split('\n');
+        if (lines.length > 40) {
+            result = lines.slice(0, 40).join('\n');
+        }
+        if (!result.trim())
+            return null;
+        return result;
+    }
+    getSuccessfulExperience(state, options) {
+        const records = this.getRelevantExperience(state, {
+            includeDescendantExperience: options?.includeDescendants,
+        });
+        const results = [];
+        for (const record of records) {
+            if (!record.content)
+                continue;
+            const successFlows = mdq(record.content).query('section(~"Successful Flow")').text();
+            const succeeded = mdq(record.content).query('section(~"SUCCEEDED")').text();
+            let combined = [successFlows, succeeded].filter(Boolean).join('\n\n');
+            if (!combined.trim())
+                continue;
+            if (options?.stripCode) {
+                combined = mdq(combined).query('code').replace('');
+            }
+            if (combined.trim())
+                results.push(combined.trim());
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=experience-tracker.js.map