synthos 0.8.0 → 0.9.0

package/dist/service/useApiRoutes.js

@@ -31,10 +31,10 @@ const SERVICE_REGISTRY = [
         exclusive: 'search'
     }
 ];
-function useApiRoutes(config, app) {
+function useApiRoutes(config, app, customizer) {
     // List pages
     app.get('/api/pages', async (req, res) => {
-        const pages = await (0, pages_1.listPages)(config.pagesFolder, config.requiredPagesFolder);
+        const pages = await (0, pages_1.listPages)(config.pagesFolder, config.requiredPagesFolders);
         res.json(pages);
     });
     // Import a page from a zip file
@@ -122,7 +122,7 @@ function useApiRoutes(config, app) {
     app.get('/api/pages/:name', async (req, res) => {
         try {
             const { name } = req.params;
-            const metadata = await (0, pages_1.loadPageMetadata)(config.pagesFolder, name, config.requiredPagesFolder);
+            const metadata = await (0, pages_1.loadPageMetadata)(config.pagesFolder, name, config.requiredPagesFolders);
             if (metadata) {
                 res.json(metadata);
             }
@@ -172,7 +172,7 @@ function useApiRoutes(config, app) {
                 return;
             }
             // Load existing metadata (or defaults)
-            const existing = await (0, pages_1.loadPageMetadata)(config.pagesFolder, name, config.requiredPagesFolder);
+            const existing = await (0, pages_1.loadPageMetadata)(config.pagesFolder, name, config.requiredPagesFolders);
             const metadata = {
                 title: existing?.title ?? '',
                 categories: existing?.categories ?? [],
@@ -200,7 +200,12 @@ function useApiRoutes(config, app) {
             if (metadata.mode !== 'locked') {
                 const userPagePath = path_1.default.join(config.pagesFolder, 'pages', name, 'page.html');
                 if (!(await (0, files_1.checkIfExists)(userPagePath))) {
-                    const html = await (0, pages_1.loadPageState)(config.requiredPagesFolder, name, false);
+                    let html;
+                    for (const folder of config.requiredPagesFolders) {
+                        html = await (0, pages_1.loadPageState)(folder, name);
+                        if (html)
+                            break;
+                    }
                     if (html) {
                         await (0, pages_1.savePageState)(config.pagesFolder, name, html);
                     }
@@ -224,7 +229,7 @@ function useApiRoutes(config, app) {
                 return;
             }
             // Load existing metadata (user override → fallback .json → defaults)
-            let metadata = await (0, pages_1.loadPageMetadata)(config.pagesFolder, name, config.requiredPagesFolder);
+            let metadata = await (0, pages_1.loadPageMetadata)(config.pagesFolder, name, config.requiredPagesFolders);
             if (!metadata) {
                 metadata = {
                     title: '',
@@ -251,7 +256,7 @@ function useApiRoutes(config, app) {
         try {
             const { name } = req.params;
             // Cannot delete required pages
-            if (pages_1.REQUIRED_PAGES.includes(name)) {
+            if (config.requiredPages.includes(name)) {
                 res.status(400).json({ error: `Cannot delete required page "${name}"` });
                 return;
             }
@@ -271,11 +276,52 @@ function useApiRoutes(config, app) {
             res.status(500).send(err.message);
         }
     });
+    // Discover what a page contains (tables + files)
+    app.get('/api/pages/:name/contents', async (req, res) => {
+        try {
+            const { name } = req.params;
+            // Resolve page folder: user pages first, then required pages
+            let pageFolder;
+            const userFolder = path_1.default.join(config.pagesFolder, 'pages', name);
+            if (await (0, files_1.checkIfExists)(path_1.default.join(userFolder, 'page.html'))) {
+                pageFolder = userFolder;
+            }
+            else {
+                for (const folder of config.requiredPagesFolders) {
+                    const candidate = path_1.default.join(folder, name);
+                    if (await (0, files_1.checkIfExists)(path_1.default.join(candidate, 'page.html'))) {
+                        pageFolder = candidate;
+                        break;
+                    }
+                }
+            }
+            if (!pageFolder) {
+                res.status(404).json({ error: `Page "${name}" not found` });
+                return;
+            }
+            // List subdirectories, filtering out non-table entries
+            const EXCLUDED = new Set(['files']);
+            const subdirs = await (0, files_1.listFolders)(pageFolder);
+            const tables = subdirs.filter(d => !EXCLUDED.has(d));
+            // Check if files/ exists and has entries
+            const filesDir = path_1.default.join(pageFolder, 'files');
+            let hasFiles = false;
+            if (await (0, files_1.checkIfExists)(filesDir)) {
+                const entries = await promises_1.default.readdir(filesDir);
+                hasFiles = entries.length > 0;
+            }
+            res.json({ tables, hasFiles });
+        }
+        catch (err) {
+            console.error(err);
+            res.status(500).json({ error: err.message });
+        }
+    });
     // Copy a page to a new name
     app.post('/api/pages/:name/copy', async (req, res) => {
         try {
             const sourceName = req.params.name;
-            const { name: targetName, title, categories } = req.body;
+            const { name: targetName, title, categories, copyTables, copyFiles } = req.body;
             // Validate target name
             if (!targetName || typeof targetName !== 'string') {
                 res.status(400).json({ error: 'name is required' });
@@ -293,10 +339,17 @@ function useApiRoutes(config, app) {
             // Check source exists (user pages → required pages)
             const sourceFolderPath = path_1.default.join(config.pagesFolder, 'pages', sourceName, 'page.html');
             const sourceFlatPath = path_1.default.join(config.pagesFolder, `${sourceName}.html`);
-            const sourceRequiredPath = path_1.default.join(config.requiredPagesFolder, `${sourceName}.html`);
+            let sourceRequiredPath;
+            for (const folder of config.requiredPagesFolders) {
+                const candidate = path_1.default.join(folder, sourceName, 'page.html');
+                if (await (0, files_1.checkIfExists)(candidate)) {
+                    sourceRequiredPath = candidate;
+                    break;
+                }
+            }
             const sourceExists = await (0, files_1.checkIfExists)(sourceFolderPath)
                 || await (0, files_1.checkIfExists)(sourceFlatPath)
-                || await (0, files_1.checkIfExists)(sourceRequiredPath);
+                || !!sourceRequiredPath;
             if (!sourceExists) {
                 res.status(404).json({ error: `Source page "${sourceName}" not found` });
                 return;
@@ -308,7 +361,10 @@ function useApiRoutes(config, app) {
                 res.status(409).json({ error: `Page "${targetName}" already exists` });
                 return;
             }
-            await (0, pages_1.copyPage)(config.pagesFolder, sourceName, targetName, typeof title === 'string' ? title : '', Array.isArray(categories) ? categories : [], config.requiredPagesFolder);
+            await (0, pages_1.copyPage)(config.pagesFolder, sourceName, targetName, typeof title === 'string' ? title : '', Array.isArray(categories) ? categories : [], config.requiredPagesFolders, {
+                copyTables: copyTables === true,
+                copyFiles: copyFiles !== false, // default true
+            });
             // Return the new page metadata
             const metadata = await (0, pages_1.loadPageMetadata)(config.pagesFolder, targetName);
             res.status(201).json({ name: targetName, ...metadata });
@@ -380,15 +436,17 @@ function useApiRoutes(config, app) {
         });
     });
     // Brainstorm endpoint
-    app.post('/api/brainstorm', async (req, res) => {
-        await (0, requiresSettings_1.requiresSettings)(res, config.pagesFolder, async (settings) => {
-            const { context, messages } = req.body;
-            const completePrompt = await (0, createCompletePrompt_1.createCompletePrompt)(config.pagesFolder, 'chat');
-            const system = {
-                role: 'system',
-                content: `You are a creative brainstorming assistant for SynthOS, a tool that builds pages through conversation.
-SynthOS is like a WIKI for vibe coding. Each page has a chat panel and a viewer panel. They are vibe coding what's displayed in that viewer panel. They can then save that as a page.
-The user is brainstorming — exploring ideas before building. Be concise, creative, and collaborative. 
+    if (!customizer || customizer.isEnabled('brainstorm'))
+        app.post('/api/brainstorm', async (req, res) => {
+            await (0, requiresSettings_1.requiresSettings)(res, config.pagesFolder, async (settings) => {
+                const { context, messages } = req.body;
+                const completePrompt = await (0, createCompletePrompt_1.createCompletePrompt)(config.pagesFolder, 'chat');
+                const productName = customizer?.productName ?? 'SynthOS';
+                const system = {
+                    role: 'system',
+                    content: `You are a creative brainstorming assistant for ${productName}, a tool that builds pages through conversation.
+${productName} is like a WIKI for vibe coding. Each page has a chat panel and a viewer panel. They are vibe coding what's displayed in that viewer panel. They can then save that as a page.
+The user is brainstorming — exploring ideas before building. Be concise, creative, and collaborative.
 They may say that they want to build an app or page that does XYZ but they're talking about what they expect to see in the viewer panel.
 The goal is to help them generate a prompt for the builder that captures their vision, along with suggestions for next steps.
 Suggest concrete approaches when you can, not complex visions for some ellaborate app.
@@ -399,74 +457,75 @@ ${context}
 
 <INSTRUCTIONS>
 Look at the <CHAT_HISTORY> and if it's empty it's the start of a new idea. Simply greet them and ask them what they're thinking of building. Suggestions could be help me decide, etc.
-If you see a conversation between SynthOS and the User. Asses what they're building and ask them what they'd like help with. Maybe offer a few good next steps.
+If you see a conversation between ${productName} and the User. Asses what they're building and ask them what they'd like help with. Maybe offer a few good next steps.
 
-SynthOS exposes table storage and chat completion api's that every page can use. If the user wants to store something or use AI, your prompt should suggest using table storage or make llm calls.
+${productName} exposes table storage and chat completion api's that every page can use. If the user wants to store something or use AI, your prompt should suggest using table storage or make llm calls.
 
 You MUST return your response as a JSON object with exactly these fields:
 {
   "response": "Your conversational reply — explanations, options, suggestions. Markdown OK.",
-  "prompt": "A clean, actionable instruction ready to paste into SynthOS chat to build what was discussed. Update this each exchange to reflect the latest brainstorm state.",
+  "prompt": "A clean, actionable instruction ready to paste into ${productName} chat to build what was discussed. Update this each exchange to reflect the latest brainstorm state.",
   "suggestions": ["Short clickable option A", "Short clickable option B", "Short clickable option C"]
 }
 
 suggestions — 2-4 short phrases the user can click to continue the conversation. These are next-step options: directions to explore, questions to answer, or choices to make. Keep each under 60 characters. Always provide suggestions.
 
 Return ONLY the JSON object.`
-            };
-            // Format multi-turn conversation into a single prompt
-            const formatted = messages.map(m => `${m.role === 'user' ? 'User' : 'Assistant'}: ${m.content}`).join('\n\n');
-            const prompt = { role: 'user', content: formatted };
-            const result = await completePrompt({ prompt, system, jsonMode: true });
-            if (result.completed) {
-                let response = result.value || '';
-                let brainstormPrompt = '';
-                let suggestions = [];
-                // jsonMode returns an already-parsed object from agentm-core
-                const parsed = (typeof result.value === 'object' && result.value !== null)
-                    ? result.value
-                    : (() => { try {
-                        return JSON.parse(result.value);
-                    }
-                    catch {
-                        return null;
-                    } })();
-                if (parsed) {
-                    if (typeof parsed.response === 'string')
-                        response = parsed.response;
-                    if (typeof parsed.prompt === 'string')
-                        brainstormPrompt = parsed.prompt;
-                    if (Array.isArray(parsed.suggestions)) {
-                        suggestions = parsed.suggestions.filter((s) => typeof s === 'string');
+                };
+                // Format multi-turn conversation into a single prompt
+                const formatted = messages.map(m => `${m.role === 'user' ? 'User' : 'Assistant'}: ${m.content}`).join('\n\n');
+                const prompt = { role: 'user', content: formatted };
+                const result = await completePrompt({ prompt, system, jsonMode: true });
+                if (result.completed) {
+                    let response = result.value || '';
+                    let brainstormPrompt = '';
+                    let suggestions = [];
+                    // jsonMode returns an already-parsed object from agentm-core
+                    const parsed = (typeof result.value === 'object' && result.value !== null)
+                        ? result.value
+                        : (() => { try {
+                            return JSON.parse(result.value);
+                        }
+                        catch {
+                            return null;
+                        } })();
+                    if (parsed) {
+                        if (typeof parsed.response === 'string')
+                            response = parsed.response;
+                        if (typeof parsed.prompt === 'string')
+                            brainstormPrompt = parsed.prompt;
+                        if (Array.isArray(parsed.suggestions)) {
+                            suggestions = parsed.suggestions.filter((s) => typeof s === 'string');
+                        }
                     }
+                    res.json({ response, prompt: brainstormPrompt, suggestions });
                 }
-                res.json({ response, prompt: brainstormPrompt, suggestions });
-            }
-            else {
-                console.error(result.error);
-                res.status(500).send(result.error?.message);
-            }
+                else {
+                    console.error(result.error);
+                    res.status(500).send(result.error?.message);
+                }
+            });
         });
-    });
     // Define a route for running configured scripts
-    app.post('/api/scripts/:id', async (req, res) => {
-        await (0, requiresSettings_1.requiresSettings)(res, config.pagesFolder, async (settings) => {
-            const { id } = req.params;
-            const pagesFolder = config.pagesFolder;
-            const scriptId = id;
-            const response = await (0, scripts_1.executeScript)({ pagesFolder, scriptId, variables: req.body });
-            if (response.completed) {
-                // Return the response as text
-                const value = (response.value?.output ?? (response.value?.errors ?? []).join('\n')).trim();
-                res.set('Content-Type', 'text/plain');
-                res.send(value);
-            }
-            else {
-                console.error(response.error);
-                res.status(500).send(response.error);
-            }
+    if (!customizer || customizer.isEnabled('scripts'))
+        app.post('/api/scripts/:id', async (req, res) => {
+            await (0, requiresSettings_1.requiresSettings)(res, config.pagesFolder, async (settings) => {
+                const { id } = req.params;
+                const pagesFolder = config.pagesFolder;
+                const scriptId = id;
+                const response = await (0, scripts_1.executeScript)({ pagesFolder, scriptId, variables: req.body });
+                if (response.completed) {
+                    // Return the response as text
+                    const value = (response.value?.output ?? (response.value?.errors ?? []).join('\n')).trim();
+                    res.set('Content-Type', 'text/plain');
+                    res.send(value);
+                }
+                else {
+                    console.error(response.error);
+                    res.status(500).send(response.error);
+                }
+            });
         });
-    });
     // Return theme info as a self-executing JS script
     app.get('/api/theme-info.js', async (req, res) => {
         try {
@@ -477,7 +536,13 @@ Return ONLY the JSON object.`
                 res.status(404).send(`// Theme info for "${themeName}" not found`);
                 return;
             }
-            const js = `window.themeInfo=${JSON.stringify(info)};document.documentElement.classList.add(window.themeInfo.mode+"-mode");`;
+            const themeVersion = await (0, themes_1.loadThemeVersion)(themeName, config);
+            const payload = { ...info, name: themeName, version: themeVersion };
+            let js = `window.themeInfo=${JSON.stringify(payload)};document.documentElement.classList.add(window.themeInfo.mode+"-mode");`;
+            if (themeVersion >= 3) {
+                js += `document.documentElement.classList.add(${JSON.stringify(themeName)});`;
+            }
+            js += `document.documentElement.setAttribute("data-toolbar",${JSON.stringify(settings.toolbarPosition || 'left')});`;
             res.set('Content-Type', 'application/javascript');
             res.send(js);
         }
@@ -494,21 +559,17 @@ Return ONLY the JSON object.`
                 res.status(400).send('// Missing page query parameter');
                 return;
             }
-            const metadata = await (0, pages_1.loadPageMetadata)(config.pagesFolder, page, config.requiredPagesFolder);
+            const metadata = await (0, pages_1.loadPageMetadata)(config.pagesFolder, page, config.requiredPagesFolders);
             const mode = metadata?.mode ?? 'unlocked';
             const title = metadata?.title ?? '';
             const categories = metadata?.categories ?? [];
-            const info = JSON.stringify({ name: page, mode, latestPageVersion: pages_1.PAGE_VERSION, title, categories });
+            const isRequiredPage = config.requiredPages.includes(page);
+            const info = JSON.stringify({ name: page, mode, latestPageVersion: pages_1.PAGE_VERSION, title, categories, isRequiredPage });
             const js = [
                 `window.pageInfo=${info};`,
                 `if(window.pageInfo.mode==="locked"){`,
                 `document.addEventListener("DOMContentLoaded",function(){`,
                 `var f=document.getElementById("chatForm");if(f)f.style.display="none";`,
-                `var s=document.getElementById("saveLink");if(s)s.textContent="Copy";`,
-                `var r=document.getElementById("resetLink");if(r){`,
-                `var c=r.cloneNode(true);c.textContent="Reload";`,
-                `c.addEventListener("click",function(e){e.preventDefault();window.location.href=window.location.pathname;});`,
-                `r.parentNode.replaceChild(c,r);}`,
                 `});`,
                 `}`,
             ].join('');
@@ -558,8 +619,8 @@ Return ONLY the JSON object.`
                 res.status(400).send('// Invalid version parameter');
                 return;
             }
-            const scriptPath = path_1.default.join(config.pageScriptsFolder, `page-v${v}.js`);
-            if (!(await (0, files_1.checkIfExists)(scriptPath))) {
+            const scriptPath = await (0, files_1.findFileInFolders)(config.staticFilesFolders, `page.v${v}.js`);
+            if (!scriptPath) {
                 res.status(404).send(`// page-v${v}.js not found`);
                 return;
             }
@@ -581,8 +642,8 @@ Return ONLY the JSON object.`
                 res.status(400).send('// Invalid version parameter');
                 return;
             }
-            const scriptPath = path_1.default.join(config.pageScriptsFolder, `helpers-v${v}.js`);
-            if (!(await (0, files_1.checkIfExists)(scriptPath))) {
+            const scriptPath = await (0, files_1.findFileInFolders)(config.staticFilesFolders, `helpers.v${v}.js`);
+            if (!scriptPath) {
                 res.status(404).send(`// helpers-v${v}.js not found`);
                 return;
             }
@@ -657,57 +718,58 @@ Return ONLY the JSON object.`
     // -----------------------------------------------------------------------
     // Web Search (Brave Search API)
     // -----------------------------------------------------------------------
-    app.post('/api/search/web', async (req, res) => {
-        try {
-            const { query, count, country, freshness } = req.body;
-            if (!query || typeof query !== 'string') {
-                res.status(400).json({ error: 'query is required' });
-                return;
-            }
-            const settings = await (0, settings_1.loadSettings)(config.pagesFolder);
-            const braveConfig = settings.connectors?.['brave-search'] ?? settings.services?.['brave-search'];
-            if (!braveConfig || !braveConfig.enabled || !braveConfig.apiKey) {
-                res.status(400).json({ error: 'Brave Search is not configured or not enabled. Add your API key in Settings > Services.' });
-                return;
-            }
-            const params = new URLSearchParams({ q: query });
-            if (count)
-                params.set('count', String(Math.min(Number(count) || 5, 20)));
-            if (country)
-                params.set('country', country);
-            if (freshness)
-                params.set('freshness', freshness);
-            const response = await fetch(`https://api.search.brave.com/res/v1/web/search?${params.toString()}`, {
-                headers: {
-                    'Accept': 'application/json',
-                    'Accept-Encoding': 'gzip',
-                    'X-Subscription-Token': braveConfig.apiKey
+    if (!customizer || customizer.isEnabled('search'))
+        app.post('/api/search/web', async (req, res) => {
+            try {
+                const { query, count, country, freshness } = req.body;
+                if (!query || typeof query !== 'string') {
+                    res.status(400).json({ error: 'query is required' });
+                    return;
                 }
-            });
-            if (!response.ok) {
-                const text = await response.text();
-                res.status(response.status).json({ error: `Brave Search API error: ${text}` });
-                return;
+                const settings = await (0, settings_1.loadSettings)(config.pagesFolder);
+                const braveConfig = settings.connectors?.['brave-search'] ?? settings.services?.['brave-search'];
+                if (!braveConfig || !braveConfig.enabled || !braveConfig.apiKey) {
+                    res.status(400).json({ error: 'Brave Search is not configured or not enabled. Add your API key in Settings > Services.' });
+                    return;
+                }
+                const params = new URLSearchParams({ q: query });
+                if (count)
+                    params.set('count', String(Math.min(Number(count) || 5, 20)));
+                if (country)
+                    params.set('country', country);
+                if (freshness)
+                    params.set('freshness', freshness);
+                const response = await fetch(`https://api.search.brave.com/res/v1/web/search?${params.toString()}`, {
+                    headers: {
+                        'Accept': 'application/json',
+                        'Accept-Encoding': 'gzip',
+                        'X-Subscription-Token': braveConfig.apiKey
+                    }
+                });
+                if (!response.ok) {
+                    const text = await response.text();
+                    res.status(response.status).json({ error: `Brave Search API error: ${text}` });
+                    return;
+                }
+                const data = await response.json();
+                const results = (data.web?.results ?? []).map(r => ({
+                    title: r.title,
+                    url: r.url,
+                    description: r.description
+                }));
+                res.json({ results });
+            }
+            catch (err) {
+                console.error(err);
+                res.status(500).json({ error: err.message });
             }
-            const data = await response.json();
-            const results = (data.web?.results ?? []).map(r => ({
-                title: r.title,
-                url: r.url,
-                description: r.description
-            }));
-            res.json({ results });
-        }
-        catch (err) {
-            console.error(err);
-            res.status(500).json({ error: err.message });
-        }
-    });
+        });
     // Upgrade a page to the latest version
     app.post('/api/pages/:name/upgrade', async (req, res) => {
         try {
             const { name } = req.params;
             // Load current metadata
-            const metadata = await (0, pages_1.loadPageMetadata)(config.pagesFolder, name, config.requiredPagesFolder);
+            const metadata = await (0, pages_1.loadPageMetadata)(config.pagesFolder, name, config.requiredPagesFolders);
             if (!metadata) {
                 res.status(404).json({ error: `Page "${name}" not found` });
                 return;
@@ -730,17 +792,19 @@ Return ONLY the JSON object.`
             await (0, pages_1.savePageState)(config.pagesFolder, name, migratedHtml);
             // Backup original page to .migrated/ before overwriting
             const migratedFolder = path_1.default.join(config.pagesFolder, '.migrated');
-            // Handle legacy flat file (.synthos/pagename.html)
+            // Handle legacy flat file (<localFolder>/pagename.html)
             const flatPath = path_1.default.join(config.pagesFolder, `${name}.html`);
             if (await (0, files_1.checkIfExists)(flatPath)) {
                 await (0, files_1.copyFile)(flatPath, migratedFolder);
                 await (0, files_1.deleteFile)(flatPath);
             }
-            // Handle folder-based page (.synthos/pages/name/)
+            // Handle folder-based page (<localFolder>/pages/name/)
             const folderPath = path_1.default.join(config.pagesFolder, 'pages', name);
             if (await (0, files_1.checkIfExists)(folderPath)) {
                 await (0, files_1.copyFolderRecursive)(folderPath, path_1.default.join(migratedFolder, name));
             }
+            // Clear stale version files (undo snapshots from the old page version)
+            await (0, pages_1.clearVersions)(config.pagesFolder, name);
             // Update metadata
             metadata.pageVersion = pages_1.PAGE_VERSION;
             metadata.lastModified = new Date().toISOString();
@@ -758,20 +822,26 @@ Return ONLY the JSON object.`
             const { name } = req.params;
             // Try user pages folder first, then required pages
             const userPageDir = path_1.default.join(config.pagesFolder, 'pages', name);
-            const requiredPageFile = path_1.default.join(config.requiredPagesFolder, `${name}.html`);
+            let requiredPageDir;
+            for (const folder of config.requiredPagesFolders) {
+                if (await (0, files_1.checkIfExists)(path_1.default.join(folder, name, 'page.html'))) {
+                    requiredPageDir = path_1.default.join(folder, name);
+                    break;
+                }
+            }
             let sourceDir = null;
             if (await (0, files_1.checkIfExists)(path_1.default.join(userPageDir, 'page.html'))) {
                 sourceDir = userPageDir;
             }
-            else if (await (0, files_1.checkIfExists)(requiredPageFile)) {
+            else if (requiredPageDir) {
                 // For required pages, create a temp-like zip with just the HTML
                 const zip = new adm_zip_1.default();
-                const html = await (0, files_1.loadFile)(requiredPageFile);
+                const html = await (0, files_1.loadFile)(path_1.default.join(requiredPageDir, 'page.html'));
                 zip.addFile(`${name}/page.html`, Buffer.from(html, 'utf-8'));
                 // Include page.json if it exists
-                const requiredMetaFile = path_1.default.join(config.requiredPagesFolder, `${name}.json`);
-                if (await (0, files_1.checkIfExists)(requiredMetaFile)) {
-                    const meta = await (0, files_1.loadFile)(requiredMetaFile);
+                const metaPath = path_1.default.join(requiredPageDir, 'page.json');
+                if (await (0, files_1.checkIfExists)(metaPath)) {
+                    const meta = await (0, files_1.loadFile)(metaPath);
                     zip.addFile(`${name}/page.json`, Buffer.from(meta, 'utf-8'));
                 }
                 const zipBuffer = zip.toBuffer();
@@ -797,6 +867,37 @@ Return ONLY the JSON object.`
             res.status(500).json({ error: err.message });
         }
     });
+    // Ask a question about a page (with full page HTML context)
+    app.post('/api/pages/:name/ask', async (req, res) => {
+        await (0, requiresSettings_1.requiresSettings)(res, config.pagesFolder, async (settings) => {
+            const { name } = req.params;
+            const { question } = req.body;
+            if (typeof question !== 'string' || !question.trim()) {
+                res.status(400).json({ error: 'question is required' });
+                return;
+            }
+            // Load the page HTML
+            const html = await (0, usePageRoutes_1.loadPageWithFallback)(name, config, false);
+            if (!html) {
+                res.status(404).json({ error: `Page "${name}" not found` });
+                return;
+            }
+            // Create completion (uses 'chat' model, not 'builder')
+            const complete = await (0, createCompletePrompt_1.createCompletePrompt)(config.pagesFolder, 'chat', req.body.model);
+            const system = {
+                role: 'system',
+                content: `You are a helpful assistant. The user will ask questions about a web page. Answer based on the page content provided.\n\n<PAGE_HTML>\n${html}`
+            };
+            const prompt = { role: 'user', content: question };
+            const result = await complete({ system, prompt });
+            if (result.completed) {
+                res.json({ answer: result.value });
+            }
+            else {
+                res.status(500).json({ error: result.error?.message || 'Completion failed' });
+            }
+        });
+    });
 }
 exports.useApiRoutes = useApiRoutes;
 //# sourceMappingURL=useApiRoutes.js.map