codemeld 2.1.0

package/dist/ai/agent.js

@@ -0,0 +1,289 @@
+/**
+ * AI Agent Client — OpenAI-compatible chat completions wrapper
+ * Uses the3rdacademy.com/api/chat/completions (no API key required)
+ * Uses native Node.js fetch — no curl dependency, no timeouts from external processes.
+ */
+const API_URL = 'https://the3rdacademy.com/api/chat/completions';
+const REQUEST_TIMEOUT_MS = 180_000; // 3 minutes — generous for large payloads
+const MAX_RETRIES = 3;
+const MAX_TOOL_RESULT_LEN = 12_000; // Prevent payload bloat from large tool outputs
+// ─── Helpers ──────────────────────────────────────────────────────────
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Truncate a tool result to prevent bloating the conversation payload.
+ */
+export function truncateToolResult(result, maxLen = MAX_TOOL_RESULT_LEN) {
+    if (result.length <= maxLen)
+        return result;
+    return result.slice(0, maxLen) + `\n\n... (truncated, ${result.length} total chars)`;
+}
+/**
+ * Sanitize an error — never leak API URLs, internal paths, or raw HTTP details.
+ */
+function sanitizeError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes('AbortError') || msg.includes('abort') || msg.includes('timed out') || msg.includes('timeout')) {
+        return new Error('AI request timed out. Please try again.');
+    }
+    if (msg.includes('ECONNREFUSED') || msg.includes('ENOTFOUND') || msg.includes('ECONNRESET') || msg.includes('fetch failed')) {
+        return new Error('Could not connect to AI service. Check your network connection.');
+    }
+    if (msg.includes('ECONNABORTED') || msg.includes('socket hang up')) {
+        return new Error('Connection to AI service was interrupted. Please try again.');
+    }
+    return new Error('AI request failed. Please try again.');
+}
+/**
+ * Check if an API error response is worth retrying (502/504/overloaded).
+ */
+function isRetryable(parsed) {
+    if (!parsed.error)
+        return false;
+    const errStr = typeof parsed.error === 'string' ? parsed.error : JSON.stringify(parsed.error);
+    return /50[2-4]|gateway|time-?out|overloaded|rate.?limit/i.test(errStr);
+}
+// ─── Native fetch POST ───────────────────────────────────────────────
+/**
+ * POST JSON to the API using native Node.js fetch.
+ * No curl dependency, no temp files, no ENAMETOOLONG, no shell limits.
+ */
+async function fetchPost(payload, timeoutMs = REQUEST_TIMEOUT_MS) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(API_URL, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: payload,
+            signal: controller.signal,
+        });
+        const text = await response.text();
+        if (!response.ok && !text.trim()) {
+            throw new Error(`HTTP ${response.status}`);
+        }
+        return text;
+    }
+    catch (err) {
+        throw sanitizeError(err);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+// ─── Chat Completion (non-streaming) ─────────────────────────────────
+/**
+ * Send a non-streaming chat completion request.
+ * Retries up to 3 times on server-side gateway errors with exponential backoff.
+ */
+export async function chatCompletion(request) {
+    const payload = JSON.stringify({
+        ...request,
+        stream: false,
+        direct_kilo: request.direct_kilo ?? true,
+        // Prevent server-side tool execution — all tools are client-side
+        disable_built_in_tools: true,
+        built_in_tools: [],
+    });
+    let lastError = null;
+    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+        if (attempt > 0) {
+            await sleep(Math.min(2000 * Math.pow(2, attempt - 1), 16000));
+        }
+        let body;
+        try {
+            body = await fetchPost(payload);
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err : new Error(String(err));
+            if (attempt < MAX_RETRIES)
+                continue;
+            throw lastError;
+        }
+        if (!body.trim()) {
+            lastError = new Error('AI service returned an empty response. Please try again.');
+            if (attempt < MAX_RETRIES)
+                continue;
+            throw lastError;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(body);
+        }
+        catch {
+            // Could be HTML error page from nginx — retryable
+            lastError = new Error('AI service returned an invalid response. Please try again.');
+            if (attempt < MAX_RETRIES)
+                continue;
+            throw lastError;
+        }
+        if (parsed.error) {
+            if (isRetryable(parsed) && attempt < MAX_RETRIES) {
+                lastError = new Error('AI service returned an error. Please try again later.');
+                continue;
+            }
+            throw new Error('AI service returned an error. Please try again later.');
+        }
+        return parsed;
+    }
+    throw lastError || new Error('AI request failed after retries. Please try again.');
+}
+// ─── Chat Completion (streaming) ─────────────────────────────────────
+/**
+ * Send a streaming chat completion request.
+ * Returns accumulated content and any tool calls.
+ */
+export async function chatCompletionStream(request, onEvent) {
+    const payload = JSON.stringify({
+        ...request,
+        stream: true,
+        direct_kilo: request.direct_kilo ?? true,
+        disable_built_in_tools: true,
+        built_in_tools: [],
+    });
+    const body = await fetchPost(payload);
+    let content = '';
+    const toolCalls = [];
+    let finishReason = '';
+    for (const line of body.split('\n')) {
+        if (!line.startsWith('data: ') || line === 'data: [DONE]')
+            continue;
+        let chunk;
+        try {
+            chunk = JSON.parse(line.slice(6));
+        }
+        catch {
+            continue;
+        }
+        const delta = chunk.choices[0]?.delta;
+        const reason = chunk.choices[0]?.finish_reason;
+        if (reason)
+            finishReason = reason;
+        if (delta?.content) {
+            content += delta.content;
+            onEvent?.({ type: 'token', content: delta.content });
+        }
+        if (delta?.custom_status) {
+            if (delta.custom_status.type === 'tool_start') {
+                onEvent?.({ type: 'tool_start', toolName: delta.custom_status.name });
+            }
+            else if (delta.custom_status.type === 'tool_done') {
+                onEvent?.({ type: 'tool_done', toolName: delta.custom_status.name });
+            }
+        }
+        if (delta?.tool_calls) {
+            for (const tc of delta.tool_calls) {
+                if (!toolCalls[tc.index]) {
+                    toolCalls[tc.index] = {
+                        id: tc.id || '',
+                        type: tc.type || 'function',
+                        function: { name: tc.function?.name || '', arguments: '' },
+                    };
+                }
+                if (tc.id)
+                    toolCalls[tc.index].id = tc.id;
+                if (tc.function?.name)
+                    toolCalls[tc.index].function.name = tc.function.name;
+                if (tc.function?.arguments)
+                    toolCalls[tc.index].function.arguments += tc.function.arguments;
+            }
+        }
+    }
+    if (finishReason === 'tool_calls') {
+        onEvent?.({ type: 'tool_calls', toolCalls: toolCalls.filter(Boolean) });
+    }
+    else {
+        onEvent?.({ type: 'done', content });
+    }
+    return { content, toolCalls: toolCalls.filter(Boolean), finishReason };
+}
+// ─── Agent Loop ──────────────────────────────────────────────────────
+/**
+ * Run a full agent loop: send messages, execute tool calls, repeat until done.
+ */
+export async function agentLoop(systemPrompt, userMessage, tools, toolExecutor, options = {}) {
+    const { maxSteps = 50, temperature = 0.3, onEvent, onStep } = options;
+    const messages = [
+        { role: 'system', content: systemPrompt },
+        { role: 'user', content: userMessage },
+    ];
+    let step = 0;
+    let finalContent = '';
+    let consecutiveCheckCalls = 0;
+    while (step < maxSteps) {
+        step++;
+        onStep?.(step, maxSteps, 'Thinking...');
+        const response = await chatCompletion({
+            messages,
+            tools,
+            temperature,
+            max_tokens: 16000,
+        });
+        const choice = response.choices[0];
+        const content = choice.message.content || '';
+        const toolCalls = choice.message.tool_calls || [];
+        const finishReason = choice.finish_reason;
+        if (content) {
+            onEvent?.({ type: 'token', content });
+        }
+        if (finishReason === 'stop' || toolCalls.length === 0) {
+            finalContent = content;
+            break;
+        }
+        messages.push({
+            role: 'assistant',
+            content: content || null,
+            tool_calls: toolCalls,
+        });
+        // Track tool usage patterns to detect loops
+        const toolNames = toolCalls.map(tc => tc.function.name);
+        const hasFileOp = toolNames.some(n => n === 'read_file' || n === 'write_file' || n === 'read_original_file' || n === 'list_files');
+        const hasCheckOp = toolNames.some(n => n === 'run_build' || n === 'run_typecheck');
+        if (hasCheckOp && !hasFileOp) {
+            consecutiveCheckCalls++;
+        }
+        else {
+            consecutiveCheckCalls = 0;
+        }
+        // Execute each tool call
+        for (const tc of toolCalls) {
+            const funcName = tc.function.name;
+            let args;
+            try {
+                args = JSON.parse(tc.function.arguments);
+            }
+            catch {
+                args = {};
+            }
+            onStep?.(step, maxSteps, `Executing ${funcName}...`);
+            let result;
+            try {
+                result = await toolExecutor(funcName, args);
+            }
+            catch (err) {
+                result = `Error: ${err instanceof Error ? err.message : String(err)}`;
+            }
+            // Truncate large tool results to prevent payload bloat
+            result = truncateToolResult(result);
+            messages.push({
+                role: 'tool',
+                tool_call_id: tc.id,
+                content: result,
+            });
+        }
+        // If AI is stuck in a check loop, inject a directive
+        if (consecutiveCheckCalls >= 2) {
+            messages.push({
+                role: 'user',
+                content: 'IMPORTANT: You have run build/typecheck multiple times without fixing any files. You MUST now call read_file on the first file that has errors, then call write_file with the fixed content. Do NOT call run_build or run_typecheck again until you have fixed at least one file.',
+            });
+            consecutiveCheckCalls = 0;
+        }
+    }
+    if (step >= maxSteps && !finalContent) {
+        finalContent = 'AI agent reached maximum steps without completing. The output may need manual review.';
+    }
+    return finalContent;
+}
+//# sourceMappingURL=agent.js.map

package/dist/ai/agent.js.map

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

package/dist/ai/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * AI Integration Module
+ * Exports the refinement loop and visual comparison utilities.
+ */
+export { runRefinement, type RefinementOptions, type RefinementResult } from './refinement-loop.js';
+export { compareScreenshots, buildVisualComparisonContext } from './visual-compare.js';
+export { agentLoop, chatCompletion, chatCompletionStream } from './agent.js';
+export { toolDefinitions, createToolExecutor } from './tools.js';
+export { FULL_REFINEMENT_PROMPT, BUILD_FIXER_PROMPT, COMPONENT_ENHANCER_PROMPT, VISUAL_COMPARISON_PROMPT, } from './prompts.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACpG,OAAO,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,cAAc,CAAC"}

package/dist/ai/index.js

@@ -0,0 +1,10 @@
+/**
+ * AI Integration Module
+ * Exports the refinement loop and visual comparison utilities.
+ */
+export { runRefinement } from './refinement-loop.js';
+export { compareScreenshots, buildVisualComparisonContext } from './visual-compare.js';
+export { agentLoop, chatCompletion, chatCompletionStream } from './agent.js';
+export { toolDefinitions, createToolExecutor } from './tools.js';
+export { FULL_REFINEMENT_PROMPT, BUILD_FIXER_PROMPT, COMPONENT_ENHANCER_PROMPT, VISUAL_COMPARISON_PROMPT, } from './prompts.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAiD,MAAM,sBAAsB,CAAC;AACpG,OAAO,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,cAAc,CAAC"}

package/dist/ai/prompts.d.ts

@@ -0,0 +1,35 @@
+/**
+ * System prompts for the AI refinement agent.
+ * Each prompt configures the AI for a specific phase of the refinement pipeline.
+ * Prompts are highly directive to ensure the AI model actually uses tools.
+ */
+/**
+ * Phase 1: Build Error Resolution
+ */
+export declare const BUILD_FIXER_PROMPT = "You are a React/TypeScript build fixer. You MUST use tools to fix build errors.\n\nCRITICAL \u2014 TOOL USAGE:\n- ONLY use the tools provided in the tools array of this conversation. NEVER use any built-in/internal/server-side tools.\n- When you need to read, write, or execute anything, ALWAYS return a tool_call. Never handle it internally.\n\nCRITICAL RULES \u2014 FOLLOW EXACTLY:\n1. You MUST call tools. Do NOT just describe what you would do. Actually DO it.\n2. After EVERY tool call that reveals errors, you MUST call read_file on the broken file.\n3. After reading a broken file, you MUST call write_file with a fixed version.\n4. After writing fixes, you MUST call run_build to verify.\n5. NEVER call run_typecheck or run_build more than twice in a row without calling read_file or write_file in between.\n\nYOUR EXACT WORKFLOW:\nStep 1: Call run_build to see errors.\nStep 2: Look at the error output. Pick the FIRST file with errors.\nStep 3: Call read_file on that file.\nStep 4: Fix ALL errors in that file. Call write_file with the corrected content.\nStep 5: Call run_build again to check.\nStep 6: If errors remain, go to Step 2. If build passes, call report_status with status \"success\".\n\nCOMMON FIXES:\n- \"Cannot find name 'X'\" where X is a function called in onClick/onChange handlers:\n  \u2192 Add a function definition above the return statement:\n    const X = () => { /* TODO: implement */ };\n  \u2192 Or if it's a state toggle like closeModal/openModal/toggleDropdown:\n    const [isOpen, setIsOpen] = useState(false);\n    const closeModal = () => setIsOpen(false);\n  \u2192 Make sure to add: import { useState } from 'react'; at the top\n\n- \"Type 'string' is not assignable to type 'number'\" for attributes like rows, cols:\n  \u2192 Change rows=\"5\" to rows={5}\n\n- \"Property 'value' does not exist on type 'EventTarget'\":\n  \u2192 Cast: (e.target as HTMLInputElement).value\n\n- Missing imports:\n  \u2192 Add the import statement at the top of the file\n\nREMEMBER: You MUST use tools. Call read_file and write_file. Do NOT just talk about what you would do.";
+/**
+ * Phase 2: Component Enhancement
+ */
+export declare const COMPONENT_ENHANCER_PROMPT = "You are a React developer. You MUST use tools to enhance components.\n\nCRITICAL \u2014 TOOL USAGE:\n- ONLY use the tools provided in the tools array. NEVER use any built-in/internal/server-side tools.\n\nCRITICAL: You MUST call read_file and write_file tools. Do NOT just describe changes.\n\nWORKFLOW:\n1. Call list_files on \"src/components\" to see all components.\n2. Call read_file on each component.\n3. Call read_original_file on the matching original HTML/JS file.\n4. Call write_file with improved React code.\n5. Call run_build to verify.\n\nCONVERT THESE PATTERNS:\n- document.getElementById() \u2192 useRef or state\n- element.innerHTML = '...' \u2192 JSX with state\n- element.classList.toggle('hidden') \u2192 conditional rendering with useState\n- addEventListener \u2192 JSX event props\n\nALWAYS call run_build after changes to verify nothing broke.";
+/**
+ * Phase 3: Visual Comparison
+ */
+export declare const VISUAL_COMPARISON_PROMPT = "You are a web developer. You MUST use tools to compare visuals.\n\nWORKFLOW:\n1. Call serve_and_screenshot on the original HTML directory.\n2. Call run_build to build the React project.\n3. Call serve_and_screenshot on the built React dist/ directory.\n4. Compare the screenshots and fix visual differences.\n5. Call report_status with your findings.\n\nFocus on: missing sections, broken layout, missing styles, broken images.";
+/**
+ * Combined full refinement prompt.
+ * This is intentionally very directive because the AI model needs explicit instructions.
+ */
+export declare const FULL_REFINEMENT_PROMPT = "You are a build-fixing AI. Your ONLY job is to make this React project build successfully.\n\n=== CRITICAL INSTRUCTIONS ===\nYou MUST use tools. You MUST call read_file and write_file.\nDo NOT just run run_typecheck or run_build repeatedly without fixing files.\nDo NOT describe what you would do \u2014 actually DO it by calling tools.\n\n=== YOUR EXACT PROCESS ===\n\nSTEP 1: Call run_build right now.\n\nSTEP 2: Read the build output. Find the FIRST file that has errors.\n  \u2192 Call read_file with that file path (e.g., \"src/components/IndexPage.tsx\").\n\nSTEP 3: Fix ALL errors in that file.\n  \u2192 Call write_file with the complete fixed file content.\n\nSTEP 4: Call run_build again to check progress.\n\nSTEP 5: If there are still errors, go back to STEP 2.\n  If the build passes, call report_status with status \"success\".\n\n=== FIXING PATTERNS ===\n\nERROR: \"Cannot find name 'someFunction'\"\nFIX: Add a stub function before the return statement:\n  const someFunction = () => { /* TODO */ };\n  If it's a modal/dropdown toggle, use useState:\n    const [isOpen, setIsOpen] = useState(false);\n    const toggleSomething = () => setIsOpen(!isOpen);\n  IMPORTANT: Add \"import { useState } from 'react';\" if using useState.\n\nERROR: \"Type 'string' is not assignable to type 'number'\"\nFIX: Change attribute=\"5\" to attribute={5} for numeric attributes.\n\nERROR: \"Property 'value' does not exist on type 'EventTarget'\"\nFIX: Cast to (e.target as HTMLInputElement).value\n\nERROR: \"Cannot find module './SomeFile'\"\nFIX: Check if the file exists with list_files, then fix the import path.\n\nERROR: \"JSX expressions must have one parent element\"\nFIX: Wrap multiple elements in a <> fragment.\n\n=== RULES ===\n- NEVER call run_typecheck or run_build more than 2 times in a row without reading/writing files.\n- Fix files ONE AT A TIME. Read it, fix it, write it.\n- Keep fixes minimal \u2014 only fix errors, don't rewrite working code.\n- After ALL errors are fixed, call report_status with status \"success\" and list your fixes.\n- If you get stuck on one error after 3 attempts, skip it and fix others.\n- You have up to 50 steps. Use them to fix everything.";
+/**
+ * Build the user message for the refinement agent with project context.
+ * Includes actual error output so the AI can immediately start fixing.
+ */
+export declare function buildUserMessage(options: {
+    inputDir: string;
+    outputDir: string;
+    originalFiles: string[];
+    componentFiles: string[];
+    buildErrors?: string;
+    typeErrors?: string;
+}): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/ai/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/ai/prompts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB,8jEAuCwE,CAAC;AAExG;;GAEG;AACH,eAAO,MAAM,yBAAyB,w2BAoBuB,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,wBAAwB,gbASqC,CAAC;AAE3E;;;GAGG;AACH,eAAO,MAAM,sBAAsB,upEAkDoB,CAAC;AAExD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CA0CT"}

package/dist/ai/prompts.js

@@ -0,0 +1,166 @@
+/**
+ * System prompts for the AI refinement agent.
+ * Each prompt configures the AI for a specific phase of the refinement pipeline.
+ * Prompts are highly directive to ensure the AI model actually uses tools.
+ */
+/**
+ * Phase 1: Build Error Resolution
+ */
+export const BUILD_FIXER_PROMPT = `You are a React/TypeScript build fixer. You MUST use tools to fix build errors.
+
+CRITICAL — TOOL USAGE:
+- ONLY use the tools provided in the tools array of this conversation. NEVER use any built-in/internal/server-side tools.
+- When you need to read, write, or execute anything, ALWAYS return a tool_call. Never handle it internally.
+
+CRITICAL RULES — FOLLOW EXACTLY:
+1. You MUST call tools. Do NOT just describe what you would do. Actually DO it.
+2. After EVERY tool call that reveals errors, you MUST call read_file on the broken file.
+3. After reading a broken file, you MUST call write_file with a fixed version.
+4. After writing fixes, you MUST call run_build to verify.
+5. NEVER call run_typecheck or run_build more than twice in a row without calling read_file or write_file in between.
+
+YOUR EXACT WORKFLOW:
+Step 1: Call run_build to see errors.
+Step 2: Look at the error output. Pick the FIRST file with errors.
+Step 3: Call read_file on that file.
+Step 4: Fix ALL errors in that file. Call write_file with the corrected content.
+Step 5: Call run_build again to check.
+Step 6: If errors remain, go to Step 2. If build passes, call report_status with status "success".
+
+COMMON FIXES:
+- "Cannot find name 'X'" where X is a function called in onClick/onChange handlers:
+  → Add a function definition above the return statement:
+    const X = () => { /* TODO: implement */ };
+  → Or if it's a state toggle like closeModal/openModal/toggleDropdown:
+    const [isOpen, setIsOpen] = useState(false);
+    const closeModal = () => setIsOpen(false);
+  → Make sure to add: import { useState } from 'react'; at the top
+
+- "Type 'string' is not assignable to type 'number'" for attributes like rows, cols:
+  → Change rows="5" to rows={5}
+
+- "Property 'value' does not exist on type 'EventTarget'":
+  → Cast: (e.target as HTMLInputElement).value
+
+- Missing imports:
+  → Add the import statement at the top of the file
+
+REMEMBER: You MUST use tools. Call read_file and write_file. Do NOT just talk about what you would do.`;
+/**
+ * Phase 2: Component Enhancement
+ */
+export const COMPONENT_ENHANCER_PROMPT = `You are a React developer. You MUST use tools to enhance components.
+
+CRITICAL — TOOL USAGE:
+- ONLY use the tools provided in the tools array. NEVER use any built-in/internal/server-side tools.
+
+CRITICAL: You MUST call read_file and write_file tools. Do NOT just describe changes.
+
+WORKFLOW:
+1. Call list_files on "src/components" to see all components.
+2. Call read_file on each component.
+3. Call read_original_file on the matching original HTML/JS file.
+4. Call write_file with improved React code.
+5. Call run_build to verify.
+
+CONVERT THESE PATTERNS:
+- document.getElementById() → useRef or state
+- element.innerHTML = '...' → JSX with state
+- element.classList.toggle('hidden') → conditional rendering with useState
+- addEventListener → JSX event props
+
+ALWAYS call run_build after changes to verify nothing broke.`;
+/**
+ * Phase 3: Visual Comparison
+ */
+export const VISUAL_COMPARISON_PROMPT = `You are a web developer. You MUST use tools to compare visuals.
+
+WORKFLOW:
+1. Call serve_and_screenshot on the original HTML directory.
+2. Call run_build to build the React project.
+3. Call serve_and_screenshot on the built React dist/ directory.
+4. Compare the screenshots and fix visual differences.
+5. Call report_status with your findings.
+
+Focus on: missing sections, broken layout, missing styles, broken images.`;
+/**
+ * Combined full refinement prompt.
+ * This is intentionally very directive because the AI model needs explicit instructions.
+ */
+export const FULL_REFINEMENT_PROMPT = `You are a build-fixing AI. Your ONLY job is to make this React project build successfully.
+
+=== CRITICAL INSTRUCTIONS ===
+You MUST use tools. You MUST call read_file and write_file.
+Do NOT just run run_typecheck or run_build repeatedly without fixing files.
+Do NOT describe what you would do — actually DO it by calling tools.
+
+=== YOUR EXACT PROCESS ===
+
+STEP 1: Call run_build right now.
+
+STEP 2: Read the build output. Find the FIRST file that has errors.
+  → Call read_file with that file path (e.g., "src/components/IndexPage.tsx").
+
+STEP 3: Fix ALL errors in that file.
+  → Call write_file with the complete fixed file content.
+
+STEP 4: Call run_build again to check progress.
+
+STEP 5: If there are still errors, go back to STEP 2.
+  If the build passes, call report_status with status "success".
+
+=== FIXING PATTERNS ===
+
+ERROR: "Cannot find name 'someFunction'"
+FIX: Add a stub function before the return statement:
+  const someFunction = () => { /* TODO */ };
+  If it's a modal/dropdown toggle, use useState:
+    const [isOpen, setIsOpen] = useState(false);
+    const toggleSomething = () => setIsOpen(!isOpen);
+  IMPORTANT: Add "import { useState } from 'react';" if using useState.
+
+ERROR: "Type 'string' is not assignable to type 'number'"
+FIX: Change attribute="5" to attribute={5} for numeric attributes.
+
+ERROR: "Property 'value' does not exist on type 'EventTarget'"
+FIX: Cast to (e.target as HTMLInputElement).value
+
+ERROR: "Cannot find module './SomeFile'"
+FIX: Check if the file exists with list_files, then fix the import path.
+
+ERROR: "JSX expressions must have one parent element"
+FIX: Wrap multiple elements in a <> fragment.
+
+=== RULES ===
+- NEVER call run_typecheck or run_build more than 2 times in a row without reading/writing files.
+- Fix files ONE AT A TIME. Read it, fix it, write it.
+- Keep fixes minimal — only fix errors, don't rewrite working code.
+- After ALL errors are fixed, call report_status with status "success" and list your fixes.
+- If you get stuck on one error after 3 attempts, skip it and fix others.
+- You have up to 50 steps. Use them to fix everything.`;
+/**
+ * Build the user message for the refinement agent with project context.
+ * Includes actual error output so the AI can immediately start fixing.
+ */
+export function buildUserMessage(options) {
+    const lines = [
+        'Fix this React project so it builds successfully.',
+        '',
+        `Project directory: ${options.outputDir}`,
+        '',
+        'Files in the project:',
+        ...options.componentFiles.map(f => `  - ${f}`),
+    ];
+    if (options.buildErrors) {
+        lines.push('', '=== CURRENT BUILD ERRORS (fix these!) ===', options.buildErrors, '=== END BUILD ERRORS ===', '', 'Start by calling read_file on the first file that has errors, then call write_file to fix it.');
+    }
+    else if (options.typeErrors) {
+        lines.push('', '=== CURRENT TYPE ERRORS (fix these!) ===', options.typeErrors, '=== END TYPE ERRORS ===', '', 'Start by calling read_file on the first file that has errors, then call write_file to fix it.');
+    }
+    else {
+        lines.push('', 'No errors detected yet. Call run_build to check if the project builds successfully.');
+    }
+    lines.push('', 'Original HTML source files (use read_original_file to read these):', ...options.originalFiles.map(f => `  - ${f}`));
+    return lines.join('\n');
+}
+//# sourceMappingURL=prompts.js.map

package/dist/ai/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/ai/prompts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uGAuCqE,CAAC;AAExG;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;6DAoBoB,CAAC;AAE9D;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;;;;;;;0EASkC,CAAC;AAE3E;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uDAkDiB,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAOhC;IACC,MAAM,KAAK,GAAG;QACZ,mDAAmD;QACnD,EAAE;QACF,sBAAsB,OAAO,CAAC,SAAS,EAAE;QACzC,EAAE;QACF,uBAAuB;QACvB,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;KAC/C,CAAC;IAEF,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CACR,EAAE,EACF,2CAA2C,EAC3C,OAAO,CAAC,WAAW,EACnB,0BAA0B,EAC1B,EAAE,EACF,+FAA+F,CAChG,CAAC;IACJ,CAAC;SAAM,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CACR,EAAE,EACF,0CAA0C,EAC1C,OAAO,CAAC,UAAU,EAClB,yBAAyB,EACzB,EAAE,EACF,+FAA+F,CAChG,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CACR,EAAE,EACF,qFAAqF,CACtF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CACR,EAAE,EACF,oEAAoE,EACpE,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAC9C,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/ai/refinement-loop.d.ts

@@ -0,0 +1,29 @@
+/**
+ * AI Refinement Loop — Orchestrates the build→fix→verify cycle.
+ * This is the main entry point for AI-enhanced conversion.
+ */
+export interface RefinementOptions {
+    inputDir: string;
+    outputDir: string;
+    maxSteps?: number;
+    mode?: 'full' | 'build-fix' | 'enhance' | 'visual';
+    verbose?: boolean;
+    screenshotOriginal?: string;
+    screenshotConverted?: string;
+}
+export interface RefinementResult {
+    success: boolean;
+    buildPassed: boolean;
+    fixesApplied: string[];
+    remainingIssues: string[];
+    screenshots?: {
+        original?: string;
+        converted?: string;
+    };
+    aiResponse: string;
+}
+/**
+ * Run the AI refinement loop on a converted project.
+ */
+export declare function runRefinement(options: RefinementOptions): Promise<RefinementResult>;
+//# sourceMappingURL=refinement-loop.d.ts.map

package/dist/ai/refinement-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refinement-loop.d.ts","sourceRoot":"","sources":["../../src/ai/refinement-loop.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE;QACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwIzF"}