synthos 0.8.0 → 0.10.0

package/dist/service/useApiRoutes.js

@@ -5,7 +5,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useApiRoutes = void 0;
 const path_1 = __importDefault(require("path"));
-const promises_1 = __importDefault(require("fs/promises"));
 const adm_zip_1 = __importDefault(require("adm-zip"));
 const pages_1 = require("../pages");
 const files_1 = require("../files");
@@ -31,10 +30,11 @@ const SERVICE_REGISTRY = [
         exclusive: 'search'
     }
 ];
-function useApiRoutes(config, app) {
+function useApiRoutes(config, app, customizer) {
+    const sp = config.storageProvider;
     // 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, config.requiredPagesFolders);
         res.json(pages);
     });
     // Import a page from a zip file
@@ -75,12 +75,12 @@ function useApiRoutes(config, app) {
             // Auto-append _1, _2, etc. on name conflicts
             let finalName = pageName;
             let suffix = 0;
-            while (await (0, files_1.checkIfExists)(path_1.default.join(config.pagesFolder, 'pages', finalName))) {
+            while (await sp.checkIfExists(path_1.default.join(config.pagesFolder, 'pages', finalName))) {
                 suffix++;
                 finalName = `${pageName}_${suffix}`;
             }
             const targetDir = path_1.default.join(config.pagesFolder, 'pages', finalName);
-            await (0, files_1.ensureFolderExists)(targetDir);
+            await sp.ensureFolderExists(targetDir);
             // Extract entries with path traversal protection
             for (const entry of entries) {
                 if (entry.isDirectory)
@@ -94,12 +94,12 @@ function useApiRoutes(config, app) {
                     // Path traversal — skip this entry
                     continue;
                 }
-                await (0, files_1.ensureFolderExists)(path_1.default.dirname(resolvedPath));
-                await promises_1.default.writeFile(resolvedPath, entry.getData());
+                await sp.ensureFolderExists(path_1.default.dirname(resolvedPath));
+                await sp.saveBuffer(resolvedPath, entry.getData());
             }
             // Update metadata: set createdDate and lastModified to now
             const now = new Date().toISOString();
-            const existingMeta = await (0, pages_1.loadPageMetadata)(config.pagesFolder, finalName);
+            const existingMeta = await (0, pages_1.loadPageMetadata)(config, finalName);
             const metadata = {
                 title: existingMeta?.title ?? '',
                 categories: existingMeta?.categories ?? [],
@@ -110,7 +110,7 @@ function useApiRoutes(config, app) {
                 pageVersion: existingMeta?.pageVersion ?? pages_1.PAGE_VERSION,
                 mode: existingMeta?.mode ?? 'unlocked',
             };
-            await (0, pages_1.savePageMetadata)(config.pagesFolder, finalName, metadata);
+            await (0, pages_1.savePageMetadata)(config, finalName, metadata);
             res.status(201).json({ name: finalName, title: metadata.title });
         }
         catch (err) {
@@ -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, 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, name, config.requiredPagesFolders);
             const metadata = {
                 title: existing?.title ?? '',
                 categories: existing?.categories ?? [],
@@ -199,14 +199,22 @@ function useApiRoutes(config, app) {
             // Promote required page to user folder if being unlocked/designed
             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);
+                if (!(await sp.checkIfExists(userPagePath))) {
+                    // Read from required pages (package content, always local fs)
+                    let html;
+                    for (const folder of config.requiredPagesFolders) {
+                        const candidate = path_1.default.join(folder, name, 'page.html');
+                        if (await (0, files_1.checkIfExists)(candidate)) {
+                            html = await (0, files_1.loadFile)(candidate);
+                            break;
+                        }
+                    }
                     if (html) {
-                        await (0, pages_1.savePageState)(config.pagesFolder, name, html);
+                        await (0, pages_1.savePageState)(config, name, html);
                     }
                 }
             }
-            await (0, pages_1.savePageMetadata)(config.pagesFolder, name, metadata);
+            await (0, pages_1.savePageMetadata)(config, name, metadata);
             res.json(metadata);
         }
         catch (err) {
@@ -224,7 +232,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, name, config.requiredPagesFolders);
             if (!metadata) {
                 metadata = {
                     title: '',
@@ -238,7 +246,7 @@ function useApiRoutes(config, app) {
                 };
             }
             metadata.pinned = pinned;
-            await (0, pages_1.savePageMetadata)(config.pagesFolder, name, metadata);
+            await (0, pages_1.savePageMetadata)(config, name, metadata);
             res.json(metadata);
         }
         catch (err) {
@@ -251,19 +259,19 @@ 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;
             }
             // Check if page exists (folder-based or legacy flat file)
             const folderPath = path_1.default.join(config.pagesFolder, 'pages', name, 'page.html');
             const flatPath = path_1.default.join(config.pagesFolder, `${name}.html`);
-            const exists = await (0, files_1.checkIfExists)(folderPath) || await (0, files_1.checkIfExists)(flatPath);
+            const exists = await sp.checkIfExists(folderPath) || await sp.checkIfExists(flatPath);
             if (!exists) {
                 res.status(404).json({ error: `Page "${name}" not found` });
                 return;
             }
-            await (0, pages_1.deletePage)(config.pagesFolder, name);
+            await (0, pages_1.deletePage)(config, name);
             res.json({ deleted: true });
         }
         catch (err) {
@@ -271,11 +279,61 @@ 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 sp.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']);
+            // Use provider for user folder, local fs for required pages
+            const isUserFolder = pageFolder === userFolder;
+            const subdirs = isUserFolder
+                ? await sp.listFolders(pageFolder)
+                : 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;
+            const filesDirExists = isUserFolder
+                ? await sp.checkIfExists(filesDir)
+                : await (0, files_1.checkIfExists)(filesDir);
+            if (filesDirExists) {
+                const entries = isUserFolder
+                    ? await sp.listFiles(filesDir)
+                    : await (0, files_1.listFiles)(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 +351,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`);
-            const sourceExists = await (0, files_1.checkIfExists)(sourceFolderPath)
-                || await (0, files_1.checkIfExists)(sourceFlatPath)
-                || await (0, files_1.checkIfExists)(sourceRequiredPath);
+            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 sp.checkIfExists(sourceFolderPath)
+                || await sp.checkIfExists(sourceFlatPath)
+                || !!sourceRequiredPath;
             if (!sourceExists) {
                 res.status(404).json({ error: `Source page "${sourceName}" not found` });
                 return;
@@ -304,13 +369,16 @@ function useApiRoutes(config, app) {
             // Check target doesn't already exist
             const targetFolderPath = path_1.default.join(config.pagesFolder, 'pages', targetName, 'page.html');
             const targetFlatPath = path_1.default.join(config.pagesFolder, `${targetName}.html`);
-            if (await (0, files_1.checkIfExists)(targetFolderPath) || await (0, files_1.checkIfExists)(targetFlatPath)) {
+            if (await sp.checkIfExists(targetFolderPath) || await sp.checkIfExists(targetFlatPath)) {
                 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, 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);
+            const metadata = await (0, pages_1.loadPageMetadata)(config, targetName);
             res.status(201).json({ name: targetName, ...metadata });
         }
         catch (err) {
@@ -320,7 +388,7 @@ function useApiRoutes(config, app) {
     });
     // Define a route to return settings
     app.get('/api/settings', async (req, res) => {
-        const settings = await (0, settings_1.loadSettings)(config.pagesFolder);
+        const settings = await (0, settings_1.loadSettings)(config);
         const providers = createCompletePrompt_1.PROVIDERS.map(p => ({ name: p.name, builderModels: p.builderModels, chatModels: p.chatModels }));
         res.json({ ...settings, providers });
     });
@@ -339,7 +407,7 @@ function useApiRoutes(config, app) {
                 }
             }
             // Save settings
-            await (0, settings_1.saveSettings)(config.pagesFolder, settings);
+            await (0, settings_1.saveSettings)(config, settings);
             res.redirect('/builder');
         }
         catch (err) {
@@ -349,7 +417,7 @@ function useApiRoutes(config, app) {
     });
     // Define a route to generate an image
     app.post('/api/generate/image', async (req, res) => {
-        await (0, requiresSettings_1.requiresSettings)(res, config.pagesFolder, async (settings) => {
+        await (0, requiresSettings_1.requiresSettings)(res, config, async (settings) => {
             const { prompt, shape, style } = req.body;
             const builder = (0, settings_1.getModelEntry)(settings, 'builder');
             const { configuration, imageQuality, provider } = builder;
@@ -366,9 +434,9 @@ function useApiRoutes(config, app) {
     });
     // Define a route to generate a completion using chain-of-thought
     app.post('/api/generate/completion', async (req, res) => {
-        await (0, requiresSettings_1.requiresSettings)(res, config.pagesFolder, async (settings) => {
+        await (0, requiresSettings_1.requiresSettings)(res, config, async (settings) => {
             const { prompt, temperature } = req.body;
-            const completePrompt = await (0, createCompletePrompt_1.createCompletePrompt)(config.pagesFolder, 'chat', req.body.model);
+            const completePrompt = await (0, createCompletePrompt_1.createCompletePrompt)(config, 'chat', req.body.model);
             const response = await (0, models_1.chainOfThought)({ question: prompt, temperature, completePrompt });
             if (response.completed) {
                 res.json(response.value ?? {});
@@ -380,15 +448,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, async (settings) => {
+                const { context, messages } = req.body;
+                const completePrompt = await (0, createCompletePrompt_1.createCompletePrompt)(config, '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,85 +469,91 @@ ${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, async (settings) => {
+                const { id } = req.params;
+                const scriptId = id;
+                const response = await (0, scripts_1.executeScript)({ pagesFolder: config.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 {
-            const settings = await (0, settings_1.loadSettings)(config.pagesFolder);
+            const settings = await (0, settings_1.loadSettings)(config);
             const themeName = settings.theme ?? 'nebula-dusk';
             const info = await (0, themes_1.loadThemeInfo)(themeName, config);
             if (!info) {
                 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 +570,18 @@ 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, 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 productName = customizer?.productName ?? 'SynthOS';
+            const info = JSON.stringify({ name: page, mode, latestPageVersion: pages_1.PAGE_VERSION, title, categories, isRequiredPage, productName });
             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('');
@@ -524,7 +597,7 @@ Return ONLY the JSON object.`
     // Return the current theme as CSS
     app.get('/api/theme.css', async (req, res) => {
         try {
-            const settings = await (0, settings_1.loadSettings)(config.pagesFolder);
+            const settings = await (0, settings_1.loadSettings)(config);
             const themeName = settings.theme ?? 'nebula-dusk';
             const css = await (0, themes_1.loadTheme)(themeName, config);
             if (!css) {
@@ -558,8 +631,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 +654,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;
             }
@@ -606,7 +679,7 @@ Return ONLY the JSON object.`
     // Return user's configured services (API keys masked)
     app.get('/api/services', async (_req, res) => {
         try {
-            const settings = await (0, settings_1.loadSettings)(config.pagesFolder);
+            const settings = await (0, settings_1.loadSettings)(config);
             const services = settings.services ?? {};
             const masked = {};
             for (const [id, cfg] of Object.entries(services)) {
@@ -626,7 +699,7 @@ Return ONLY the JSON object.`
     app.post('/api/services', async (req, res) => {
         try {
             const incoming = req.body;
-            const settings = await (0, settings_1.loadSettings)(config.pagesFolder);
+            const settings = await (0, settings_1.loadSettings)(config);
             const existing = settings.services ?? {};
             // Build merged config — empty apiKey means "keep existing"
             const merged = {};
@@ -646,7 +719,7 @@ Return ONLY the JSON object.`
                     }
                 }
             }
-            await (0, settings_1.saveSettings)(config.pagesFolder, { services: merged });
+            await (0, settings_1.saveSettings)(config, { services: merged });
             res.json({ saved: true });
         }
         catch (err) {
@@ -657,57 +730,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);
+                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, name, config.requiredPagesFolders);
             if (!metadata) {
                 res.status(404).json({ error: `Page "${name}" not found` });
                 return;
@@ -724,27 +798,31 @@ Return ONLY the JSON object.`
                 return;
             }
             // Run LLM-based migration
-            const completePrompt = await (0, createCompletePrompt_1.createCompletePrompt)(config.pagesFolder, 'builder');
+            const completePrompt = await (0, createCompletePrompt_1.createCompletePrompt)(config, 'builder');
             const migratedHtml = await (0, migrations_1.migratePage)(html, currentVersion, pages_1.PAGE_VERSION, completePrompt);
             // Save upgraded HTML to v2 folder structure
-            await (0, pages_1.savePageState)(config.pagesFolder, name, migratedHtml);
+            await (0, pages_1.savePageState)(config, 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);
+            if (await sp.checkIfExists(flatPath)) {
+                await sp.ensureFolderExists(migratedFolder);
+                const flatData = await sp.loadBuffer(flatPath);
+                await sp.saveBuffer(path_1.default.join(migratedFolder, `${name}.html`), flatData);
+                await sp.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));
+            if (await sp.checkIfExists(folderPath)) {
+                await sp.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, name);
             // Update metadata
             metadata.pageVersion = pages_1.PAGE_VERSION;
             metadata.lastModified = new Date().toISOString();
-            await (0, pages_1.savePageMetadata)(config.pagesFolder, name, metadata);
+            await (0, pages_1.savePageMetadata)(config, name, metadata);
             res.json({ upgraded: true, fromVersion: currentVersion, toVersion: pages_1.PAGE_VERSION });
         }
         catch (err) {
@@ -758,20 +836,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'))) { // package content, local fs
+                    requiredPageDir = path_1.default.join(folder, name);
+                    break;
+                }
+            }
             let sourceDir = null;
-            if (await (0, files_1.checkIfExists)(path_1.default.join(userPageDir, 'page.html'))) {
+            if (await sp.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 +881,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, 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, '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