endorphin-ai 0.1.0

package/framework/tools/verification.js

@@ -0,0 +1,84 @@
+// 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 { tool } from '@langchain/core/tools';
+import { z } from 'zod';
+
+export function createVerifyElementTool(framework) {
+  return tool(async ({ selector, state = 'visible', timeout = 10000 }) => {
+    const stepDesc = `Verify ${selector} is ${state}`;
+    console.log(`🔍 ${stepDesc}`);
+    
+    try {
+      await framework.page.waitForSelector(selector, { state, timeout });
+      await framework.takeStepScreenshot(`Verified ${selector} is ${state}`);
+      
+      const result = `Element ${selector} is ${state} on the page`;
+      framework.logTestStep(stepDesc, 'verifyElement', { selector, state, timeout }, result, true);
+      return `✅ ${result}`;
+    } catch (error) {
+      await framework.takeStepScreenshot(`Failed to verify ${selector}`);
+      framework.logTestStep(stepDesc, 'verifyElement', { selector, state, timeout }, error.message, false);
+      return `❌ Could not verify element ${selector} as ${state}: ${error.message}`;
+    }
+  }, {
+    name: 'verifyElement',
+    description: 'Verify element exists and is in specified state.',
+    schema: z.object({
+      selector: z.string(),
+      state: z.enum(['visible', 'hidden', 'attached', 'detached']).optional(),
+      timeout: z.number().optional(),
+    })
+  });
+}
+
+export function createGetElementInfoTool(framework) {
+  return tool(async ({ selector }) => {
+    const stepDesc = `Get element info: ${selector}`;
+    console.log(`🔍 ${stepDesc}`);
+    
+    try {
+      await framework.page.waitForSelector(selector, { timeout: 5000 });
+      
+      const elementInfo = await framework.page.locator(selector).evaluate(el => ({
+        tagName: el.tagName,
+        id: el.id,
+        className: el.className,
+        textContent: el.textContent?.trim(),
+        value: el.value,
+        placeholder: el.placeholder,
+        type: el.type,
+        disabled: el.disabled,
+        visible: el.offsetParent !== null,
+        href: el.href,
+        src: el.src
+      }));
+      
+      const result = `Element info: ${JSON.stringify(elementInfo, null, 2)}`;
+      framework.logTestStep(stepDesc, 'getElementInfo', { selector }, result, true);
+      return result;
+    } catch (error) {
+      framework.logTestStep(stepDesc, 'getElementInfo', { selector }, error.message, false);
+      return `❌ Could not get info for ${selector}: ${error.message}`;
+    }
+  }, {
+    name: 'getElementInfo',
+    description: 'Get detailed information about any element.',
+    schema: z.object({
+      selector: z.string(),
+    })
+  });
+}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "endorphin-ai",
+  "version": "0.1.0",
+  "description": "E2E Testing Reinvented with AI - A powerful browser automation framework using AI-powered testing with LangChain, OpenAI GPT-4o, and Playwright",
+  "main": "framework/index.js",
+  "bin": {
+    "endorphin": "bin/endorphin.js"
+  },
+  "type": "module",
+  "scripts": {
+    "start": "node framework/test-framework.js",
+    "test": "vitest",
+    "test:watch": "vitest --watch",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage",
+    "framework:test": "node framework/test-framework.js --test",
+    "framework:demo": "node framework/test-framework.js",
+    "framework:all": "node framework/test-framework.js --all",
+    "framework:list": "node framework/test-framework.js --list",
+    "framework:comprehensive": "node framework/test-framework.js --comprehensive",
+    "framework:QE-001": "node framework/test-framework.js --test QE-001",
+    "framework:QE-002": "node framework/test-framework.js --test QE-002",
+    "framework:auth": "node framework/test-framework.js --tag authentication",
+    "framework:smoke": "node framework/test-framework.js --tag smoke",
+    "framework:high": "node framework/test-framework.js --priority High",
+    "verify-format": "node framework/testing/verify-test-format.js",
+    "test-recorder": "node framework/interactive/enhanced-interactive-recorder.js",
+    "test-recorder-demo": "node framework/demos/interactive-demo.js",
+    "test-framework": "node framework/testing/test-modular-framework.js"
+  },
+  "keywords": [
+    "ai",
+    "testing",
+    "e2e",
+    "automation",
+    "browser",
+    "playwright",
+    "langchain",
+    "openai",
+    "gpt-4",
+    "test-framework"
+  ],
+  "author": "Andrew Novykov <iam@andrewnovykov.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/andrewnovykov/endorphin-ai.git"
+  },
+  "homepage": "https://github.com/andrewnovykov/endorphin-ai#readme",
+  "bugs": {
+    "url": "https://github.com/andrewnovykov/endorphin-ai/issues"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "framework/",
+    "bin/",
+    "examples/",
+    "README.md",
+    "LICENSE.md",
+    "MIGRATION-GUIDE.md"
+  ],
+  "license": "AGPL-3.0-or-later",
+  "dependencies": {
+    "@langchain/community": "^0.3.31",
+    "@langchain/core": "^0.3.40",
+    "@langchain/langgraph": "^0.2.46",
+    "@modelcontextprotocol/sdk": "^1.13.0",
+    "@playwright/mcp": "^0.0.29",
+    "dotenv": "^16.4.7",
+    "langchain": "^0.3.19",
+    "openai": "^4.85.3",
+    "playwright": "^1.50.1",
+    "zod": "^3.25.67"
+  },
+  "directories": {
+    "doc": "doc",
+    "test": "tests"
+  },
+  "devDependencies": {
+    "vitest": "^2.1.8",
+    "@vitest/ui": "^2.1.8"
+  }
+}