mindheal 1.0.0

package/dist/cjs/ai/perplexity-provider.js

@@ -0,0 +1,118 @@
+'use strict';
+
+var promptTemplates = require('./prompt-templates.js');
+var logger = require('../utils/logger.js');
+
+const DEFAULT_MODEL = 'sonar-pro';
+const DEFAULT_MAX_TOKENS = 1024;
+const DEFAULT_TEMPERATURE = 0;
+const DEFAULT_API_URL = 'https://api.perplexity.ai/chat/completions';
+const REQUEST_TIMEOUT_MS = 30000;
+class PerplexityProvider {
+    constructor(config) {
+        this.name = 'perplexity';
+        if (!config.apiKey) {
+            throw new Error('[MindHeal] Perplexity API key is required');
+        }
+        this.apiKey = config.apiKey;
+        this.model = config.model ?? DEFAULT_MODEL;
+        this.maxTokens = config.maxTokens ?? DEFAULT_MAX_TOKENS;
+        this.temperature = config.temperature ?? DEFAULT_TEMPERATURE;
+        this.apiUrl = config.baseUrl ?? DEFAULT_API_URL;
+    }
+    async suggestLocator(request) {
+        const fullPrompt = promptTemplates.buildHealingPrompt(request);
+        const startTime = Date.now();
+        logger.logger.debug('Perplexity API: sending healing request', {
+            model: this.model,
+            originalLocator: request.originalLocator.selector,
+            pageUrl: request.pageUrl,
+        });
+        // Split the combined prompt into system + user messages at the separator
+        const separatorIndex = fullPrompt.indexOf('\n\n---\n\n');
+        let systemContent;
+        let userContent;
+        if (separatorIndex !== -1) {
+            systemContent = fullPrompt.slice(0, separatorIndex);
+            userContent = fullPrompt.slice(separatorIndex + 7); // length of '\n\n---\n\n'
+        }
+        else {
+            systemContent = 'You are an expert Playwright test engineer. Respond with only valid JSON.';
+            userContent = fullPrompt;
+        }
+        const messages = [
+            { role: 'system', content: systemContent },
+            { role: 'user', content: userContent },
+        ];
+        const body = JSON.stringify({
+            model: this.model,
+            max_tokens: this.maxTokens,
+            temperature: this.temperature,
+            messages,
+        });
+        let responseData;
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+            const response = await fetch(this.apiUrl, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    'authorization': `Bearer ${this.apiKey}`,
+                },
+                body,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (response.status === 429) {
+                const retryAfter = response.headers.get('retry-after');
+                const waitSeconds = retryAfter ? parseInt(retryAfter, 10) : 5;
+                logger.logger.warn(`Perplexity API: rate limited, retrying after ${waitSeconds}s`);
+                await sleep(waitSeconds * 1000);
+                return this.suggestLocator(request);
+            }
+            responseData = (await response.json());
+            if (!response.ok) {
+                const errorResp = responseData;
+                throw new Error(`Perplexity API error (${response.status}): ${errorResp.error?.message ?? response.statusText}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === 'AbortError') {
+                throw new Error(`[MindHeal] Perplexity API request timed out after ${REQUEST_TIMEOUT_MS}ms`);
+            }
+            if (error instanceof Error && error.message.startsWith('Perplexity API error')) {
+                throw new Error(`[MindHeal] ${error.message}`);
+            }
+            throw new Error(`[MindHeal] Perplexity API request failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        const successResp = responseData;
+        const choice = successResp.choices[0];
+        if (!choice?.message?.content) {
+            throw new Error('[MindHeal] Perplexity API returned empty response');
+        }
+        const duration = Date.now() - startTime;
+        logger.logger.debug('Perplexity API: received response', {
+            model: successResp.model,
+            duration: `${duration}ms`,
+            promptTokens: successResp.usage.prompt_tokens,
+            completionTokens: successResp.usage.completion_tokens,
+        });
+        try {
+            return promptTemplates.parseHealingResponse(choice.message.content);
+        }
+        catch (parseError) {
+            logger.logger.error('Perplexity API: failed to parse response', {
+                rawText: choice.message.content.slice(0, 500),
+                error: parseError instanceof Error ? parseError.message : String(parseError),
+            });
+            throw parseError;
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+exports.PerplexityProvider = PerplexityProvider;
+//# sourceMappingURL=perplexity-provider.js.map

package/dist/cjs/ai/perplexity-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perplexity-provider.js","sources":["../../../../src/ai/perplexity-provider.ts"],"sourcesContent":[null],"names":["buildHealingPrompt","logger","parseHealingResponse"],"mappings":"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"}

package/dist/cjs/ai/prompt-templates.js

@@ -0,0 +1,174 @@
+'use strict';
+
+const VALID_LOCATOR_TYPES = new Set([
+    'css', 'xpath', 'role', 'text', 'testid', 'label', 'placeholder', 'alttext', 'title',
+]);
+/**
+ * Builds a complete prompt for the AI provider to suggest a healed locator.
+ */
+function buildHealingPrompt(request) {
+    const systemPrompt = `You are an expert Playwright test engineer specializing in locator strategies.
+Your task is to analyze a broken Playwright locator and suggest a healed replacement based on the current DOM snapshot.
+
+LOCATOR BEST PRACTICES (follow in priority order):
+1. Prefer \`getByRole\` with accessible name — most resilient to DOM changes
+2. Prefer \`getByTestId\` when a data-testid attribute is present
+3. Prefer \`getByLabel\` for form inputs with associated labels
+4. Prefer \`getByPlaceholder\` for inputs with placeholder text
+5. Prefer \`getByText\` for elements with unique, stable visible text
+6. Prefer \`getByAltText\` for images with alt attributes
+7. Prefer \`getByTitle\` when title attribute is the best identifier
+8. Use CSS selectors only as a last resort
+9. Avoid XPath unless no other strategy is viable
+
+SPECIAL CONTEXTS:
+- MODALS/DIALOGS: If the element is inside a modal, dialog, popup, or overlay (look for \`dialog\`, \`role="dialog"\`, \`role="alertdialog"\`, \`aria-modal="true"\`, or classes like \`.modal\`), scope your locator to the modal context. Use \`page.getByRole('dialog').getByRole(...)\` or similar chaining to avoid matching elements behind the modal.
+- WEB TABLES: If the element is inside a \`<table>\`, consider using:
+  - \`page.getByRole('cell', { name: '...' })\` for specific cell content
+  - \`page.getByRole('row', { name: '...' }).getByRole('cell')\` for row+cell targeting
+  - \`page.locator('table >> tr:nth-child(N) >> td:nth-child(M)')\` for index-based access
+  - Column header text can help identify the right column
+- SHADOW DOM: If elements are inside shadow roots (\`#shadow-root\` markers in the snapshot), Playwright can pierce shadow DOM with CSS selectors or via \`page.locator('host-element').locator('inner-selector')\`
+- ENTERPRISE APPLICATIONS: If the DOM contains SAP (ui5-*, sap-*), Salesforce (lightning-*, force-*), ServiceNow (now-*, sn-*), or similar enterprise elements:
+  - NEVER rely on dynamically generated IDs (e.g., \`__xmlview0--\`, \`globalId_\`, \`auraId_\`). Use \`[id$="stablePart"]\` suffix matching instead.
+  - Prefer \`data-automation-id\`, \`data-testid\`, \`data-field\`, \`data-field-name\`, \`data-component-id\`, or \`data-control-name\` attributes.
+  - For SAP UI5, use \`[data-sap-ui]\` or \`[data-sap-ui-id]\` attributes.
+  - For Salesforce Lightning, prefer \`lightning-*\` custom element selectors with stable attributes.
+  - For ServiceNow, use \`[data-table-name]\`, \`[data-field-name]\`, or \`[data-element]\` attributes.
+
+IMPORTANT:
+- The playwrightExpression must be a valid Playwright locator call (e.g., \`page.getByRole('button', { name: 'Submit' })\`)
+- Confidence should be between 0 and 1 (1 = certainty, 0.5 = moderate guess)
+- Provide clear reasoning explaining why you chose this locator
+
+You MUST respond with ONLY a JSON object in this exact format (no markdown, no code fences):
+{
+  "selector": "<the selector value>",
+  "locatorType": "<one of: css, xpath, role, text, testid, label, placeholder, alttext, title>",
+  "confidence": <number between 0 and 1>,
+  "reasoning": "<brief explanation of why this locator was chosen>",
+  "playwrightExpression": "<full Playwright locator expression starting with page.>"
+}`;
+    const userPrompt = `A Playwright locator has broken. Please analyze the DOM and suggest a healed locator.
+
+BROKEN LOCATOR:
+- Type: ${request.originalLocator.type}
+- Selector: ${request.originalLocator.selector}
+- Playwright expression: ${request.originalLocator.playwrightExpression}
+
+ERROR MESSAGE:
+${request.errorMessage}
+
+PAGE URL: ${request.pageUrl}
+ACTION ATTEMPTED: ${request.action}
+
+CURRENT DOM SNAPSHOT:
+${request.domSnapshot}${request.nearbyElements ? `
+
+NEARBY ELEMENTS:
+${request.nearbyElements}` : ''}${request.ragContext && request.ragContext.length > 0 ? `
+
+PROJECT CONTEXT (from RAG knowledge base):
+${formatRAGContext(request.ragContext)}
+
+Use the above project context to make a more informed decision. For example:
+- If healing history shows a previous fix for a similar locator, prefer that pattern.
+- If page object metadata lists known selectors, use them.
+- If git changes show a recent rename, the new name is likely correct.
+- If component docs describe the expected structure, align with it.` : ''}
+
+Respond with ONLY the JSON object — no extra text.`;
+    return `${systemPrompt}\n\n---\n\n${userPrompt}`;
+}
+/**
+ * Parses the AI provider's raw text response into a structured AIHealingResponse.
+ * Handles malformed responses gracefully by attempting multiple extraction strategies.
+ */
+function parseHealingResponse(response) {
+    const trimmed = response.trim();
+    // Strategy 1: Try direct JSON parse
+    const directParsed = tryParseJSON(trimmed);
+    if (directParsed) {
+        return validateAndNormalize(directParsed);
+    }
+    // Strategy 2: Extract JSON from markdown code fences
+    const fenceMatch = trimmed.match(/```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/);
+    if (fenceMatch) {
+        const fenceParsed = tryParseJSON(fenceMatch[1].trim());
+        if (fenceParsed) {
+            return validateAndNormalize(fenceParsed);
+        }
+    }
+    // Strategy 3: Find first { ... } block in the response
+    const braceStart = trimmed.indexOf('{');
+    const braceEnd = trimmed.lastIndexOf('}');
+    if (braceStart !== -1 && braceEnd > braceStart) {
+        const extracted = trimmed.slice(braceStart, braceEnd + 1);
+        const extractedParsed = tryParseJSON(extracted);
+        if (extractedParsed) {
+            return validateAndNormalize(extractedParsed);
+        }
+    }
+    throw new Error(`[MindHeal] Failed to parse AI healing response. Raw response: ${trimmed.slice(0, 500)}`);
+}
+function tryParseJSON(text) {
+    try {
+        const parsed = JSON.parse(text);
+        if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function validateAndNormalize(data) {
+    const selector = extractString(data, 'selector');
+    if (!selector) {
+        throw new Error('[MindHeal] AI response missing required field: selector');
+    }
+    const playwrightExpression = extractString(data, 'playwrightExpression');
+    if (!playwrightExpression) {
+        throw new Error('[MindHeal] AI response missing required field: playwrightExpression');
+    }
+    const rawLocatorType = extractString(data, 'locatorType') ?? 'css';
+    const locatorType = VALID_LOCATOR_TYPES.has(rawLocatorType)
+        ? rawLocatorType
+        : 'css';
+    const rawConfidence = typeof data['confidence'] === 'number' ? data['confidence'] : 0.5;
+    const confidence = Math.max(0, Math.min(1, rawConfidence));
+    const reasoning = extractString(data, 'reasoning') ?? 'No reasoning provided by AI';
+    return {
+        selector,
+        locatorType,
+        confidence,
+        reasoning,
+        playwrightExpression,
+    };
+}
+function extractString(data, key) {
+    const value = data[key];
+    if (typeof value === 'string' && value.length > 0) {
+        return value;
+    }
+    return undefined;
+}
+/**
+ * Formats RAG context chunks into a readable section for the AI prompt.
+ */
+function formatRAGContext(chunks) {
+    return chunks
+        .map((chunk, i) => {
+        const header = `[${i + 1}] Source: ${chunk.source} (relevance: ${chunk.relevanceScore.toFixed(2)})`;
+        const meta = Object.entries(chunk.metadata)
+            .map(([k, v]) => `  ${k}: ${v}`)
+            .join('\n');
+        return `${header}\n${meta ? meta + '\n' : ''}${chunk.content}`;
+    })
+        .join('\n\n---\n\n');
+}
+
+exports.buildHealingPrompt = buildHealingPrompt;
+exports.parseHealingResponse = parseHealingResponse;
+//# sourceMappingURL=prompt-templates.js.map

package/dist/cjs/ai/prompt-templates.js.map

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

package/dist/cjs/ai/qwen-provider.js

@@ -0,0 +1,118 @@
+'use strict';
+
+var promptTemplates = require('./prompt-templates.js');
+var logger = require('../utils/logger.js');
+
+const DEFAULT_MODEL = 'qwen-plus';
+const DEFAULT_MAX_TOKENS = 1024;
+const DEFAULT_TEMPERATURE = 0;
+const DEFAULT_API_URL = 'https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions';
+const REQUEST_TIMEOUT_MS = 30000;
+class QwenProvider {
+    constructor(config) {
+        this.name = 'qwen';
+        if (!config.apiKey) {
+            throw new Error('[MindHeal] Qwen API key is required');
+        }
+        this.apiKey = config.apiKey;
+        this.model = config.model ?? DEFAULT_MODEL;
+        this.maxTokens = config.maxTokens ?? DEFAULT_MAX_TOKENS;
+        this.temperature = config.temperature ?? DEFAULT_TEMPERATURE;
+        this.apiUrl = config.baseUrl ?? DEFAULT_API_URL;
+    }
+    async suggestLocator(request) {
+        const fullPrompt = promptTemplates.buildHealingPrompt(request);
+        const startTime = Date.now();
+        logger.logger.debug('Qwen API: sending healing request', {
+            model: this.model,
+            originalLocator: request.originalLocator.selector,
+            pageUrl: request.pageUrl,
+        });
+        // Split the combined prompt into system + user messages at the separator
+        const separatorIndex = fullPrompt.indexOf('\n\n---\n\n');
+        let systemContent;
+        let userContent;
+        if (separatorIndex !== -1) {
+            systemContent = fullPrompt.slice(0, separatorIndex);
+            userContent = fullPrompt.slice(separatorIndex + 7); // length of '\n\n---\n\n'
+        }
+        else {
+            systemContent = 'You are an expert Playwright test engineer. Respond with only valid JSON.';
+            userContent = fullPrompt;
+        }
+        const messages = [
+            { role: 'system', content: systemContent },
+            { role: 'user', content: userContent },
+        ];
+        const body = JSON.stringify({
+            model: this.model,
+            max_tokens: this.maxTokens,
+            temperature: this.temperature,
+            messages,
+        });
+        let responseData;
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+            const response = await fetch(this.apiUrl, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    'authorization': `Bearer ${this.apiKey}`,
+                },
+                body,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (response.status === 429) {
+                const retryAfter = response.headers.get('retry-after');
+                const waitSeconds = retryAfter ? parseInt(retryAfter, 10) : 5;
+                logger.logger.warn(`Qwen API: rate limited, retrying after ${waitSeconds}s`);
+                await sleep(waitSeconds * 1000);
+                return this.suggestLocator(request);
+            }
+            responseData = (await response.json());
+            if (!response.ok) {
+                const errorResp = responseData;
+                throw new Error(`Qwen API error (${response.status}): ${errorResp.error?.message ?? response.statusText}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === 'AbortError') {
+                throw new Error(`[MindHeal] Qwen API request timed out after ${REQUEST_TIMEOUT_MS}ms`);
+            }
+            if (error instanceof Error && error.message.startsWith('Qwen API error')) {
+                throw new Error(`[MindHeal] ${error.message}`);
+            }
+            throw new Error(`[MindHeal] Qwen API request failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        const successResp = responseData;
+        const choice = successResp.choices[0];
+        if (!choice?.message?.content) {
+            throw new Error('[MindHeal] Qwen API returned empty response');
+        }
+        const duration = Date.now() - startTime;
+        logger.logger.debug('Qwen API: received response', {
+            model: successResp.model,
+            duration: `${duration}ms`,
+            promptTokens: successResp.usage.prompt_tokens,
+            completionTokens: successResp.usage.completion_tokens,
+        });
+        try {
+            return promptTemplates.parseHealingResponse(choice.message.content);
+        }
+        catch (parseError) {
+            logger.logger.error('Qwen API: failed to parse response', {
+                rawText: choice.message.content.slice(0, 500),
+                error: parseError instanceof Error ? parseError.message : String(parseError),
+            });
+            throw parseError;
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+exports.QwenProvider = QwenProvider;
+//# sourceMappingURL=qwen-provider.js.map

package/dist/cjs/ai/qwen-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qwen-provider.js","sources":["../../../../src/ai/qwen-provider.ts"],"sourcesContent":[null],"names":["buildHealingPrompt","logger","parseHealingResponse"],"mappings":"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"}