mindheal 1.0.0

package/dist/esm/ai/bedrock-provider.js

@@ -0,0 +1,181 @@
+import { buildHealingPrompt, parseHealingResponse } from './prompt-templates.js';
+import { logger } from '../utils/logger.js';
+import { createHmac, createHash } from 'crypto';
+
+const DEFAULT_MODEL = 'anthropic.claude-3-haiku-20240307-v1:0';
+const DEFAULT_MAX_TOKENS = 1024;
+const DEFAULT_TEMPERATURE = 0.1;
+const DEFAULT_REGION = 'us-east-1';
+const BEDROCK_SERVICE = 'bedrock-runtime';
+const ANTHROPIC_BEDROCK_VERSION = 'bedrock-2023-05-31';
+const REQUEST_TIMEOUT_MS = 30000;
+// ─── Minimal AWS Signature V4 Implementation ──────────────────────────────────
+function sha256(data) {
+    return createHash('sha256').update(data).digest('hex');
+}
+function hmacSha256(key, data) {
+    return createHmac('sha256', key).update(data).digest();
+}
+function getSigningKey(secretKey, dateStamp, region, service) {
+    const kDate = hmacSha256(`AWS4${secretKey}`, dateStamp);
+    const kRegion = hmacSha256(kDate, region);
+    const kService = hmacSha256(kRegion, service);
+    const kSigning = hmacSha256(kService, 'aws4_request');
+    return kSigning;
+}
+function buildAwsV4Headers(params) {
+    const { method, host, path, body, region, service, accessKeyId, secretAccessKey, sessionToken } = params;
+    const now = new Date();
+    const amzDate = now.toISOString().replace(/[-:]/g, '').replace(/\.\d{3}Z$/, 'Z');
+    const dateStamp = amzDate.slice(0, 8);
+    const payloadHash = sha256(body);
+    const headers = {
+        'content-type': 'application/json',
+        'host': host,
+        'x-amz-date': amzDate,
+        'x-amz-content-sha256': payloadHash,
+    };
+    if (sessionToken) {
+        headers['x-amz-security-token'] = sessionToken;
+    }
+    // Canonical headers — must be sorted by lowercase header name
+    const signedHeaderKeys = Object.keys(headers).sort();
+    const canonicalHeaders = signedHeaderKeys.map((k) => `${k}:${headers[k]}\n`).join('');
+    const signedHeaders = signedHeaderKeys.join(';');
+    // Canonical request
+    const canonicalRequest = [
+        method,
+        path,
+        '', // query string (empty)
+        canonicalHeaders,
+        signedHeaders,
+        payloadHash,
+    ].join('\n');
+    // String to sign
+    const credentialScope = `${dateStamp}/${region}/${service}/aws4_request`;
+    const stringToSign = ['AWS4-HMAC-SHA256', amzDate, credentialScope, sha256(canonicalRequest)].join('\n');
+    // Signing key and signature
+    const signingKey = getSigningKey(secretAccessKey, dateStamp, region, service);
+    const signature = createHmac('sha256', signingKey).update(stringToSign).digest('hex');
+    // Authorization header
+    const authorization = `AWS4-HMAC-SHA256 Credential=${accessKeyId}/${credentialScope}, SignedHeaders=${signedHeaders}, Signature=${signature}`;
+    return {
+        ...headers,
+        'authorization': authorization,
+    };
+}
+// ─── Bedrock Provider ─────────────────────────────────────────────────────────
+class BedrockProvider {
+    constructor(config) {
+        this.name = 'aws-bedrock';
+        if (!config.awsAccessKeyId) {
+            throw new Error('[MindHeal] AWS access key ID is required for Bedrock provider');
+        }
+        if (!config.awsSecretAccessKey) {
+            throw new Error('[MindHeal] AWS secret access key is required for Bedrock provider');
+        }
+        this.region = config.awsRegion ?? DEFAULT_REGION;
+        this.accessKeyId = config.awsAccessKeyId;
+        this.secretAccessKey = config.awsSecretAccessKey;
+        this.sessionToken = config.awsSessionToken;
+        this.model = config.model ?? DEFAULT_MODEL;
+        this.maxTokens = config.maxTokens ?? DEFAULT_MAX_TOKENS;
+        this.temperature = config.temperature ?? DEFAULT_TEMPERATURE;
+    }
+    async suggestLocator(request) {
+        const fullPrompt = buildHealingPrompt(request);
+        const startTime = Date.now();
+        logger.debug('Bedrock API: sending healing request', {
+            model: this.model,
+            region: this.region,
+            originalLocator: request.originalLocator.selector,
+            pageUrl: request.pageUrl,
+        });
+        // Bedrock Anthropic models accept a single user message with the combined prompt.
+        // We do not split into system/user here because the Bedrock Anthropic invoke API
+        // uses the messages format where system is a top-level field, and keeping it
+        // simple with one user message is the most portable approach.
+        const requestBody = JSON.stringify({
+            anthropic_version: ANTHROPIC_BEDROCK_VERSION,
+            max_tokens: this.maxTokens,
+            temperature: this.temperature,
+            messages: [{ role: 'user', content: fullPrompt }],
+        });
+        const host = `${BEDROCK_SERVICE}.${this.region}.amazonaws.com`;
+        const path = `/model/${encodeURIComponent(this.model)}/invoke`;
+        const url = `https://${host}${path}`;
+        const headers = buildAwsV4Headers({
+            method: 'POST',
+            host,
+            path,
+            body: requestBody,
+            region: this.region,
+            service: BEDROCK_SERVICE,
+            accessKeyId: this.accessKeyId,
+            secretAccessKey: this.secretAccessKey,
+            sessionToken: this.sessionToken,
+        });
+        let responseData;
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+            const response = await fetch(url, {
+                method: 'POST',
+                headers,
+                body: requestBody,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (response.status === 429) {
+                const retryAfter = response.headers.get('retry-after');
+                const waitSeconds = retryAfter ? parseInt(retryAfter, 10) : 5;
+                logger.warn(`Bedrock 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;
+                const errorMessage = errorResp.message ?? errorResp.Message ?? response.statusText;
+                throw new Error(`Bedrock API error (${response.status}): ${errorMessage}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === 'AbortError') {
+                throw new Error(`[MindHeal] Bedrock API request timed out after ${REQUEST_TIMEOUT_MS}ms`);
+            }
+            if (error instanceof Error && error.message.startsWith('Bedrock API error')) {
+                throw new Error(`[MindHeal] ${error.message}`);
+            }
+            throw new Error(`[MindHeal] Bedrock API request failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        const successResp = responseData;
+        const textContent = successResp.content?.find((c) => c.type === 'text');
+        if (!textContent?.text) {
+            throw new Error('[MindHeal] Bedrock API returned empty response');
+        }
+        const duration = Date.now() - startTime;
+        logger.debug('Bedrock API: received response', {
+            model: this.model,
+            duration: `${duration}ms`,
+            inputTokens: successResp.usage?.input_tokens,
+            outputTokens: successResp.usage?.output_tokens,
+        });
+        try {
+            return parseHealingResponse(textContent.text);
+        }
+        catch (parseError) {
+            logger.error('Bedrock API: failed to parse response', {
+                rawText: textContent.text.slice(0, 500),
+                error: parseError instanceof Error ? parseError.message : String(parseError),
+            });
+            throw parseError;
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+export { BedrockProvider };
+//# sourceMappingURL=bedrock-provider.js.map

package/dist/esm/ai/bedrock-provider.js.map

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

package/dist/esm/ai/deepseek-provider.js

@@ -0,0 +1,116 @@
+import { buildHealingPrompt, parseHealingResponse } from './prompt-templates.js';
+import { logger } from '../utils/logger.js';
+
+const DEFAULT_MODEL = 'deepseek-chat';
+const DEFAULT_MAX_TOKENS = 1024;
+const DEFAULT_TEMPERATURE = 0;
+const DEFAULT_API_URL = 'https://api.deepseek.com/chat/completions';
+const REQUEST_TIMEOUT_MS = 30000;
+class DeepSeekProvider {
+    constructor(config) {
+        this.name = 'deepseek';
+        if (!config.apiKey) {
+            throw new Error('[MindHeal] DeepSeek 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 = buildHealingPrompt(request);
+        const startTime = Date.now();
+        logger.debug('DeepSeek 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.warn(`DeepSeek 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(`DeepSeek API error (${response.status}): ${errorResp.error?.message ?? response.statusText}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === 'AbortError') {
+                throw new Error(`[MindHeal] DeepSeek API request timed out after ${REQUEST_TIMEOUT_MS}ms`);
+            }
+            if (error instanceof Error && error.message.startsWith('DeepSeek API error')) {
+                throw new Error(`[MindHeal] ${error.message}`);
+            }
+            throw new Error(`[MindHeal] DeepSeek 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] DeepSeek API returned empty response');
+        }
+        const duration = Date.now() - startTime;
+        logger.debug('DeepSeek API: received response', {
+            model: successResp.model,
+            duration: `${duration}ms`,
+            promptTokens: successResp.usage.prompt_tokens,
+            completionTokens: successResp.usage.completion_tokens,
+        });
+        try {
+            return parseHealingResponse(choice.message.content);
+        }
+        catch (parseError) {
+            logger.error('DeepSeek 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));
+}
+
+export { DeepSeekProvider };
+//# sourceMappingURL=deepseek-provider.js.map

package/dist/esm/ai/deepseek-provider.js.map

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

package/dist/esm/ai/gemini-provider.js

@@ -0,0 +1,127 @@
+import { buildHealingPrompt, parseHealingResponse } from './prompt-templates.js';
+import { logger } from '../utils/logger.js';
+
+const DEFAULT_MODEL = 'gemini-2.0-flash';
+const DEFAULT_MAX_TOKENS = 1024;
+const DEFAULT_TEMPERATURE = 0.1;
+const DEFAULT_BASE_URL = 'https://generativelanguage.googleapis.com/v1beta';
+const REQUEST_TIMEOUT_MS = 30000;
+class GeminiProvider {
+    constructor(config) {
+        this.name = 'gemini';
+        if (!config.apiKey) {
+            throw new Error('[MindHeal] Gemini 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.baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
+        // Strip trailing slash for consistency
+        if (this.baseUrl.endsWith('/')) {
+            this.baseUrl = this.baseUrl.slice(0, -1);
+        }
+    }
+    async suggestLocator(request) {
+        const fullPrompt = buildHealingPrompt(request);
+        const startTime = Date.now();
+        logger.debug('Gemini 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 requestBody = {
+            systemInstruction: {
+                parts: [{ text: systemContent }],
+            },
+            contents: [
+                {
+                    role: 'user',
+                    parts: [{ text: userContent }],
+                },
+            ],
+            generationConfig: {
+                temperature: this.temperature,
+                maxOutputTokens: this.maxTokens,
+            },
+        };
+        const body = JSON.stringify(requestBody);
+        const url = `${this.baseUrl}/models/${this.model}:generateContent?key=${this.apiKey}`;
+        let responseData;
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                },
+                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.warn(`Gemini 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(`Gemini API error (${response.status}): ${errorResp.error?.message ?? response.statusText}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === 'AbortError') {
+                throw new Error(`[MindHeal] Gemini API request timed out after ${REQUEST_TIMEOUT_MS}ms`);
+            }
+            if (error instanceof Error && error.message.startsWith('Gemini API error')) {
+                throw new Error(`[MindHeal] ${error.message}`);
+            }
+            throw new Error(`[MindHeal] Gemini API request failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        const successResp = responseData;
+        const candidate = successResp.candidates?.[0];
+        const content = candidate?.content?.parts?.[0]?.text;
+        if (!content) {
+            throw new Error('[MindHeal] Gemini API returned empty response');
+        }
+        const duration = Date.now() - startTime;
+        logger.debug('Gemini API: received response', {
+            model: this.model,
+            duration: `${duration}ms`,
+            promptTokens: successResp.usageMetadata?.promptTokenCount,
+            completionTokens: successResp.usageMetadata?.candidatesTokenCount,
+        });
+        try {
+            return parseHealingResponse(content);
+        }
+        catch (parseError) {
+            logger.error('Gemini API: failed to parse response', {
+                rawText: content.slice(0, 500),
+                error: parseError instanceof Error ? parseError.message : String(parseError),
+            });
+            throw parseError;
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+export { GeminiProvider };
+//# sourceMappingURL=gemini-provider.js.map

package/dist/esm/ai/gemini-provider.js.map

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

package/dist/esm/ai/groq-provider.js

@@ -0,0 +1,116 @@
+import { buildHealingPrompt, parseHealingResponse } from './prompt-templates.js';
+import { logger } from '../utils/logger.js';
+
+const DEFAULT_MODEL = 'llama-3.3-70b-versatile';
+const DEFAULT_MAX_TOKENS = 1024;
+const DEFAULT_TEMPERATURE = 0;
+const DEFAULT_API_URL = 'https://api.groq.com/openai/v1/chat/completions';
+const REQUEST_TIMEOUT_MS = 30000;
+class GroqProvider {
+    constructor(config) {
+        this.name = 'groq';
+        if (!config.apiKey) {
+            throw new Error('[MindHeal] Groq 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 = buildHealingPrompt(request);
+        const startTime = Date.now();
+        logger.debug('Groq 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.warn(`Groq 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(`Groq API error (${response.status}): ${errorResp.error?.message ?? response.statusText}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === 'AbortError') {
+                throw new Error(`[MindHeal] Groq API request timed out after ${REQUEST_TIMEOUT_MS}ms`);
+            }
+            if (error instanceof Error && error.message.startsWith('Groq API error')) {
+                throw new Error(`[MindHeal] ${error.message}`);
+            }
+            throw new Error(`[MindHeal] Groq 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] Groq API returned empty response');
+        }
+        const duration = Date.now() - startTime;
+        logger.debug('Groq API: received response', {
+            model: successResp.model,
+            duration: `${duration}ms`,
+            promptTokens: successResp.usage.prompt_tokens,
+            completionTokens: successResp.usage.completion_tokens,
+        });
+        try {
+            return parseHealingResponse(choice.message.content);
+        }
+        catch (parseError) {
+            logger.error('Groq 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));
+}
+
+export { GroqProvider };
+//# sourceMappingURL=groq-provider.js.map

package/dist/esm/ai/groq-provider.js.map

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