endorphin-ai 0.1.0

package/framework/core/test-runner.js

@@ -0,0 +1,133 @@
+// Endorphin e2e AI test framework>
+// Copyright (C)  2025 Redstudio Agency
+
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as
+// published by the Free Software Foundation, either version 3 of the
+// License, or (at your option) any later version.
+
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+
+
+import { HumanMessage } from "@langchain/core/messages";
+import { AGENT_CONFIG } from '../config/agent-config.js';
+
+/**
+ * Run a test task using the AI agent
+ * @param {Object} framework - Framework instance
+ * @param {string} taskDescription - Description of the task to perform
+ * @param {string} testName - Optional test name
+ * @returns {Object} Test result
+ */
+export async function runTask(framework, taskDescription, testName = null) {
+  const timestamp = new Date().toISOString();
+  const name = testName || `Test-${Date.now()}`;
+  
+  console.log(`\n🎯 Running Task: ${name}`);
+  console.log(`📝 Task: ${taskDescription}`);
+  console.log(`⏰ Started at: ${timestamp}\n`);
+
+  // Create test session
+  const session = framework.createTestSession(name, name.replace(/\s+/g, '-').toLowerCase());
+  framework.currentTestSession = session;
+  
+  try {
+    // Log initial step
+    framework.logTestStep("Test started", null, null, `Starting task: ${taskDescription}`, true);
+    await framework.takeStepScreenshot("Initial page state");
+    
+    const finalState = await framework.agent.invoke({
+      messages: [new HumanMessage(taskDescription)],
+    }, {
+      recursionLimit: AGENT_CONFIG.agent.recursionLimit,
+      configurable: { thread_id: `session-${framework.currentTestSession.sessionId}` }
+    });
+
+    const result = finalState.messages[finalState.messages.length - 1].content;
+    
+    // Log final step
+    framework.logTestStep("Test completed", null, null, result, true);
+    await framework.takeStepScreenshot("Final page state");
+    
+    // Finish session
+    await framework.finishTestSession('SUCCESS', result);
+    
+    console.log(`\n✅ Task "${name}" completed successfully!`);
+    console.log(`📊 Result: ${result}\n`);
+    
+    return {
+      testName: name,
+      task: taskDescription,
+      timestamp,
+      status: 'SUCCESS',
+      result: result,
+      duration: Date.now() - new Date(timestamp).getTime(),
+      sessionDir: session.sessionDir
+    };
+    
+  } catch (error) {
+    console.error(`\n❌ Task "${name}" failed:`);
+    console.error(`💥 Error: ${error.message}\n`);
+    
+    // Log error step
+    framework.logTestStep("Test failed", null, null, error.message, false);
+    await framework.takeStepScreenshot("Error state");
+    
+    // Finish session with failure
+    await framework.finishTestSession('FAILED', error.message);
+    
+    return {
+      testName: name,
+      task: taskDescription,
+      timestamp,
+      status: 'FAILED',
+      error: error.message,
+      duration: Date.now() - new Date(timestamp).getTime(),
+      sessionDir: session.sessionDir
+    };
+  }
+}
+
+/**
+ * Run multiple test tasks in sequence
+ * @param {Object} framework - Framework instance
+ * @param {Array} tasks - Array of task objects {name, description}
+ * @returns {Array} Array of test results
+ */
+export async function runTaskSequence(framework, tasks) {
+  const results = [];
+  
+  console.log(`\n🎯 Running ${tasks.length} tasks in sequence...\n`);
+  
+  for (let i = 0; i < tasks.length; i++) {
+    const task = tasks[i];
+    console.log(`\n📋 Task ${i + 1}/${tasks.length}: ${task.name}`);
+    
+    const result = await runTask(framework, task.description, task.name);
+    results.push(result);
+    
+    // Add delay between tasks if configured
+    if (AGENT_CONFIG.execution.stepDelay && i < tasks.length - 1) {
+      console.log(`⏱️ Waiting ${AGENT_CONFIG.execution.stepDelay}ms before next task...`);
+      await new Promise(resolve => setTimeout(resolve, AGENT_CONFIG.execution.stepDelay));
+    }
+  }
+  
+  // Print summary
+  const successful = results.filter(r => r.status === 'SUCCESS').length;
+  const failed = results.filter(r => r.status === 'FAILED').length;
+  
+  console.log(`\n📊 Task Sequence Summary:`);
+  console.log(`   ✅ Successful: ${successful}`);
+  console.log(`   ❌ Failed: ${failed}`);
+  console.log(`   📈 Success Rate: ${(successful / results.length * 100).toFixed(1)}%\n`);
+  
+  return results;
+}

package/framework/core/test-session.js

@@ -0,0 +1,98 @@
+// Endorphin e2e AI test framework>
+// Copyright (C)  2025 Redstudio Agency
+
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as
+// published by the Free Software Foundation, either version 3 of the
+// License, or (at your option) any later version.
+
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+
+import fs from 'fs';
+import path from 'path';
+
+/**
+ * Create a new test session with directory structure and metadata
+ * @param {string} testName - Name of the test
+ * @param {string} testId - Optional test ID
+ * @param {string} resultBaseDir - Base directory for test results
+ * @returns {Object} Test session object
+ */
+export function createTestSession(testName, testId = null, resultBaseDir) {
+  const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+  const sessionId = testId || `test-${Date.now()}`;
+  const sessionName = `${sessionId}_${timestamp}`;
+  const sessionDir = path.join(resultBaseDir, sessionName);
+  const screenshotsDir = path.join(sessionDir, 'screenshots');
+  
+  // Create directories
+  fs.mkdirSync(sessionDir, { recursive: true });
+  fs.mkdirSync(screenshotsDir, { recursive: true });
+  
+  const session = {
+    sessionId,
+    sessionName,
+    testName,
+    testId,
+    startTime: new Date().toISOString(),
+    endTime: null,
+    sessionDir,
+    screenshotsDir,
+    steps: [],
+    toolCalls: [],
+    stepCounter: 0,
+    screenshotCounter: 0,
+    status: 'RUNNING',
+    finalResult: null,
+    duration: null
+  };
+  
+  console.log(`📁 Created test session: ${sessionName}`);
+  return session;
+}
+
+/**
+ * Generate test session summary
+ * @param {Object} session - Test session object
+ * @returns {Object} Session summary
+ */
+export function generateSessionSummary(session) {
+  return {
+    testName: session.testName,
+    sessionId: session.sessionId,
+    status: session.status,
+    startTime: session.startTime,
+    endTime: session.endTime,
+    duration: session.duration,
+    totalSteps: session.steps.length,
+    successfulSteps: session.steps.filter(s => s.status === 'SUCCESS').length,
+    failedSteps: session.steps.filter(s => s.status === 'FAILED').length,
+    totalScreenshots: session.screenshotCounter,
+    finalResult: session.finalResult
+  };
+}
+
+/**
+ * Save test session data to files
+ * @param {Object} session - Test session object
+ */
+export function saveTestSession(session) {
+  // Save complete session data
+  const sessionFile = path.join(session.sessionDir, 'test-session.json');
+  fs.writeFileSync(sessionFile, JSON.stringify(session, null, 2));
+  
+  // Save summary
+  const summary = generateSessionSummary(session);
+  const summaryFile = path.join(session.sessionDir, 'summary.json');
+  fs.writeFileSync(summaryFile, JSON.stringify(summary, null, 2));
+  
+  console.log(`💾 Session data saved to: ${session.sessionDir}`);
+  return summary;
+}

package/framework/index.js

@@ -0,0 +1,44 @@
+// Endorphin e2e AI test framework>
+// Copyright (C)  2025 Redstudio Agency
+
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as
+// published by the Free Software Foundation, either version 3 of the
+// License, or (at your option) any later version.
+
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+export { EnhancedBrowserTestFramework } from './core/browser-framework.js';
+export { TestRecorder } from './core/test-recorder.js';
+export { runTask, runTaskSequence } from './core/test-runner.js';
+export { createTestSession, generateSessionSummary, saveTestSession } from './core/test-session.js';
+export { setupAgent } from './core/agent-setup.js';
+export { createAllTools } from './tools/index.js';
+export { TestManager } from './core/test-manager.js';
+
+// Configuration exports
+export { BROWSER_CONFIG } from './config/browser-config.js';
+export { AGENT_CONFIG } from './config/agent-config.js';
+export { PATHS } from './config/paths.js';
+
+// Module exports for organized components
+export * as Demos from './demos/index.js';
+export * as Interactive from './interactive/index.js';
+export * as Testing from './testing/index.js';
+
+// Individual tool creators for custom setups
+export { createNavigationTool } from './tools/navigation.js';
+export { createGetPageContentTool, createGetSimplePageContentTool } from './tools/content.js';
+export { createClickTool, createFillTool, createClearFieldTool } from './tools/interaction.js';
+export { createVerifyElementTool, createGetElementInfoTool } from './tools/verification.js';
+export { createWaitTool, createScreenshotTool } from './tools/utilities.js';
+
+// Default export for simple usage: import EndorphinAI from 'endorphin-ai'
+import { EnhancedBrowserTestFramework } from './core/browser-framework.js';
+export default EnhancedBrowserTestFramework;

package/framework/interactive/enhanced-interactive-recorder.js

@@ -0,0 +1,223 @@
+// Endorphin e2e AI test framework>
+// Copyright (C)  2025 Redstudio Agency
+
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as
+// published by the Free Software Foundation, either version 3 of the
+// License, or (at your option) any later version.
+
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+import { EnhancedBrowserTestFramework } from '../index.js';
+import { TestRecorder } from '../core/test-recorder.js';
+import readline from 'readline';
+import dotenv from 'dotenv';
+
+// Load environment variables
+dotenv.config();
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout
+});
+
+function askQuestion(question) {
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      resolve(answer);
+    });
+  });
+}
+
+async function collectTestData() {
+  console.log('\n📋 Test Data Collection');
+  console.log('═'.repeat(40));
+  
+  const testData = {};
+  
+  // Required fields
+  testData.id = await askQuestion('Test ID (e.g., QE-012): ');
+  testData.name = await askQuestion('Test Name: ');
+  testData.description = await askQuestion('Test Description: ');
+  
+  // Optional fields
+  const priority = await askQuestion('Priority (High/Medium/Low) [Medium]: ');
+  testData.priority = priority || 'Medium';
+  
+  const tags = await askQuestion('Tags (comma-separated): ');
+  testData.tags = tags ? tags.split(',').map(tag => tag.trim()) : [];
+  
+  // Site URL (use env variable as default)
+  const defaultSite = process.env.BASE_URL || 'https://qafromla.herokuapp.com/';
+  const site = await askQuestion(`Site URL [${defaultSite}]: `);
+  testData.site = site || defaultSite;
+  
+  // Collect test data object
+  console.log('\n🔧 Test Data (for form filling, login, etc.)');
+  console.log('Press Enter to skip any field');
+  
+  const testDataObj = {};
+  
+  const uid = await askQuestion('User ID: ');
+  if (uid) testDataObj.uid = uid;
+  
+  const email = await askQuestion('Email: ');
+  if (email) testDataObj.email = email;
+  
+  const password = await askQuestion('Password: ');
+  if (password) testDataObj.password = password;
+  
+  const firstName = await askQuestion('First Name: ');
+  if (firstName) testDataObj.firstName = firstName;
+  
+  const lastName = await askQuestion('Last Name: ');
+  if (lastName) testDataObj.lastName = lastName;
+  
+  // Add any additional custom fields
+  console.log('\nAdd custom fields (key=value format, or press Enter to finish):');
+  while (true) {
+    const customField = await askQuestion('Custom field (key=value): ');
+    if (!customField) break;
+    
+    const [key, ...valueParts] = customField.split('=');
+    const value = valueParts.join('=');
+    if (key && value) {
+      testDataObj[key.trim()] = value.trim();
+    }
+  }
+  
+  testData.testData = testDataObj;
+  
+  // Display collected data
+  console.log('\n📊 Collected Test Data:');
+  console.log('═'.repeat(40));
+  console.log(JSON.stringify(testData, null, 2));
+  
+  const confirm = await askQuestion('\nConfirm test data? (y/n): ');
+  if (confirm.toLowerCase() !== 'y') {
+    console.log('❌ Test data collection cancelled');
+    return null;
+  }
+  
+  return testData;
+}
+
+async function runInteractiveRecorder() {
+  console.log('\n🎬 Interactive Test Recorder');
+  console.log('═'.repeat(50));
+  console.log('Record browser interactions step by step!');
+  console.log('Commands:');
+  console.log('• Type natural language commands (e.g., "click login button")');
+  console.log('• Type "done" to stop recording and generate test');
+  console.log('• Each step will be recorded with screenshots');
+  console.log('═'.repeat(50));
+
+  // Collect test data first
+  const testData = await collectTestData();
+  if (!testData) {
+    console.log('👋 Exiting...');
+    rl.close();
+    return;
+  }
+
+  const framework = new EnhancedBrowserTestFramework();
+  const recorder = new TestRecorder(framework, testData);
+  
+  try {
+    // Initialize framework
+    console.log('\n🚀 Initializing browser...');
+    await framework.initialize();
+    
+    // Start recording
+    const recordingId = await recorder.startRecording();
+    
+    // Navigate to the site
+    console.log(`\n🌐 Navigating to: ${testData.site}`);
+    await framework.tools.navigate({ url: testData.site });
+    
+    // Record the navigation step
+    await recorder.recordStep(
+      `Navigate to ${testData.site}`,
+      'navigate',
+      { url: testData.site },
+      'Navigation completed'
+    );
+    
+    console.log('\n💬 Ready for interactive commands!');
+    console.log('Type your commands or "done" to finish recording.\n');
+    
+    // Interactive command loop
+    while (true) {
+      const prompt = await askQuestion('🎬 Next step: ');
+      
+      if (prompt.toLowerCase() === 'done') {
+        console.log('\n🛑 Stopping recording...');
+        break;
+      }
+      
+      if (!prompt.trim()) {
+        console.log('⚠️ Please enter a command or "done" to finish.');
+        continue;
+      }
+      
+      try {
+        // Execute the command using the framework's AI agent
+        console.log(`\n🤖 Processing: "${prompt}"`);
+        
+        // Use the AI agent to interpret and execute the command
+        const result = await framework.runTask(prompt, `Interactive-Step-${Date.now()}`);
+        
+        // Record this step
+        await recorder.recordStep(
+          prompt,
+          'ai-agent',
+          { command: prompt },
+          result.result || 'Command executed by AI agent'
+        );
+        
+        console.log(`✅ Step completed: ${result.result || 'Success'}`);
+        
+      } catch (error) {
+        console.log(`❌ Error executing command: ${error.message}`);
+        
+        // Still record the failed attempt
+        await recorder.recordStep(
+          prompt,
+          'error',
+          { error: error.message },
+          `Error: ${error.message}`
+        );
+      }
+    }
+    
+    // Stop recording and generate files
+    const recordingResult = await recorder.stopRecording();
+    
+    console.log('\n🎉 Recording Complete!');
+    console.log('═'.repeat(40));
+    console.log(`📁 Recording ID: ${recordingResult.recordingId}`);
+    console.log(`📂 Artifacts: ${recordingResult.recordingPath}`);
+    console.log(`🧪 Steps recorded: ${recordingResult.steps}`);
+    console.log(`📝 Test file generated in tests/ folder`);
+    
+  } catch (error) {
+    console.error(`💥 Error in interactive recorder: ${error.message}`);
+  } finally {
+    await framework.cleanup();
+    rl.close();
+      rl.close();
+  }
+}
+
+// Run the interactive recorder
+if (import.meta.url === `file://${process.argv[1]}`) {
+  runInteractiveRecorder().catch(console.error);
+}
+
+export { runInteractiveRecorder, collectTestData };

package/framework/interactive/index.js

@@ -0,0 +1,18 @@
+// Endorphin e2e AI test framework>
+// Copyright (C)  2025 Redstudio Agency
+
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as
+// published by the Free Software Foundation, either version 3 of the
+// License, or (at your option) any later version.
+
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+export { runInteractiveRecorder as EnhancedInteractiveRecorder } from './enhanced-interactive-recorder.js';
+// Note: interactive-test.js is deprecated and shows upgrade notice only

package/framework/interactive/interactive-test-clean.js

@@ -0,0 +1,33 @@
+// Endorphin e2e AI test framework>
+// Copyright (C)  2025 Redstudio Agency
+
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as
+// published by the Free Software Foundation, either version 3 of the
+// License, or (at your option) any later version.
+
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+// DEPRECATED: This file has been replaced by enhanced-interactive-recorder.js
+// This file is kept for backward compatibility
+
+console.log('\n⚠️  NOTICE: This interactive mode has been upgraded!');
+console.log('═'.repeat(60));
+console.log('🎬 Enhanced Interactive Test Recorder is now available');
+console.log('📝 Features: Step-by-step recording, test data collection, and more');
+console.log('');
+console.log('Please use:');
+console.log('  npm run interactive');
+console.log('');
+console.log('Or run directly:');
+console.log('  node framework/interactive/enhanced-interactive-recorder.js');
+console.log('═'.repeat(60));
+console.log('');
+
+process.exit(0);

package/framework/interactive/interactive-test.js

@@ -0,0 +1,33 @@
+// Endorphin e2e AI test framework>
+// Copyright (C)  2025 Redstudio Agency
+
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as
+// published by the Free Software Foundation, either version 3 of the
+// License, or (at your option) any later version.
+
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+// DEPRECATED: This file has been replaced by enhanced-interactive-recorder.js
+// This file is kept for backward compatibility
+
+console.log('\n⚠️  NOTICE: This interactive mode has been upgraded!');
+console.log('═'.repeat(60));
+console.log('🎬 Enhanced Interactive Test Recorder is now available');
+console.log('📝 Features: Step-by-step recording, test data collection, and more');
+console.log('');
+console.log('Please use:');
+console.log('  npm run interactive');
+console.log('');
+console.log('Or run directly:');
+console.log('  node framework/interactive/enhanced-interactive-recorder.js');
+console.log('═'.repeat(60));
+console.log('');
+
+process.exit(0);

package/framework/test-framework.js

@@ -0,0 +1,29 @@
+// Endorphin e2e AI test framework
+// Copyright (C)  2025 Redstudio Agency
+
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as
+// published by the Free Software Foundation, either version 3 of the
+// License, or (at your option) any later version.
+
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+import { EnhancedBrowserTestFramework } from './index.js';
+
+// Re-export the framework for compatibility
+export { EnhancedBrowserTestFramework };
+
+// Export test discovery functions for CLI
+export { 
+  runSingleTestById,
+  runTestsByTag, 
+  runTestsByPriority,
+  runAllTests,
+  listAllTests
+} from './core/test-discovery.js';

package/framework/testing/index.js

@@ -0,0 +1,15 @@
+// Endorphin e2e AI test framework>
+// Copyright (C)  2025 Redstudio Agency
+
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as
+// published by the Free Software Foundation, either version 3 of the
+// License, or (at your option) any later version.
+
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <http://www.gnu.org/licenses/>.