userflow-mcp 0.2.0

package/dist/utils/actions.d.ts

@@ -0,0 +1,17 @@
+import type { Page } from "puppeteer-core";
+export interface ActionInput {
+    readonly type: string;
+    readonly target?: string;
+    readonly value?: string;
+    readonly scrollAmount?: number;
+}
+export interface ActionResult {
+    readonly success: boolean;
+    readonly error: string | null;
+}
+/**
+ * Execute an action on a Puppeteer page.
+ * Supports: click, type, scroll, scroll_up, navigate, select, hover, press_key, wait, read, give_up.
+ */
+export declare function executeAction(page: Page, action: ActionInput): Promise<ActionResult>;
+//# sourceMappingURL=actions.d.ts.map

package/dist/utils/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/utils/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAM3C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAiF1F"}

package/dist/utils/actions.js

@@ -0,0 +1,89 @@
+const DEFAULT_WAIT_TIMEOUT = 5000;
+const POST_ACTION_DELAY = 1500;
+const SCROLL_DELAY = 800;
+/**
+ * Execute an action on a Puppeteer page.
+ * Supports: click, type, scroll, scroll_up, navigate, select, hover, press_key, wait, read, give_up.
+ */
+export async function executeAction(page, action) {
+    try {
+        switch (action.type) {
+            case "click": {
+                if (!action.target)
+                    return { success: false, error: "click requires a target selector" };
+                await page.waitForSelector(action.target, { visible: true, timeout: DEFAULT_WAIT_TIMEOUT });
+                await page.click(action.target);
+                await new Promise((resolve) => setTimeout(resolve, POST_ACTION_DELAY));
+                return { success: true, error: null };
+            }
+            case "type": {
+                if (!action.target)
+                    return { success: false, error: "type requires a target selector" };
+                if (!action.value)
+                    return { success: false, error: "type requires a value" };
+                await page.waitForSelector(action.target, { visible: true, timeout: DEFAULT_WAIT_TIMEOUT });
+                await page.click(action.target, { count: 3 });
+                await page.type(action.target, action.value);
+                return { success: true, error: null };
+            }
+            case "scroll": {
+                const amount = action.scrollAmount ?? 500;
+                await page.evaluate((px) => window.scrollBy(0, px), amount);
+                await new Promise((resolve) => setTimeout(resolve, SCROLL_DELAY));
+                return { success: true, error: null };
+            }
+            case "scroll_up": {
+                const amount = action.scrollAmount ?? 500;
+                await page.evaluate((px) => window.scrollBy(0, -px), amount);
+                await new Promise((resolve) => setTimeout(resolve, SCROLL_DELAY));
+                return { success: true, error: null };
+            }
+            case "navigate": {
+                if (!action.value)
+                    return { success: false, error: "navigate requires a URL in value" };
+                await page.goto(action.value, { waitUntil: "networkidle2", timeout: 30_000 });
+                return { success: true, error: null };
+            }
+            case "select": {
+                if (!action.target)
+                    return { success: false, error: "select requires a target selector" };
+                if (!action.value)
+                    return { success: false, error: "select requires a value" };
+                await page.waitForSelector(action.target, { timeout: DEFAULT_WAIT_TIMEOUT });
+                await page.select(action.target, action.value);
+                return { success: true, error: null };
+            }
+            case "hover": {
+                if (!action.target)
+                    return { success: false, error: "hover requires a target selector" };
+                await page.waitForSelector(action.target, { visible: true, timeout: DEFAULT_WAIT_TIMEOUT });
+                await page.hover(action.target);
+                await new Promise((resolve) => setTimeout(resolve, 500));
+                return { success: true, error: null };
+            }
+            case "press_key": {
+                if (!action.value)
+                    return { success: false, error: "press_key requires a key name in value" };
+                await page.keyboard.press(action.value);
+                await new Promise((resolve) => setTimeout(resolve, 500));
+                return { success: true, error: null };
+            }
+            case "wait": {
+                const ms = action.scrollAmount ?? 2000;
+                await new Promise((resolve) => setTimeout(resolve, ms));
+                return { success: true, error: null };
+            }
+            case "read":
+            case "give_up": {
+                return { success: true, error: null };
+            }
+            default:
+                return { success: false, error: `Unknown action type: ${action.type}` };
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, error: message };
+    }
+}
+//# sourceMappingURL=actions.js.map

package/dist/utils/actions.js.map

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

package/dist/utils/browser.d.ts

@@ -0,0 +1,22 @@
+import { type Browser, type Page } from "puppeteer-core";
+/**
+ * Get or create a shared browser instance.
+ */
+export declare function getBrowser(): Promise<Browser>;
+/**
+ * Create a new page with the given viewport settings.
+ */
+export declare function createPage(width: number, height: number, deviceScaleFactor?: number): Promise<Page>;
+/**
+ * Navigate to a URL and wait for the page to be ready.
+ */
+export declare function navigateAndWait(page: Page, url: string, delay?: number): Promise<void>;
+/**
+ * Close a page safely.
+ */
+export declare function closePage(page: Page): Promise<void>;
+/**
+ * Shut down the shared browser instance.
+ */
+export declare function closeBrowser(): Promise<void>;
+//# sourceMappingURL=browser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/utils/browser.ts"],"names":[],"mappings":"AAAA,OAAkB,EAAE,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AA4DpE;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAoBnD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,iBAAiB,GAAE,MAAU,GAC5B,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,MAAU,GAChB,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzD;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CASlD"}

package/dist/utils/browser.js

@@ -0,0 +1,122 @@
+import puppeteer from "puppeteer-core";
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+let browserInstance = null;
+/**
+ * Find Chrome/Chromium executable on the system.
+ * Checks common installation paths across macOS, Linux, and Windows.
+ */
+function findChromePath() {
+    const envPath = process.env.CHROME_PATH || process.env.PUPPETEER_EXECUTABLE_PATH;
+    if (envPath && existsSync(envPath)) {
+        return envPath;
+    }
+    const paths = [
+        // macOS
+        "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+        "/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary",
+        "/Applications/Chromium.app/Contents/MacOS/Chromium",
+        "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
+        "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
+        // Linux
+        "/usr/bin/google-chrome",
+        "/usr/bin/google-chrome-stable",
+        "/usr/bin/chromium",
+        "/usr/bin/chromium-browser",
+        "/snap/bin/chromium",
+        // Windows (WSL)
+        "/mnt/c/Program Files/Google/Chrome/Application/chrome.exe",
+        "/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe",
+    ];
+    for (const chromePath of paths) {
+        if (existsSync(chromePath)) {
+            return chromePath;
+        }
+    }
+    try {
+        const result = execSync("which google-chrome || which chromium || which chromium-browser", {
+            encoding: "utf-8",
+            timeout: 5000,
+        }).trim();
+        if (result && existsSync(result)) {
+            return result;
+        }
+    }
+    catch {
+        // `which` failed
+    }
+    throw new Error("Could not find Chrome/Chromium. Install Google Chrome or set CHROME_PATH environment variable.\n" +
+        "  macOS: brew install --cask google-chrome\n" +
+        "  Linux: sudo apt install google-chrome-stable\n" +
+        "  Or set: export CHROME_PATH=/path/to/chrome");
+}
+/**
+ * Get or create a shared browser instance.
+ */
+export async function getBrowser() {
+    if (browserInstance && browserInstance.connected) {
+        return browserInstance;
+    }
+    const executablePath = findChromePath();
+    browserInstance = await puppeteer.launch({
+        executablePath,
+        headless: true,
+        args: [
+            "--no-sandbox",
+            "--disable-setuid-sandbox",
+            "--disable-dev-shm-usage",
+            "--disable-gpu",
+            "--disable-extensions",
+        ],
+    });
+    return browserInstance;
+}
+/**
+ * Create a new page with the given viewport settings.
+ */
+export async function createPage(width, height, deviceScaleFactor = 1) {
+    const browser = await getBrowser();
+    const page = await browser.newPage();
+    await page.setViewport({ width, height, deviceScaleFactor });
+    return page;
+}
+/**
+ * Navigate to a URL and wait for the page to be ready.
+ */
+export async function navigateAndWait(page, url, delay = 0) {
+    await page.goto(url, {
+        waitUntil: "networkidle2",
+        timeout: 30000,
+    });
+    if (delay > 0) {
+        await new Promise((resolve) => setTimeout(resolve, delay));
+    }
+}
+/**
+ * Close a page safely.
+ */
+export async function closePage(page) {
+    try {
+        if (!page.isClosed()) {
+            await page.close();
+        }
+    }
+    catch {
+        // Page may already be closed
+    }
+}
+/**
+ * Shut down the shared browser instance.
+ */
+export async function closeBrowser() {
+    if (browserInstance) {
+        try {
+            await browserInstance.close();
+        }
+        catch {
+            // Browser may already be closed
+        }
+        browserInstance = null;
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/utils/browser.js.map

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

package/dist/utils/page-snapshot.d.ts

@@ -0,0 +1,11 @@
+import type { Page } from "puppeteer-core";
+import type { PageSnapshot } from "../types.js";
+/**
+ * Extract a full snapshot of the current page state.
+ * Gathers all interactive elements, text content, headings, error messages, etc.
+ * Shared between session manager (step-by-step) and legacy flow walker (auto_walk).
+ */
+export declare function extractPageSnapshot(page: Page, options?: {
+    readonly fullPage?: boolean;
+}): Promise<PageSnapshot>;
+//# sourceMappingURL=page-snapshot.d.ts.map

package/dist/utils/page-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-snapshot.d.ts","sourceRoot":"","sources":["../../src/utils/page-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AAE7D;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GACxC,OAAO,CAAC,YAAY,CAAC,CA4GvB"}

package/dist/utils/page-snapshot.js

@@ -0,0 +1,102 @@
+/**
+ * Extract a full snapshot of the current page state.
+ * Gathers all interactive elements, text content, headings, error messages, etc.
+ * Shared between session manager (step-by-step) and legacy flow walker (auto_walk).
+ */
+export async function extractPageSnapshot(page, options) {
+    const startTime = Date.now();
+    const url = page.url();
+    const title = await page.title();
+    const pageData = await page.evaluate(() => {
+        const getSelector = (el) => {
+            if (el.id)
+                return `#${el.id}`;
+            if (el.getAttribute("data-testid"))
+                return `[data-testid="${el.getAttribute("data-testid")}"]`;
+            if (el.getAttribute("name"))
+                return `[name="${el.getAttribute("name")}"]`;
+            const tag = el.tagName.toLowerCase();
+            const classes = el.className && typeof el.className === "string"
+                ? "." + el.className.trim().split(/\s+/).slice(0, 2).join(".")
+                : "";
+            const parent = el.parentElement;
+            if (parent) {
+                const siblings = Array.from(parent.children).filter((c) => c.tagName === el.tagName);
+                if (siblings.length > 1) {
+                    const index = siblings.indexOf(el) + 1;
+                    return `${tag}${classes}:nth-of-type(${index})`;
+                }
+            }
+            return `${tag}${classes}`;
+        };
+        const isVisible = (el) => {
+            const style = window.getComputedStyle(el);
+            const rect = el.getBoundingClientRect();
+            return (style.display !== "none" &&
+                style.visibility !== "hidden" &&
+                style.opacity !== "0" &&
+                rect.width > 0 &&
+                rect.height > 0);
+        };
+        const toPageElement = (el) => {
+            const htmlEl = el;
+            return {
+                selector: getSelector(el),
+                tagName: el.tagName.toLowerCase(),
+                text: (el.textContent ?? "").trim().slice(0, 200),
+                type: htmlEl.type || undefined,
+                href: el.href || undefined,
+                isVisible: isVisible(el),
+                isInteractive: true,
+                ariaLabel: el.getAttribute("aria-label") || undefined,
+                placeholder: htmlEl.placeholder || undefined,
+            };
+        };
+        const buttons = Array.from(document.querySelectorAll("button, [role='button'], input[type='submit'], input[type='button']"))
+            .map(toPageElement);
+        const links = Array.from(document.querySelectorAll("a[href]"))
+            .filter((el) => {
+            const href = el.href;
+            return href && !href.startsWith("javascript:") && !href.startsWith("#");
+        })
+            .map(toPageElement);
+        const formFields = Array.from(document.querySelectorAll("input:not([type='hidden']):not([type='submit']):not([type='button']), textarea, select"))
+            .map(toPageElement);
+        const allInteractive = [...buttons, ...links, ...formFields];
+        const headings = Array.from(document.querySelectorAll("h1, h2, h3"))
+            .map((h) => (h.textContent ?? "").trim())
+            .filter((t) => t.length > 0);
+        const mainText = (document.body?.innerText ?? "").trim().slice(0, 500);
+        const errorSelectors = [
+            "[class*='error']", "[class*='Error']",
+            "[role='alert']", "[class*='danger']",
+            "[class*='warning']", ".toast-error",
+        ];
+        const errorMessages = errorSelectors.flatMap((sel) => Array.from(document.querySelectorAll(sel))
+            .map((el) => (el.textContent ?? "").trim())
+            .filter((t) => t.length > 0 && t.length < 300));
+        return { buttons, links, formFields, allInteractive, headings, mainText, errorMessages };
+    });
+    const screenshotBuffer = await page.screenshot({
+        type: "png",
+        fullPage: options?.fullPage ?? false,
+        encoding: "binary",
+    });
+    const screenshot = Buffer.from(screenshotBuffer).toString("base64");
+    const loadTimeMs = Date.now() - startTime;
+    return {
+        url,
+        title,
+        timestamp: new Date().toISOString(),
+        screenshot,
+        interactiveElements: pageData.allInteractive,
+        headings: pageData.headings,
+        mainText: pageData.mainText,
+        formFields: pageData.formFields,
+        links: pageData.links,
+        buttons: pageData.buttons,
+        errorMessages: pageData.errorMessages,
+        loadTimeMs,
+    };
+}
+//# sourceMappingURL=page-snapshot.js.map

package/dist/utils/page-snapshot.js.map

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

package/dist/walker/action-planner.d.ts

@@ -0,0 +1,15 @@
+import type { Persona, PageSnapshot, StepAction, EmotionalState, FrictionPoint, SessionStep } from "../types.js";
+/**
+ * Determine what emotional state this persona would feel on this page.
+ */
+export declare function assessEmotion(persona: Persona, page: PageSnapshot, previousSteps: readonly SessionStep[], frictionPoints: readonly FrictionPoint[]): EmotionalState;
+/**
+ * Detect friction points on the current page for this persona.
+ */
+export declare function detectFriction(persona: Persona, page: PageSnapshot, stepIndex: number): readonly FrictionPoint[];
+/**
+ * Plan the next action for a persona on the current page.
+ * Uses heuristic scoring based on persona goals and traits.
+ */
+export declare function planNextAction(persona: Persona, page: PageSnapshot, previousSteps: readonly SessionStep[]): StepAction;
+//# sourceMappingURL=action-planner.d.ts.map

package/dist/walker/action-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-planner.d.ts","sourceRoot":"","sources":["../../src/walker/action-planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAe,UAAU,EAAc,cAAc,EAAE,aAAa,EAAoB,WAAW,EAAE,MAAM,aAAa,CAAC;AAqC5J;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,YAAY,EAClB,aAAa,EAAE,SAAS,WAAW,EAAE,EACrC,cAAc,EAAE,SAAS,aAAa,EAAE,GACvC,cAAc,CA2BhB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,MAAM,GAChB,SAAS,aAAa,EAAE,CAwE1B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,YAAY,EAClB,aAAa,EAAE,SAAS,WAAW,EAAE,GACpC,UAAU,CA2EZ"}