slapify 0.0.0

package/dist/ai/interpreter.js

@@ -0,0 +1,293 @@
+import { generateText } from "ai";
+import { createAnthropic } from "@ai-sdk/anthropic";
+import { createOpenAI } from "@ai-sdk/openai";
+import { createGoogleGenerativeAI } from "@ai-sdk/google";
+import { createMistral } from "@ai-sdk/mistral";
+import { createGroq } from "@ai-sdk/groq";
+/**
+ * Get the AI model based on config
+ */
+function getModel(config) {
+    switch (config.provider) {
+        case "anthropic": {
+            const anthropic = createAnthropic({ apiKey: config.api_key });
+            return anthropic(config.model);
+        }
+        case "openai": {
+            const openai = createOpenAI({ apiKey: config.api_key });
+            return openai(config.model);
+        }
+        case "google": {
+            const google = createGoogleGenerativeAI({ apiKey: config.api_key });
+            return google(config.model);
+        }
+        case "mistral": {
+            const mistral = createMistral({ apiKey: config.api_key });
+            return mistral(config.model);
+        }
+        case "groq": {
+            const groq = createGroq({ apiKey: config.api_key });
+            return groq(config.model);
+        }
+        case "ollama": {
+            // Ollama uses OpenAI-compatible API
+            const ollama = createOpenAI({
+                apiKey: "ollama", // Ollama doesn't need a real key
+                baseURL: config.base_url || "http://localhost:11434/v1",
+            });
+            return ollama(config.model);
+        }
+        default:
+            throw new Error(`Unsupported LLM provider: ${config.provider}`);
+    }
+}
+/**
+ * AI interpreter for converting natural language steps to browser actions
+ */
+export class AIInterpreter {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Interpret a step and generate browser commands
+     */
+    async interpretStep(step, browserState, credentials) {
+        const model = getModel(this.config);
+        const systemPrompt = `You are a browser automation assistant. Your job is to interpret natural language test steps and convert them to specific browser actions.
+
+You have access to a browser with the following current state:
+- URL: ${browserState.url}
+- Title: ${browserState.title}
+- Page snapshot (accessibility tree with refs):
+${browserState.snapshot}
+
+Available browser commands:
+- navigate(url) - Go to a URL
+- click(ref) - Click element by ref (e.g., @e1)
+- fill(ref, value) - Fill input field
+- type(ref, value) - Type text (append)
+- press(key) - Press keyboard key
+- hover(ref) - Hover over element
+- select(ref, value) - Select dropdown option
+- scroll(direction, amount?) - Scroll page
+- wait(ms) - Wait milliseconds
+- waitForText(text) - Wait for text to appear
+- getText(ref) - Get element text
+- screenshot(path?) - Take screenshot
+- goBack() - Navigate back
+- reload() - Reload page
+
+${credentials
+            ? `Available credentials profiles: ${Object.keys(credentials).join(", ")}`
+            : ""}
+
+Respond with a JSON object containing:
+{
+  "actions": [
+    { "command": "click", "args": ["@e5"], "description": "Click the login button" }
+  ],
+  "assumptions": ["Assumed 'login button' refers to the element labeled 'Sign In'"],
+  "needsCredentials": false,
+  "credentialProfile": null,
+  "skipReason": null,
+  "verified": false
+}
+
+IMPORTANT RULES:
+- For "Verify" steps: If the verification PASSES, set "verified": true and include a description in actions. Do NOT use skipReason for successful verifications.
+- skipReason should ONLY be used when a step cannot be completed or should be skipped (element not found, condition not met, etc.)
+- If the step is a verification and it passes based on current page state, that's a SUCCESS - set verified: true.
+- If the step is a verification and it fails, set skipReason to explain why it failed.`;
+        const userPrompt = `Interpret this test step and provide browser commands:
+
+Step: "${step.text}"
+${step.optional
+            ? "(This step is optional - can be skipped if not applicable)"
+            : ""}
+${step.conditional
+            ? `Condition: "${step.condition}" → Action: "${step.action}"`
+            : ""}`;
+        const response = await generateText({
+            model,
+            system: systemPrompt,
+            prompt: userPrompt,
+            maxTokens: 1000,
+        });
+        try {
+            // Extract JSON from response
+            const jsonMatch = response.text.match(/\{[\s\S]*\}/);
+            if (!jsonMatch) {
+                throw new Error("No JSON found in response");
+            }
+            const result = JSON.parse(jsonMatch[0]);
+            return {
+                actions: result.actions || [],
+                assumptions: result.assumptions || [],
+                needsCredentials: result.needsCredentials || false,
+                credentialProfile: result.credentialProfile || null,
+                skipReason: result.skipReason || null,
+            };
+        }
+        catch (error) {
+            // Fallback: try to parse as simple command
+            return {
+                actions: [],
+                assumptions: [],
+                needsCredentials: false,
+                credentialProfile: null,
+                skipReason: `Failed to interpret step: ${error}`,
+            };
+        }
+    }
+    /**
+     * Check for auto-handle opportunities (popups, banners, etc.)
+     */
+    async checkAutoHandle(browserState) {
+        const model = getModel(this.config);
+        const systemPrompt = `You are analyzing a webpage for common interruptions that should be automatically handled during test automation.
+
+Page snapshot:
+${browserState.snapshot}
+
+Look for these common interruptions:
+1. Cookie consent banners (GDPR, etc.)
+2. Newsletter signup popups
+3. "Allow notifications" prompts
+4. Chat widgets that might block content
+5. Age verification dialogs
+6. Promotional popups/modals
+7. "Sign up for deals" overlays
+
+IMPORTANT: When dismissing interruptions, ALWAYS prefer these buttons in order:
+- For cookie banners: "Accept", "Accept All", "Allow", "Agree", "OK", "Got it", "Save changes", close button (X)
+- NEVER click "Manage", "Customize", "Settings", "Preferences", "Learn more" as these open MORE dialogs
+- For popups/modals: Close button (X), "No thanks", "Maybe later", "Skip", "Dismiss"
+- For notifications: "Block", "Not now", "Later"
+
+The goal is to DISMISS/CLOSE the interruption with ONE click, not configure it.
+
+Respond with JSON:
+{
+  "interruptions": [
+    { "type": "cookie-banner", "ref": "@e15", "action": "click", "description": "Click Accept to dismiss cookie banner" }
+  ]
+}
+
+If no interruptions found, return: { "interruptions": [] }`;
+        const response = await generateText({
+            model,
+            system: systemPrompt,
+            prompt: "Analyze this page for interruptions to auto-handle.",
+            maxTokens: 500,
+        });
+        try {
+            const jsonMatch = response.text.match(/\{[\s\S]*\}/);
+            if (!jsonMatch)
+                return [];
+            const result = JSON.parse(jsonMatch[0]);
+            return result.interruptions || [];
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Analyze page to find login form for credentials injection
+     */
+    async findLoginForm(browserState) {
+        const model = getModel(this.config);
+        const systemPrompt = `You are analyzing a webpage to find login form elements.
+
+Page snapshot:
+${browserState.snapshot}
+
+Find:
+1. Username/email input field (ref)
+2. Password input field (ref)
+3. Submit/login button (ref)
+
+Respond with JSON:
+{
+  "found": true,
+  "usernameRef": "@e1",
+  "passwordRef": "@e2",
+  "submitRef": "@e3"
+}
+
+If no login form found: { "found": false }`;
+        const response = await generateText({
+            model,
+            system: systemPrompt,
+            prompt: "Find the login form elements on this page.",
+            maxTokens: 300,
+        });
+        try {
+            const jsonMatch = response.text.match(/\{[\s\S]*\}/);
+            if (!jsonMatch)
+                return null;
+            const result = JSON.parse(jsonMatch[0]);
+            if (!result.found)
+                return null;
+            return {
+                usernameRef: result.usernameRef,
+                passwordRef: result.passwordRef,
+                submitRef: result.submitRef,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Verify an assertion/condition on the page
+     */
+    async verifyCondition(condition, browserState) {
+        const model = getModel(this.config);
+        const systemPrompt = `You are verifying a condition on a webpage.
+
+Page URL: ${browserState.url}
+Page Title: ${browserState.title}
+Page snapshot:
+${browserState.snapshot}
+
+Respond with JSON:
+{
+  "satisfied": true,
+  "evidence": "Found the text 'Welcome' in heading @e5",
+  "suggestion": null
+}
+
+Or if not satisfied:
+{
+  "satisfied": false,
+  "evidence": "Could not find any element containing 'Welcome'",
+  "suggestion": "The page might still be loading, or the user might not be logged in"
+}`;
+        const response = await generateText({
+            model,
+            system: systemPrompt,
+            prompt: `Verify this condition: "${condition}"`,
+            maxTokens: 300,
+        });
+        try {
+            const jsonMatch = response.text.match(/\{[\s\S]*\}/);
+            if (!jsonMatch) {
+                return {
+                    satisfied: false,
+                    evidence: "Could not parse verification result",
+                };
+            }
+            const result = JSON.parse(jsonMatch[0]);
+            return {
+                satisfied: result.satisfied,
+                evidence: result.evidence,
+                suggestion: result.suggestion,
+            };
+        }
+        catch {
+            return { satisfied: false, evidence: "Verification failed" };
+        }
+    }
+}
+//# sourceMappingURL=interpreter.js.map

package/dist/ai/interpreter.js.map

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

package/dist/browser/agent.d.ts

@@ -0,0 +1,137 @@
+import { BrowserConfig, BrowserState, RefInfo } from "../types.js";
+/**
+ * Wrapper around agent-browser CLI
+ */
+export declare class BrowserAgent {
+    private config;
+    private isOpen;
+    constructor(config?: BrowserConfig);
+    /**
+     * Check if an error is transient and should be retried
+     */
+    private isTransientError;
+    /**
+     * Sleep for a given number of milliseconds
+     */
+    private sleep;
+    /**
+     * Execute an agent-browser command with auto-retry for transient errors
+     */
+    private exec;
+    /**
+     * Check if agent-browser is installed
+     */
+    static isInstalled(): boolean;
+    /**
+     * Install agent-browser and its browser
+     */
+    static install(): void;
+    /**
+     * Navigate to a URL
+     */
+    navigate(url: string): Promise<void>;
+    /**
+     * Get page snapshot (accessibility tree)
+     */
+    snapshot(interactive?: boolean): Promise<string>;
+    /**
+     * Get page snapshot as JSON with refs
+     */
+    snapshotJson(): Promise<{
+        snapshot: string;
+        refs: Record<string, RefInfo>;
+    }>;
+    /**
+     * Click an element by ref or selector
+     */
+    click(selector: string): Promise<void>;
+    /**
+     * Fill an input field
+     */
+    fill(selector: string, value: string): Promise<void>;
+    /**
+     * Type text (appends to existing value)
+     */
+    type(selector: string, value: string): Promise<void>;
+    /**
+     * Press a key
+     */
+    press(key: string): Promise<void>;
+    /**
+     * Hover over an element
+     */
+    hover(selector: string): Promise<void>;
+    /**
+     * Select dropdown option
+     */
+    select(selector: string, value: string): Promise<void>;
+    /**
+     * Scroll the page
+     */
+    scroll(direction: "up" | "down" | "left" | "right", amount?: number): Promise<void>;
+    /**
+     * Wait for various conditions
+     */
+    wait(condition: string | number): Promise<void>;
+    /**
+     * Take a screenshot
+     */
+    screenshot(path?: string, fullPage?: boolean): Promise<string>;
+    /**
+     * Get text content of an element
+     */
+    getText(selector: string): Promise<string>;
+    /**
+     * Get current URL
+     */
+    getUrl(): Promise<string>;
+    /**
+     * Get page title
+     */
+    getTitle(): Promise<string>;
+    /**
+     * Check if element is visible
+     */
+    isVisible(selector: string): Promise<boolean>;
+    /**
+     * Execute JavaScript
+     */
+    evaluate(script: string): Promise<string>;
+    /**
+     * Set cookies
+     */
+    setCookie(name: string, value: string): Promise<void>;
+    /**
+     * Set localStorage value
+     */
+    setLocalStorage(key: string, value: string): Promise<void>;
+    /**
+     * Set sessionStorage value
+     */
+    setSessionStorage(key: string, value: string): Promise<void>;
+    /**
+     * Go back
+     */
+    goBack(): Promise<void>;
+    /**
+     * Go forward
+     */
+    goForward(): Promise<void>;
+    /**
+     * Reload page
+     */
+    reload(): Promise<void>;
+    /**
+     * Close the browser
+     */
+    close(): Promise<void>;
+    /**
+     * Get current browser state (with graceful error handling)
+     */
+    getState(): Promise<BrowserState>;
+    /**
+     * Wait for page to be stable (no navigation in progress)
+     */
+    waitForStable(timeout?: number): Promise<void>;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/browser/agent.d.ts.map

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