@qualitas-id/mcp 1.0.0

package/dist/schemas/variable.d.ts

@@ -0,0 +1,91 @@
+import { z } from "zod";
+export declare const ListVariablesSchema: z.ZodObject<{
+    project_id: z.ZodString;
+    response_format: z.ZodDefault<z.ZodEnum<["markdown", "json"]>>;
+}, "strict", z.ZodTypeAny, {
+    response_format: "markdown" | "json";
+    project_id: string;
+}, {
+    project_id: string;
+    response_format?: "markdown" | "json" | undefined;
+}>;
+export declare const CreateVariableSchema: z.ZodObject<{
+    project_id: z.ZodString;
+    name: z.ZodString;
+    values: z.ZodObject<{
+        dev: z.ZodOptional<z.ZodString>;
+        staging: z.ZodOptional<z.ZodString>;
+        prod: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        dev?: string | undefined;
+        staging?: string | undefined;
+        prod?: string | undefined;
+    }, {
+        dev?: string | undefined;
+        staging?: string | undefined;
+        prod?: string | undefined;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    values: {
+        dev?: string | undefined;
+        staging?: string | undefined;
+        prod?: string | undefined;
+    };
+    name: string;
+    project_id: string;
+}, {
+    values: {
+        dev?: string | undefined;
+        staging?: string | undefined;
+        prod?: string | undefined;
+    };
+    name: string;
+    project_id: string;
+}>;
+export declare const UpdateVariableSchema: z.ZodObject<{
+    project_id: z.ZodString;
+    variable_id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    values: z.ZodOptional<z.ZodObject<{
+        dev: z.ZodOptional<z.ZodString>;
+        staging: z.ZodOptional<z.ZodString>;
+        prod: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        dev?: string | undefined;
+        staging?: string | undefined;
+        prod?: string | undefined;
+    }, {
+        dev?: string | undefined;
+        staging?: string | undefined;
+        prod?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    project_id: string;
+    variable_id: string;
+    values?: {
+        dev?: string | undefined;
+        staging?: string | undefined;
+        prod?: string | undefined;
+    } | undefined;
+    name?: string | undefined;
+}, {
+    project_id: string;
+    variable_id: string;
+    values?: {
+        dev?: string | undefined;
+        staging?: string | undefined;
+        prod?: string | undefined;
+    } | undefined;
+    name?: string | undefined;
+}>;
+export declare const DeleteVariableSchema: z.ZodObject<{
+    project_id: z.ZodString;
+    variable_id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    project_id: string;
+    variable_id: string;
+}, {
+    project_id: string;
+    variable_id: string;
+}>;
+//# sourceMappingURL=variable.d.ts.map

package/dist/schemas/variable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable.d.ts","sourceRoot":"","sources":["../../src/schemas/variable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,mBAAmB;;;;;;;;;EAGrB,CAAC;AAEZ,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQtB,CAAC;AAEZ,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAStB,CAAC;AAEZ,eAAO,MAAM,oBAAoB;;;;;;;;;EAGtB,CAAC"}

package/dist/schemas/variable.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { ResponseFormatSchema } from "./common.js";
+export const ListVariablesSchema = z.object({
+    project_id: z.string().uuid("Invalid project ID").describe("The project ID"),
+    response_format: ResponseFormatSchema,
+}).strict();
+export const CreateVariableSchema = z.object({
+    project_id: z.string().uuid("Invalid project ID").describe("The project ID"),
+    name: z.string().min(1, "Name is required").max(100).describe("Variable name (e.g., 'API_URL', 'TEST_PASSWORD')"),
+    values: z.object({
+        dev: z.string().optional().describe("Value for dev environment"),
+        staging: z.string().optional().describe("Value for staging environment"),
+        prod: z.string().optional().describe("Value for prod environment"),
+    }).describe("Environment-specific values"),
+}).strict();
+export const UpdateVariableSchema = z.object({
+    project_id: z.string().uuid("Invalid project ID").describe("The project ID"),
+    variable_id: z.string().uuid("Invalid variable ID").describe("The variable ID"),
+    name: z.string().min(1).max(100).optional().describe("New variable name"),
+    values: z.object({
+        dev: z.string().optional(),
+        staging: z.string().optional(),
+        prod: z.string().optional(),
+    }).optional().describe("Updated environment values"),
+}).strict();
+export const DeleteVariableSchema = z.object({
+    project_id: z.string().uuid("Invalid project ID").describe("The project ID"),
+    variable_id: z.string().uuid("Invalid variable ID").describe("The variable ID to delete"),
+}).strict();
+//# sourceMappingURL=variable.js.map

package/dist/schemas/variable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable.js","sourceRoot":"","sources":["../../src/schemas/variable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAC5E,eAAe,EAAE,oBAAoB;CACtC,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAC5E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IACjH,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QAChE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QACxE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;KACnE,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;CAC3C,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAC5E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAC/E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACzE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC5B,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;CACrD,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAC5E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;CAC1F,CAAC,CAAC,MAAM,EAAE,CAAC"}

package/dist/services/api-client.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Qualitas API Client
+ *
+ * HTTP client wrapping all Qualitas API endpoints with API key authentication.
+ * Used by all MCP tools to communicate with the Qualitas backend.
+ */
+import type { QualitasApiResponse, ProjectData, FlowData, RunData, RunStepData, VariableData } from "../types.js";
+/**
+ * Convert API errors into actionable, LLM-friendly messages.
+ */
+export declare function handleApiError(error: unknown): string;
+export declare class QualitasApiClient {
+    private client;
+    private maxRetries;
+    private retryDelay;
+    constructor(apiKey: string, baseUrl?: string, options?: {
+        maxRetries?: number;
+        retryDelay?: number;
+    });
+    private request;
+    listProjects(params?: {
+        page?: number;
+        limit?: number;
+        search?: string;
+        status?: string;
+        sort?: string;
+    }): Promise<QualitasApiResponse<ProjectData[]>>;
+    getProject(projectId: string): Promise<QualitasApiResponse<ProjectData>>;
+    createProject(data: {
+        name: string;
+        description?: string;
+        icon?: string;
+        icon_color?: string;
+        base_url?: string;
+    }): Promise<QualitasApiResponse<ProjectData>>;
+    updateProject(projectId: string, data: {
+        name?: string;
+        description?: string;
+        base_url?: string;
+    }): Promise<QualitasApiResponse<ProjectData>>;
+    listFlows(projectId: string, params?: {
+        page?: number;
+        limit?: number;
+        search?: string;
+        status?: string;
+    }): Promise<QualitasApiResponse<FlowData[]>>;
+    getFlow(projectId: string, flowId: string): Promise<QualitasApiResponse<FlowData>>;
+    createFlow(projectId: string, data: {
+        name: string;
+        description?: string;
+        type?: "flow" | "fragment";
+        environment?: string;
+        nodes: unknown[];
+        edges: unknown[];
+        variables?: unknown[];
+    }): Promise<QualitasApiResponse<FlowData>>;
+    updateFlow(projectId: string, flowId: string, data: {
+        name?: string;
+        description?: string;
+        environment?: string;
+        nodes?: unknown[];
+        edges?: unknown[];
+        variables?: unknown[];
+    }): Promise<QualitasApiResponse<FlowData>>;
+    deleteFlow(projectId: string, flowId: string): Promise<void>;
+    publishFlow(projectId: string, flowId: string): Promise<QualitasApiResponse<FlowData>>;
+    runFlow(projectId: string, flowId: string, config?: {
+        environment?: string;
+        headless?: boolean;
+        browser?: string;
+        viewport?: {
+            width: number;
+            height: number;
+        };
+    }): Promise<QualitasApiResponse<RunData>>;
+    getRunStatus(projectId: string, flowId: string, runId: string): Promise<QualitasApiResponse<RunData>>;
+    getRunSteps(runId: string): Promise<QualitasApiResponse<RunStepData[]>>;
+    listRuns(projectId: string, flowId: string, params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<QualitasApiResponse<RunData[]>>;
+    listVariables(projectId: string): Promise<QualitasApiResponse<VariableData[]>>;
+    createVariable(projectId: string, data: {
+        name: string;
+        values: {
+            dev?: string;
+            staging?: string;
+            prod?: string;
+        };
+    }): Promise<QualitasApiResponse<VariableData>>;
+    updateVariable(projectId: string, variableId: string, data: {
+        name?: string;
+        values?: {
+            dev?: string;
+            staging?: string;
+            prod?: string;
+        };
+    }): Promise<QualitasApiResponse<VariableData>>;
+    deleteVariable(projectId: string, variableId: string): Promise<void>;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/services/api-client.d.ts.map

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

package/dist/services/api-client.js

@@ -0,0 +1,184 @@
+/**
+ * Qualitas API Client
+ *
+ * HTTP client wrapping all Qualitas API endpoints with API key authentication.
+ * Used by all MCP tools to communicate with the Qualitas backend.
+ */
+import axios, { AxiosError } from "axios";
+import { API_BASE_URL } from "../constants.js";
+// ===========================================
+// Error Handling
+// ===========================================
+/**
+ * Convert API errors into actionable, LLM-friendly messages.
+ */
+export function handleApiError(error) {
+    if (error instanceof AxiosError) {
+        if (error.response) {
+            const status = error.response.status;
+            const body = error.response.data;
+            const apiMessage = body?.error?.message;
+            switch (status) {
+                case 401:
+                    return ("Error: Authentication failed. Your API key is invalid or expired. " +
+                        "Generate a new one from your Qualitas Developer Settings page " +
+                        "and update the QUALITAS_API_KEY environment variable.");
+                case 403:
+                    return ("Error: Access denied. You don't have permission to access this resource. " +
+                        "Ensure your API key has the required scope and you belong to the correct workspace.");
+                case 404:
+                    return ("Error: Resource not found. " +
+                        (apiMessage || "Please verify the ID is correct and the resource exists."));
+                case 422:
+                    return ("Error: Validation failed. " +
+                        (apiMessage || "Check your input parameters for invalid values.") +
+                        (body?.error?.details
+                            ? ` Details: ${JSON.stringify(body.error.details)}`
+                            : ""));
+                case 429:
+                    return ("Error: Rate limit exceeded. Too many requests. " +
+                        "Please wait a moment before trying again.");
+                default:
+                    return `Error: API request failed with status ${status}. ${apiMessage || "Please try again later."}`;
+            }
+        }
+        if (error.code === "ECONNABORTED" || error.code === "ETIMEDOUT") {
+            return "Error: Request timed out. The Qualitas API may be temporarily unavailable. Please try again.";
+        }
+        if (error.code === "ECONNREFUSED") {
+            return "Error: Connection refused. Please verify the QUALITAS_API_URL is correct.";
+        }
+        if (error.request) {
+            return "Error: No response received from the Qualitas API. Please check your network connection.";
+        }
+    }
+    return `Error: Unexpected error occurred: ${error instanceof Error ? error.message : String(error)}`;
+}
+// ===========================================
+// API Client Class
+// ===========================================
+export class QualitasApiClient {
+    client;
+    maxRetries;
+    retryDelay;
+    constructor(apiKey, baseUrl = API_BASE_URL, options) {
+        this.maxRetries = options?.maxRetries ?? 3;
+        this.retryDelay = options?.retryDelay ?? 1000;
+        this.client = axios.create({
+            baseURL: baseUrl,
+            timeout: 30000,
+            headers: {
+                "Content-Type": "application/json",
+                Accept: "application/json",
+                Authorization: `Bearer ${apiKey}`,
+            },
+        });
+    }
+    // -------------------------------------------
+    // Shared request method with retry logic
+    // -------------------------------------------
+    async request(method, path, data, params) {
+        // For DELETE with no body, remove Content-Type to avoid Fastify rejection
+        const extraHeaders = method === "DELETE" && !data
+            ? { "Content-Type": undefined }
+            : {};
+        let lastError = null;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            try {
+                const response = await this.client({
+                    method,
+                    url: path,
+                    data,
+                    params,
+                    headers: extraHeaders,
+                });
+                return response.data;
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                // Don't retry on client errors (4xx) except 429 (rate limit)
+                if (axios.isAxiosError(error) && error.response) {
+                    const status = error.response.status;
+                    if (status >= 400 && status < 500 && status !== 429) {
+                        throw error;
+                    }
+                }
+                // Don't retry on last attempt
+                if (attempt === this.maxRetries) {
+                    break;
+                }
+                // Wait before retrying (exponential backoff)
+                const delay = this.retryDelay * Math.pow(2, attempt);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+        }
+        throw lastError;
+    }
+    // ===========================================
+    // PROJECT METHODS
+    // ===========================================
+    async listProjects(params) {
+        return this.request("GET", "/projects", undefined, params);
+    }
+    async getProject(projectId) {
+        return this.request("GET", `/projects/${projectId}`);
+    }
+    async createProject(data) {
+        return this.request("POST", "/projects", data);
+    }
+    async updateProject(projectId, data) {
+        return this.request("PUT", `/projects/${projectId}`, data);
+    }
+    // ===========================================
+    // FLOW METHODS
+    // ===========================================
+    async listFlows(projectId, params) {
+        return this.request("GET", `/projects/${projectId}/flows`, undefined, params);
+    }
+    async getFlow(projectId, flowId) {
+        return this.request("GET", `/projects/${projectId}/flows/${flowId}`);
+    }
+    async createFlow(projectId, data) {
+        return this.request("POST", `/projects/${projectId}/flows`, data);
+    }
+    async updateFlow(projectId, flowId, data) {
+        return this.request("PUT", `/projects/${projectId}/flows/${flowId}`, data);
+    }
+    async deleteFlow(projectId, flowId) {
+        await this.request("DELETE", `/projects/${projectId}/flows/${flowId}`);
+    }
+    async publishFlow(projectId, flowId) {
+        return this.request("POST", `/projects/${projectId}/flows/${flowId}/publish`, {});
+    }
+    // ===========================================
+    // RUN METHODS
+    // ===========================================
+    async runFlow(projectId, flowId, config) {
+        return this.request("POST", `/projects/${projectId}/flows/${flowId}/run`, config);
+    }
+    async getRunStatus(projectId, flowId, runId) {
+        return this.request("GET", `/runs/${runId}`);
+    }
+    async getRunSteps(runId) {
+        return this.request("GET", `/runs/${runId}/steps`);
+    }
+    async listRuns(projectId, flowId, params) {
+        return this.request("GET", `/projects/${projectId}/flows/${flowId}/runs`, undefined, params);
+    }
+    // ===========================================
+    // VARIABLE METHODS
+    // ===========================================
+    async listVariables(projectId) {
+        return this.request("GET", `/projects/${projectId}/variables`);
+    }
+    async createVariable(projectId, data) {
+        return this.request("POST", `/projects/${projectId}/variables`, data);
+    }
+    async updateVariable(projectId, variableId, data) {
+        return this.request("PUT", `/projects/${projectId}/variables/${variableId}`, data);
+    }
+    async deleteVariable(projectId, variableId) {
+        await this.request("DELETE", `/projects/${projectId}/variables/${variableId}`);
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/services/api-client.js.map

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

package/dist/services/flow-generator.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 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.
+ */
+import type { FlowNode, FlowEdge, Variable } from "@qualitas-id/shared-types";
+export declare const NODE_REFERENCE = "## Available Flow Node Types (40 types)\n\nUse these node types when constructing flows. Each node has a `type` and a `data` object with type-specific fields.\nFields marked **required** must be provided. All others are optional.\n\nVariable references: Use `{{project.VAR_NAME}}` for project variables, `{{flow.VAR_NAME}}` for flow variables.\nSelectors: Use CSS selectors (e.g., `.btn-primary`, `#email-input`, `[data-testid=\"submit\"]`).\n\n---\n\n### Triggers\n\n| Type | Description | Required Fields | Optional Fields |\n|------|-------------|-----------------|-----------------|\n| `start` | Entry point of the flow (always first node) | _(none)_ | `label`, `description`, `timeout` |\n| `schedule` | Cron-based scheduled trigger | `cron` (string, e.g. \"0 9 * * 1-5\") | `description`, `timeout` |\n\n### Navigation\n\n| Type | Description | Required Fields | Optional Fields |\n|------|-------------|-----------------|-----------------|\n| `navigate` | Navigate to a URL | `url` (string) | `waitUntil` (\"load\" \\| \"domcontentloaded\" \\| \"networkidle\"), `description`, `timeout` |\n| `reload` | Reload the current page | _(none)_ | `waitUntil`, `description`, `timeout` |\n| `goBack` | Browser back navigation | _(none)_ | `description`, `timeout` |\n| `goForward` | Browser forward navigation | _(none)_ | `description`, `timeout` |\n\n### Mouse Actions\n\n| Type | Description | Required Fields | Optional Fields |\n|------|-------------|-----------------|-----------------|\n| `click` | Click an element | `selector` (string) | `button` (\"left\" \\| \"right\" \\| \"middle\"), `clickCount`, `position` ({x,y}), `description`, `timeout` |\n| `dblclick` | Double-click an element | `selector` | `position`, `description`, `timeout` |\n| `rightclick` | Right-click an element | `selector` | `position`, `description`, `timeout` |\n| `hover` | Hover over an element | `selector` | `position`, `description`, `timeout` |\n| `dragAndDrop` | Drag from source to target | `sourceSelector`, `targetSelector` | `description`, `timeout` |\n\n### Input\n\n| Type | Description | Required Fields | Optional Fields |\n|------|-------------|-----------------|-----------------|\n| `fill` | Fill a text input (replaces content) | `selector`, `text` | `description`, `timeout` |\n| `type` | Type text character by character | `selector`, `text` | `delay` (ms between keystrokes), `description`, `timeout` |\n| `clear` | Clear an input field | `selector` | `description`, `timeout` |\n| `press` | Press a keyboard key | `key` (e.g. \"Enter\", \"Tab\", \"Escape\", \"ArrowDown\") | `selector` (focus first), `modifiers` (array of \"ctrl\"/\"alt\"/\"shift\"/\"meta\"), `description`, `timeout` |\n\n### Form\n\n| Type | Description | Required Fields | Optional Fields |\n|------|-------------|-----------------|-----------------|\n| `submit` | Submit a form | `selector` | `description`, `timeout` |\n| `check` | Check a checkbox | `selector` | `description`, `timeout` |\n| `uncheck` | Uncheck a checkbox | `selector` | `description`, `timeout` |\n| `select` | Select dropdown option | `selector`, `value` | `byLabel` (boolean - select by visible label), `description`, `timeout` |\n| `upload` | Upload a file | `selector`, `filePath` | `description`, `timeout`. `filePath` can be: local path, URL (http/https), or base64 data URL |\n\n### Focus / Scroll\n\n| Type | Description | Required Fields | Optional Fields |\n|------|-------------|-----------------|-----------------|\n| `focus` | Focus an element | `selector` | `description`, `timeout` |\n| `blur` | Remove focus from element | `selector` | `description`, `timeout` |\n| `scroll` | Scroll the page or element | _(none)_ | `selector`, `x`, `y`, `behavior` (\"auto\" \\| \"smooth\"), `direction` (\"up\"/\"down\"/\"left\"/\"right\"), `amount`, `description`, `timeout` |\n| `scrollIntoView` | Scroll element into view | `selector` | `behavior`, `description`, `timeout` |\n\n### Wait / Sync\n\n| Type | Description | Required Fields | Optional Fields |\n|------|-------------|-----------------|-----------------|\n| `wait` | Wait for a duration | `duration` (ms) | `description`, `timeout` |\n| `waitForElement` | Wait for element state | `selector` | `state` (\"visible\" \\| \"hidden\" \\| \"attached\" \\| \"detached\"), `description`, `timeout` |\n| `waitForNavigation` | Wait for page navigation | _(none)_ | `url` (URL pattern), `description`, `timeout` |\n| `waitForResponse` | Wait for network response | `urlPattern` (string) | `method`, `statusCode`, `description`, `timeout` |\n\n### Assertions\n\n| Type | Description | Required Fields | Optional Fields |\n|------|-------------|-----------------|-----------------|\n| `assertVisible` | Assert element visibility | `selector` | `state` (\"visible\" \\| \"hidden\"), `description`, `timeout` |\n| `assertText` | Assert element text content | `selector`, `expectedText` | `exact` (boolean), `description`, `timeout` |\n| `assertValue` | Assert input value | `selector`, `expectedValue` | `description`, `timeout` |\n| `assertUrl` | Assert current URL | `expectedUrl` | `exact` (boolean), `description`, `timeout` |\n| `assertTitle` | Assert page title | `expectedTitle` | `exact` (boolean), `description`, `timeout` |\n| `assertVariable` | Assert variable comparison | `leftValue`, `operator`, `rightValue` | `description`, `timeout`. Operators: \"equals\", \"notEquals\", \"contains\", \"greaterThan\", \"lessThan\" |\n| `assertTableCell` | Assert table cell value | `tableSelector`, `findColumnName`, `findOperator`, `findValue`, `assertColumnName`, `assertOperator`, `expectedValue` | `description`, `timeout` |\n| `assertCount` | Assert element count | `selector`, `operator`, `expectedValue` (number) | `description`, `timeout`. Operators: \"equals\", \"greaterThan\", \"lessThan\" |\n\n### Utility\n\n| Type | Description | Required Fields | Optional Fields |\n|------|-------------|-----------------|-----------------|\n| `screenshot` | Take a screenshot | _(none)_ | `name`, `fullPage` (boolean), `description`, `timeout` |\n| `extractFromElement` | Extract data from element | `selector`, `extractType`, `saveAs` | `attributeName`, `trim`, `toNumber`, `regex`, `replace`, `description`, `timeout`. extractType: \"text\" \\| \"value\" \\| \"attribute\" \\| \"count\" |\n| `ifCondition` | Conditional branching | `saveResultAs` | `conditionType` (\"variable\" \\| \"element\"), `leftValue`, `operator`, `rightValue`, `selector`, `description`, `timeout` |\n| `loop` | Loop over items | `loopVariableName` | `loopType` (\"list\" \\| \"elements\"), `dataSource`, `selector`, `description`, `timeout` |\n| `executeScript` | Run custom JavaScript | `script` (string) | `description`, `timeout` |\n\n### Integration\n\n| Type | Description | Required Fields | Optional Fields |\n|------|-------------|-----------------|-----------------|\n| `apiCall` | Make an HTTP request | `method`, `url` | `headers` (array of {key, value, enabled}), `body`, `extractions` (array of {id, variableName, type, expression}), `description`, `timeout` |\n| `generateEmail` | Generate a test email | `outputKey` | `emailName`, `retentionMinutes`, `provider`, `localPartPrefix`, `description`, `timeout` |\n| `readEmail` | Read from email inbox | `inboxId`, `outputKey` | `generatedFrom`, `subjectContains`, `bodyContains`, `fromContains`, `timeoutMs`, `pollIntervalMs`, `description` |\n| `extractEmail` | Extract data from email | `source`, `variableName`, `pattern` | `readSourceNodeId`, `sourceField`, `extractionMode`, `flags`, `matchIndex`, `selector`, `selectorTarget`, `attributeName`, `description`, `timeout` |\n\n### Reusable\n\n| Type | Description | Required Fields | Optional Fields |\n|------|-------------|-----------------|-----------------|\n| `callFragment` | Call a reusable flow fragment | `fragmentId` | `fragmentName`, `description`, `timeout` |\n";
+interface GenerateFlowParams {
+    scenario: string;
+    name?: string;
+    environment?: string;
+}
+interface GeneratedFlow {
+    name: string;
+    nodes: FlowNode[];
+    edges: FlowEdge[];
+    variables: Variable[];
+}
+/**
+ * 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 declare function generateFlowFromScenario(params: GenerateFlowParams): GeneratedFlow;
+export {};
+//# sourceMappingURL=flow-generator.d.ts.map

package/dist/services/flow-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-generator.d.ts","sourceRoot":"","sources":["../../src/services/flow-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAgB,MAAM,2BAA2B,CAAC;AAO5F,eAAO,MAAM,cAAc,osPA8G1B,CAAC;AAMF,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AA6bD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,aAAa,CA+GlF"}