@qualitas-id/mcp 1.0.0

package/dist/services/flow-generator.js

@@ -0,0 +1,638 @@
+/**
+ * Flow Generator Service
+ *
+ * Generates Qualitas flow graphs from natural language scenarios.
+ * Maps scenario steps to appropriate node types and builds the
+ * full FlowNode/FlowEdge/Variable structure ready for the API.
+ */
+// ===========================================
+// NODE_REFERENCE - Comprehensive documentation of all 40 FlowNodeType values
+// Embedded in the MCP tool description so the AI knows what nodes are available.
+// ===========================================
+export const NODE_REFERENCE = `## Available Flow Node Types (40 types)
+
+Use these node types when constructing flows. Each node has a \`type\` and a \`data\` object with type-specific fields.
+Fields marked **required** must be provided. All others are optional.
+
+Variable references: Use \`{{project.VAR_NAME}}\` for project variables, \`{{flow.VAR_NAME}}\` for flow variables.
+Selectors: Use CSS selectors (e.g., \`.btn-primary\`, \`#email-input\`, \`[data-testid="submit"]\`).
+
+---
+
+### Triggers
+
+| Type | Description | Required Fields | Optional Fields |
+|------|-------------|-----------------|-----------------|
+| \`start\` | Entry point of the flow (always first node) | _(none)_ | \`label\`, \`description\`, \`timeout\` |
+| \`schedule\` | Cron-based scheduled trigger | \`cron\` (string, e.g. "0 9 * * 1-5") | \`description\`, \`timeout\` |
+
+### Navigation
+
+| Type | Description | Required Fields | Optional Fields |
+|------|-------------|-----------------|-----------------|
+| \`navigate\` | Navigate to a URL | \`url\` (string) | \`waitUntil\` ("load" \\| "domcontentloaded" \\| "networkidle"), \`description\`, \`timeout\` |
+| \`reload\` | Reload the current page | _(none)_ | \`waitUntil\`, \`description\`, \`timeout\` |
+| \`goBack\` | Browser back navigation | _(none)_ | \`description\`, \`timeout\` |
+| \`goForward\` | Browser forward navigation | _(none)_ | \`description\`, \`timeout\` |
+
+### Mouse Actions
+
+| Type | Description | Required Fields | Optional Fields |
+|------|-------------|-----------------|-----------------|
+| \`click\` | Click an element | \`selector\` (string) | \`button\` ("left" \\| "right" \\| "middle"), \`clickCount\`, \`position\` ({x,y}), \`description\`, \`timeout\` |
+| \`dblclick\` | Double-click an element | \`selector\` | \`position\`, \`description\`, \`timeout\` |
+| \`rightclick\` | Right-click an element | \`selector\` | \`position\`, \`description\`, \`timeout\` |
+| \`hover\` | Hover over an element | \`selector\` | \`position\`, \`description\`, \`timeout\` |
+| \`dragAndDrop\` | Drag from source to target | \`sourceSelector\`, \`targetSelector\` | \`description\`, \`timeout\` |
+
+### Input
+
+| Type | Description | Required Fields | Optional Fields |
+|------|-------------|-----------------|-----------------|
+| \`fill\` | Fill a text input (replaces content) | \`selector\`, \`text\` | \`description\`, \`timeout\` |
+| \`type\` | Type text character by character | \`selector\`, \`text\` | \`delay\` (ms between keystrokes), \`description\`, \`timeout\` |
+| \`clear\` | Clear an input field | \`selector\` | \`description\`, \`timeout\` |
+| \`press\` | Press a keyboard key | \`key\` (e.g. "Enter", "Tab", "Escape", "ArrowDown") | \`selector\` (focus first), \`modifiers\` (array of "ctrl"/"alt"/"shift"/"meta"), \`description\`, \`timeout\` |
+
+### Form
+
+| Type | Description | Required Fields | Optional Fields |
+|------|-------------|-----------------|-----------------|
+| \`submit\` | Submit a form | \`selector\` | \`description\`, \`timeout\` |
+| \`check\` | Check a checkbox | \`selector\` | \`description\`, \`timeout\` |
+| \`uncheck\` | Uncheck a checkbox | \`selector\` | \`description\`, \`timeout\` |
+| \`select\` | Select dropdown option | \`selector\`, \`value\` | \`byLabel\` (boolean - select by visible label), \`description\`, \`timeout\` |
+| \`upload\` | Upload a file | \`selector\`, \`filePath\` | \`description\`, \`timeout\`. \`filePath\` can be: local path, URL (http/https), or base64 data URL |
+
+### Focus / Scroll
+
+| Type | Description | Required Fields | Optional Fields |
+|------|-------------|-----------------|-----------------|
+| \`focus\` | Focus an element | \`selector\` | \`description\`, \`timeout\` |
+| \`blur\` | Remove focus from element | \`selector\` | \`description\`, \`timeout\` |
+| \`scroll\` | Scroll the page or element | _(none)_ | \`selector\`, \`x\`, \`y\`, \`behavior\` ("auto" \\| "smooth"), \`direction\` ("up"/"down"/"left"/"right"), \`amount\`, \`description\`, \`timeout\` |
+| \`scrollIntoView\` | Scroll element into view | \`selector\` | \`behavior\`, \`description\`, \`timeout\` |
+
+### Wait / Sync
+
+| Type | Description | Required Fields | Optional Fields |
+|------|-------------|-----------------|-----------------|
+| \`wait\` | Wait for a duration | \`duration\` (ms) | \`description\`, \`timeout\` |
+| \`waitForElement\` | Wait for element state | \`selector\` | \`state\` ("visible" \\| "hidden" \\| "attached" \\| "detached"), \`description\`, \`timeout\` |
+| \`waitForNavigation\` | Wait for page navigation | _(none)_ | \`url\` (URL pattern), \`description\`, \`timeout\` |
+| \`waitForResponse\` | Wait for network response | \`urlPattern\` (string) | \`method\`, \`statusCode\`, \`description\`, \`timeout\` |
+
+### Assertions
+
+| Type | Description | Required Fields | Optional Fields |
+|------|-------------|-----------------|-----------------|
+| \`assertVisible\` | Assert element visibility | \`selector\` | \`state\` ("visible" \\| "hidden"), \`description\`, \`timeout\` |
+| \`assertText\` | Assert element text content | \`selector\`, \`expectedText\` | \`exact\` (boolean), \`description\`, \`timeout\` |
+| \`assertValue\` | Assert input value | \`selector\`, \`expectedValue\` | \`description\`, \`timeout\` |
+| \`assertUrl\` | Assert current URL | \`expectedUrl\` | \`exact\` (boolean), \`description\`, \`timeout\` |
+| \`assertTitle\` | Assert page title | \`expectedTitle\` | \`exact\` (boolean), \`description\`, \`timeout\` |
+| \`assertVariable\` | Assert variable comparison | \`leftValue\`, \`operator\`, \`rightValue\` | \`description\`, \`timeout\`. Operators: "equals", "notEquals", "contains", "greaterThan", "lessThan" |
+| \`assertTableCell\` | Assert table cell value | \`tableSelector\`, \`findColumnName\`, \`findOperator\`, \`findValue\`, \`assertColumnName\`, \`assertOperator\`, \`expectedValue\` | \`description\`, \`timeout\` |
+| \`assertCount\` | Assert element count | \`selector\`, \`operator\`, \`expectedValue\` (number) | \`description\`, \`timeout\`. Operators: "equals", "greaterThan", "lessThan" |
+
+### Utility
+
+| Type | Description | Required Fields | Optional Fields |
+|------|-------------|-----------------|-----------------|
+| \`screenshot\` | Take a screenshot | _(none)_ | \`name\`, \`fullPage\` (boolean), \`description\`, \`timeout\` |
+| \`extractFromElement\` | Extract data from element | \`selector\`, \`extractType\`, \`saveAs\` | \`attributeName\`, \`trim\`, \`toNumber\`, \`regex\`, \`replace\`, \`description\`, \`timeout\`. extractType: "text" \\| "value" \\| "attribute" \\| "count" |
+| \`ifCondition\` | Conditional branching | \`saveResultAs\` | \`conditionType\` ("variable" \\| "element"), \`leftValue\`, \`operator\`, \`rightValue\`, \`selector\`, \`description\`, \`timeout\` |
+| \`loop\` | Loop over items | \`loopVariableName\` | \`loopType\` ("list" \\| "elements"), \`dataSource\`, \`selector\`, \`description\`, \`timeout\` |
+| \`executeScript\` | Run custom JavaScript | \`script\` (string) | \`description\`, \`timeout\` |
+
+### Integration
+
+| Type | Description | Required Fields | Optional Fields |
+|------|-------------|-----------------|-----------------|
+| \`apiCall\` | Make an HTTP request | \`method\`, \`url\` | \`headers\` (array of {key, value, enabled}), \`body\`, \`extractions\` (array of {id, variableName, type, expression}), \`description\`, \`timeout\` |
+| \`generateEmail\` | Generate a test email | \`outputKey\` | \`emailName\`, \`retentionMinutes\`, \`provider\`, \`localPartPrefix\`, \`description\`, \`timeout\` |
+| \`readEmail\` | Read from email inbox | \`inboxId\`, \`outputKey\` | \`generatedFrom\`, \`subjectContains\`, \`bodyContains\`, \`fromContains\`, \`timeoutMs\`, \`pollIntervalMs\`, \`description\` |
+| \`extractEmail\` | Extract data from email | \`source\`, \`variableName\`, \`pattern\` | \`readSourceNodeId\`, \`sourceField\`, \`extractionMode\`, \`flags\`, \`matchIndex\`, \`selector\`, \`selectorTarget\`, \`attributeName\`, \`description\`, \`timeout\` |
+
+### Reusable
+
+| Type | Description | Required Fields | Optional Fields |
+|------|-------------|-----------------|-----------------|
+| \`callFragment\` | Call a reusable flow fragment | \`fragmentId\` | \`fragmentName\`, \`description\`, \`timeout\` |
+`;
+// ===========================================
+// Scenario Parsing Helpers
+// ===========================================
+/** Map of keywords to node type detection */
+const NAVIGATION_KEYWORDS = [
+    "navigate", "go to", "open", "visit", "browse to", "load", "url",
+];
+const CLICK_KEYWORDS = [
+    "click", "tap", "press button", "select button", "hit", "push",
+];
+const DBLCLICK_KEYWORDS = [
+    "double click", "double-click", "dblclick",
+];
+const RIGHTCLICK_KEYWORDS = [
+    "right click", "right-click", "rightclick",
+];
+const HOVER_KEYWORDS = [
+    "hover", "mouse over", "mouse-over", "mouseover",
+];
+const FILL_KEYWORDS = [
+    "fill", "enter", "input", "type into", "type in", "fill in", "fill out",
+    "write", "provide", "specify",
+];
+const SELECT_KEYWORDS = [
+    "select", "choose", "pick", "dropdown",
+];
+const CHECK_KEYWORDS = [
+    "check", "tick", "enable", "turn on",
+];
+const UNCHECK_KEYWORDS = [
+    "uncheck", "untick", "disable", "turn off",
+];
+const SUBMIT_KEYWORDS = [
+    "submit", "send form", "post form",
+];
+const ASSERT_VISIBLE_KEYWORDS = [
+    "verify", "assert", "check that", "should see", "should display",
+    "expect", "confirm", "validate", "visible", "appears",
+];
+const ASSERT_TEXT_KEYWORDS = [
+    "text should be", "text is", "shows", "displays", "contains text",
+    "should say", "should read", "message",
+];
+const WAIT_KEYWORDS = [
+    "wait", "pause", "delay", "sleep",
+];
+const SCREENSHOT_KEYWORDS = [
+    "screenshot", "capture", "take screenshot", "take a screenshot",
+];
+const SCROLL_KEYWORDS = [
+    "scroll", "scroll down", "scroll up", "scroll to",
+];
+const LOGIN_KEYWORDS = [
+    "log in", "login", "sign in", "signin", "authenticate",
+];
+const NAVIGATE_URL_PATTERN = /(?:navigate|go|open|visit|browse)\s+(?:to\s+)?(https?:\/\/[^\s,;]+)/i;
+const URL_PATTERN = /(https?:\/\/[^\s,;]+)/i;
+const SELECTOR_PATTERN = /[.#][\w-]+|\[data-testid=["'][^"']+["']\]|(?:button|input|form|a|div|span|p|h[1-6]|select|textarea|label)\[?[^\]]*\]?/i;
+const VARIABLE_PATTERN = /\{\{(?:project|flow)\.[A-Z_]+\}\}/g;
+const DURATION_PATTERN = /(\d+)\s*(?:ms|milliseconds?|seconds?|s)/i;
+/**
+ * Extract a CSS selector from a step description.
+ * Tries explicit selectors first, then infers from common patterns.
+ */
+function extractSelector(step) {
+    // Look for explicit CSS selectors
+    const selectorMatch = step.match(SELECTOR_PATTERN);
+    if (selectorMatch)
+        return selectorMatch[0];
+    // Look for data-testid patterns
+    const testIdMatch = step.match(/(?:data-testid|testid|test-id)[\s=:]+["']?([\w-]+)["']?/i);
+    if (testIdMatch)
+        return `[data-testid="${testIdMatch[1]}"]`;
+    // Look for quoted element descriptions -> convert to common selectors
+    const quotedMatch = step.match(/["']([^"']+)["']/);
+    if (quotedMatch) {
+        const text = quotedMatch[1];
+        // Check for button-like text
+        if (/\b(btn|button|submit|cancel|save|delete|add|remove|close)\b/i.test(text)) {
+            return `button:has-text("${text}")`;
+        }
+        // Check for link-like text
+        if (/\b(link|href)\b/i.test(step) || step.includes("link")) {
+            return `a:has-text("${text}")`;
+        }
+        // Default to text selector
+        return `text="${text}"`;
+    }
+    // Infer from common UI element mentions
+    if (/\bemail\b/i.test(step))
+        return 'input[type="email"], input[name="email"], #email';
+    if (/\bpassword\b/i.test(step))
+        return 'input[type="password"], input[name="password"], #password';
+    if (/\busername\b/i.test(step))
+        return 'input[name="username"], #username';
+    if (/\bsearch\b/i.test(step))
+        return 'input[type="search"], input[name="search"], #search';
+    if (/\bform\b/i.test(step))
+        return "form";
+    if (/\bsubmit\b/i.test(step))
+        return 'button[type="submit"], button:has-text("Submit")';
+    // Default fallback
+    return "body";
+}
+/**
+ * Extract a URL from a step description.
+ */
+function extractUrl(step, variables) {
+    const navMatch = step.match(NAVIGATE_URL_PATTERN);
+    if (navMatch)
+        return navMatch[1];
+    const urlMatch = step.match(URL_PATTERN);
+    if (urlMatch)
+        return urlMatch[1];
+    // Check for variable references
+    const varMatches = step.match(VARIABLE_PATTERN);
+    if (varMatches && varMatches.length > 0)
+        return varMatches[0];
+    // Common URL patterns
+    if (/\bhomepage\b|\bhome page\b/i.test(step))
+        return "{{project.BASE_URL}}";
+    if (/\bdashboard\b/i.test(step))
+        return "{{project.BASE_URL}}/dashboard";
+    if (/\blogin\b|\bsign in\b/i.test(step))
+        return "{{project.BASE_URL}}/login";
+    return "{{project.BASE_URL}}";
+}
+/**
+ * Extract text to fill/type from a step description.
+ */
+function extractText(step) {
+    // Look for quoted text
+    const quotedMatch = step.match(/(?:with|text|value|content|input)\s*[:=]?\s*["']([^"']+)["']/i);
+    if (quotedMatch)
+        return quotedMatch[1];
+    // Look for email patterns
+    const emailMatch = step.match(/[\w.+-]+@[\w-]+\.[\w.]+/);
+    if (emailMatch)
+        return emailMatch[0];
+    // Look for variable references
+    const varMatch = step.match(/\{\{(?:project|flow)\.[A-Z_]+\}\}/);
+    if (varMatch)
+        return varMatch[0];
+    // Look for "with X" pattern
+    const withMatch = step.match(/with\s+(?:the\s+)?(?:text\s+)?["']?([^"']+?)["']?\s*(?:in|on|into|to|$)/i);
+    if (withMatch)
+        return withMatch[1].trim();
+    return "";
+}
+/**
+ * Extract a duration in ms from a step description.
+ */
+function extractDuration(step) {
+    const match = step.match(DURATION_PATTERN);
+    if (!match)
+        return 1000;
+    const value = parseInt(match[1], 10);
+    const unit = match[0].toLowerCase();
+    if (unit.includes("ms") || unit.includes("millisecond"))
+        return value;
+    return value * 1000; // seconds -> ms
+}
+/**
+ * Extract expected text from assertion steps.
+ */
+function extractExpectedText(step) {
+    const quotedMatch = step.match(/(?:should|expect|assert|verify|contains?|shows?|displays?)\s*[:=]?\s*["']([^"']+)["']/i);
+    if (quotedMatch)
+        return quotedMatch[1];
+    const textMatch = step.match(/text\s*[:=]?\s*["']([^"']+)["']/i);
+    if (textMatch)
+        return textMatch[1];
+    return "";
+}
+/**
+ * Classify a step and return the appropriate node type + data.
+ */
+function classifyStep(step, variables) {
+    const lower = step.toLowerCase().trim();
+    // --- Navigation ---
+    if (NAVIGATION_KEYWORDS.some((kw) => lower.includes(kw)) || URL_PATTERN.test(step)) {
+        return {
+            type: "navigate",
+            data: { url: extractUrl(step, variables), waitUntil: "load" },
+        };
+    }
+    // --- Login (composite pattern -> fill email, fill password, click submit) ---
+    // We handle this as a single navigate + fill + click in parseScenario
+    // --- Double Click ---
+    if (DBLCLICK_KEYWORDS.some((kw) => lower.includes(kw))) {
+        return { type: "dblclick", data: { selector: extractSelector(step) } };
+    }
+    // --- Right Click ---
+    if (RIGHTCLICK_KEYWORDS.some((kw) => lower.includes(kw))) {
+        return { type: "rightclick", data: { selector: extractSelector(step) } };
+    }
+    // --- Hover ---
+    if (HOVER_KEYWORDS.some((kw) => lower.includes(kw))) {
+        return { type: "hover", data: { selector: extractSelector(step) } };
+    }
+    // --- Submit ---
+    if (SUBMIT_KEYWORDS.some((kw) => lower.includes(kw))) {
+        return { type: "submit", data: { selector: extractSelector(step) } };
+    }
+    // --- Check/Uncheck ---
+    if (UNCHECK_KEYWORDS.some((kw) => lower.includes(kw))) {
+        return { type: "uncheck", data: { selector: extractSelector(step) } };
+    }
+    if (CHECK_KEYWORDS.some((kw) => lower.includes(kw))) {
+        return { type: "check", data: { selector: extractSelector(step) } };
+    }
+    // --- Select/Dropdown ---
+    if (SELECT_KEYWORDS.some((kw) => lower.includes(kw)) && (lower.includes("option") || lower.includes("dropdown") || lower.includes("from"))) {
+        const value = extractText(step);
+        return { type: "select", data: { selector: extractSelector(step), value, byLabel: true } };
+    }
+    // --- Fill/Input ---
+    if (FILL_KEYWORDS.some((kw) => lower.includes(kw))) {
+        const text = extractText(step);
+        return { type: "fill", data: { selector: extractSelector(step), text } };
+    }
+    // --- Click ---
+    if (CLICK_KEYWORDS.some((kw) => lower.includes(kw))) {
+        return { type: "click", data: { selector: extractSelector(step) } };
+    }
+    // --- Wait ---
+    if (WAIT_KEYWORDS.some((kw) => lower.includes(kw))) {
+        if (lower.includes("element") || lower.includes("appear") || lower.includes("visible")) {
+            return { type: "waitForElement", data: { selector: extractSelector(step), state: "visible" } };
+        }
+        if (lower.includes("navigation") || lower.includes("page load") || lower.includes("redirect")) {
+            return { type: "waitForNavigation", data: {} };
+        }
+        if (lower.includes("response") || lower.includes("api") || lower.includes("request")) {
+            return { type: "waitForResponse", data: { urlPattern: extractUrl(step, variables) || "**" } };
+        }
+        return { type: "wait", data: { duration: extractDuration(step) } };
+    }
+    // --- Screenshot ---
+    if (SCREENSHOT_KEYWORDS.some((kw) => lower.includes(kw))) {
+        const nameMatch = step.match(/(?:named?|called?)\s*["']([^"']+)["']/i);
+        return { type: "screenshot", data: { name: nameMatch?.[1], fullPage: lower.includes("full") } };
+    }
+    // --- Scroll ---
+    if (SCROLL_KEYWORDS.some((kw) => lower.includes(kw))) {
+        if (lower.includes("to") || lower.includes("into view") || lower.includes("element")) {
+            return { type: "scrollIntoView", data: { selector: extractSelector(step), behavior: "smooth" } };
+        }
+        const direction = lower.includes("up") ? "up" : lower.includes("left") ? "left" : lower.includes("right") ? "right" : "down";
+        return { type: "scroll", data: { direction, amount: 500 } };
+    }
+    // --- Assertions (after fill/click, so more specific matches take priority) ---
+    if (ASSERT_VISIBLE_KEYWORDS.some((kw) => lower.includes(kw))) {
+        // Check if it's a text assertion
+        const expectedText = extractExpectedText(step);
+        if (expectedText && (lower.includes("text") || lower.includes("shows") || lower.includes("displays") || lower.includes("contains") || lower.includes("says") || lower.includes("reads"))) {
+            return {
+                type: "assertText",
+                data: { selector: extractSelector(step), expectedText, exact: false },
+            };
+        }
+        // Check if it's a URL assertion
+        if (lower.includes("url") || lower.includes("redirected") || lower.includes("page is")) {
+            return { type: "assertUrl", data: { expectedUrl: extractUrl(step, variables) } };
+        }
+        // Check if it's a title assertion
+        if (lower.includes("title")) {
+            return { type: "assertTitle", data: { expectedTitle: expectedText || "" } };
+        }
+        // Default to visible assertion
+        return { type: "assertVisible", data: { selector: extractSelector(step), state: "visible" } };
+    }
+    // --- Upload ---
+    if (lower.includes("upload")) {
+        const fileMatch = step.match(/(?:file|path)\s*[:=]?\s*["']([^"']+)["']/i);
+        return { type: "upload", data: { selector: extractSelector(step), filePath: fileMatch?.[1] || "/tmp/upload.txt" } };
+    }
+    // --- Focus ---
+    if (lower.includes("focus")) {
+        return { type: "focus", data: { selector: extractSelector(step) } };
+    }
+    // --- Default: assume it's a click on something ---
+    return { type: "click", data: { selector: extractSelector(step) } };
+}
+/**
+ * Split a scenario description into discrete steps.
+ */
+function parseScenarioSteps(scenario) {
+    // Normalize line endings and clean up
+    const normalized = scenario
+        .replace(/\r\n/g, "\n")
+        .replace(/\t/g, " ")
+        .trim();
+    const steps = [];
+    // Try splitting by numbered steps: "1. ", "2. ", etc.
+    const numberedSteps = normalized.split(/\n\s*\d+[.)]\s*/);
+    if (numberedSteps.length > 1) {
+        for (const s of numberedSteps) {
+            const trimmed = s.trim();
+            if (trimmed)
+                steps.push(trimmed);
+        }
+        return steps;
+    }
+    // Try splitting by bullet points: "- ", "* ", "• "
+    const bulletSteps = normalized.split(/\n\s*[-*•]\s+/);
+    if (bulletSteps.length > 1) {
+        for (const s of bulletSteps) {
+            const trimmed = s.trim();
+            if (trimmed)
+                steps.push(trimmed);
+        }
+        return steps;
+    }
+    // Try splitting by newlines
+    const lineSteps = normalized.split(/\n+/);
+    if (lineSteps.length > 1) {
+        for (const s of lineSteps) {
+            const trimmed = s.trim();
+            if (trimmed)
+                steps.push(trimmed);
+        }
+        return steps;
+    }
+    // Try splitting by "and then", "then", ". " connectors
+    const connectorSteps = normalized.split(/\s*(?:,\s*then|;\s*then|\.\s*then|,\s*and then|\.\s*And|\. Then|,\s*then|\.\s*Next|\. After|\. Finally)\s*/i);
+    if (connectorSteps.length > 1) {
+        for (const s of connectorSteps) {
+            const trimmed = s.trim();
+            if (trimmed)
+                steps.push(trimmed);
+        }
+        return steps;
+    }
+    // Fall back to sentence splitting by period
+    const sentences = normalized.split(/\.\s+/);
+    for (const s of sentences) {
+        const trimmed = s.trim();
+        if (trimmed)
+            steps.push(trimmed.endsWith(".") ? trimmed : trimmed);
+    }
+    return steps;
+}
+/**
+ * Detect if a step describes a login pattern (composite action).
+ * Returns sub-steps if it's a login, or null otherwise.
+ */
+function detectLoginPattern(step) {
+    const lower = step.toLowerCase();
+    const isLogin = LOGIN_KEYWORDS.some((kw) => lower.includes(kw));
+    if (!isLogin)
+        return null;
+    const subSteps = [];
+    // Extract email/username
+    const emailMatch = step.match(/[\w.+-]+@[\w-]+\.[\w.]+/);
+    const usernameMatch = step.match(/(?:user\s*name|username|email)\s*[:=]?\s*["']?([^"',\s]+)["']?/i);
+    // Extract password
+    const passwordMatch = step.match(/(?:password|pwd|pass)\s*[:=]?\s*["']?([^"',\s]+)["']?/i);
+    // Determine login page URL
+    const urlMatch = step.match(URL_PATTERN);
+    if (urlMatch) {
+        subSteps.push(`Navigate to ${urlMatch[1]}`);
+    }
+    else {
+        subSteps.push("Navigate to login page");
+    }
+    const identifier = emailMatch?.[0] || usernameMatch?.[1] || "{{flow.USERNAME}}";
+    const password = passwordMatch?.[1] || "{{flow.PASSWORD}}";
+    subSteps.push(`Fill email/username field with "${identifier}"`);
+    subSteps.push(`Fill password field with "${password}"`);
+    subSteps.push("Click the login/submit button");
+    return subSteps;
+}
+/**
+ * Detect if a step describes a form-fill pattern (composite action).
+ */
+function detectFormFillPattern(step) {
+    const lower = step.toLowerCase();
+    if (!lower.includes("form") && !lower.includes("fill out") && !lower.includes("complete"))
+        return null;
+    // Extract field:value pairs
+    const fieldPattern = /(\w+)\s*[:=]\s*["']([^"']+)["']/gi;
+    const fields = [];
+    let match;
+    while ((match = fieldPattern.exec(step)) !== null) {
+        fields.push({ name: match[1], value: match[2] });
+    }
+    if (fields.length === 0)
+        return null;
+    return fields.map((f) => `Fill ${f.name} field with "${f.value}"`);
+}
+// ===========================================
+// Main Generator
+// ===========================================
+/**
+ * Generate a complete flow graph from a natural language scenario.
+ *
+ * @param params.scenario - Natural language description of the test steps
+ * @param params.name - Optional flow name (auto-generated from scenario if not provided)
+ * @param params.environment - Target environment (dev/staging/prod)
+ * @returns Generated flow with nodes, edges, and variables
+ */
+export function generateFlowFromScenario(params) {
+    const { scenario, name, environment = "dev" } = params;
+    // Parse scenario into steps
+    let rawSteps = parseScenarioSteps(scenario);
+    // Expand composite patterns (login, form fill)
+    const expandedSteps = [];
+    for (const step of rawSteps) {
+        const loginSteps = detectLoginPattern(step);
+        if (loginSteps) {
+            expandedSteps.push(...loginSteps);
+            continue;
+        }
+        const formSteps = detectFormFillPattern(step);
+        if (formSteps) {
+            expandedSteps.push(...formSteps);
+            continue;
+        }
+        expandedSteps.push(step);
+    }
+    // Extract variables referenced in the scenario
+    const variables = [];
+    const varSet = new Set();
+    const allVarMatches = scenario.match(VARIABLE_PATTERN);
+    if (allVarMatches) {
+        for (const v of allVarMatches) {
+            const varName = v.replace(/\{\{(?:project|flow)\./, "").replace(/\}\}/, "");
+            if (!varSet.has(varName)) {
+                varSet.add(varName);
+                variables.push({
+                    id: `var_${variables.length + 1}`,
+                    name: varName,
+                    scope: v.startsWith("{{project.") ? "project" : "flow",
+                    values: { dev: "", staging: "", prod: "" },
+                });
+            }
+        }
+    }
+    // Auto-detect common variables that might be needed
+    const lowerScenario = scenario.toLowerCase();
+    if ((lowerScenario.includes("email") || lowerScenario.includes("login") || lowerScenario.includes("sign in")) &&
+        !varSet.has("USERNAME") && !varSet.has("EMAIL")) {
+        variables.push({
+            id: `var_${variables.length + 1}`,
+            name: "USERNAME",
+            scope: "flow",
+            values: { dev: "", staging: "", prod: "" },
+        });
+    }
+    if ((lowerScenario.includes("password") || lowerScenario.includes("login") || lowerScenario.includes("sign in")) &&
+        !varSet.has("PASSWORD")) {
+        variables.push({
+            id: `var_${variables.length + 1}`,
+            name: "PASSWORD",
+            scope: "flow",
+            values: { dev: "", staging: "", prod: "" },
+        });
+    }
+    // Build nodes
+    const nodes = [];
+    const edges = [];
+    const X_CENTER = 250;
+    const Y_SPACING = 100;
+    // Always start with a start node
+    nodes.push({
+        id: "node_1",
+        type: "start",
+        position: { x: X_CENTER, y: 0 },
+        data: { label: name || "Generated Flow" },
+    });
+    // Generate nodes for each step
+    for (let i = 0; i < expandedSteps.length; i++) {
+        const step = expandedSteps[i];
+        const nodeId = `node_${i + 2}`; // +2 because start is node_1
+        const { type, data } = classifyStep(step, variables);
+        nodes.push({
+            id: nodeId,
+            type,
+            position: { x: X_CENTER, y: (i + 1) * Y_SPACING },
+            data: { ...data, description: step },
+        });
+    }
+    // Generate sequential edges
+    for (let i = 0; i < nodes.length - 1; i++) {
+        edges.push({
+            id: `edge_${i + 1}`,
+            source: nodes[i].id,
+            target: nodes[i + 1].id,
+        });
+    }
+    // Auto-generate flow name from scenario if not provided
+    const flowName = name || generateFlowName(scenario);
+    return {
+        name: flowName,
+        nodes,
+        edges,
+        variables,
+    };
+}
+/**
+ * Generate a concise flow name from the scenario text.
+ */
+function generateFlowName(scenario) {
+    // Take first ~60 chars and clean up
+    let name = scenario
+        .replace(/\n/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+    if (name.length > 60) {
+        name = name.substring(0, 57) + "...";
+    }
+    // Capitalize first letter
+    return name.charAt(0).toUpperCase() + name.slice(1);
+}
+//# sourceMappingURL=flow-generator.js.map