npm - synthos - Versions diffs - 0.6.0 → 0.7.1 - Mend

synthos 0.6.0 → 0.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (153) hide show

package/README.md +33 -1
package/default-pages/app_builder.html +40 -0
package/default-pages/app_builder.json +1 -0
package/default-pages/json_tools.html +89 -159
package/default-pages/json_tools.json +1 -0
package/default-pages/my_notes.html +33 -0
package/default-pages/my_notes.json +12 -0
package/default-pages/neon_asteroids.html +77 -0
package/default-pages/neon_asteroids.json +12 -0
package/default-pages/sidebar_builder.html +49 -0
package/default-pages/sidebar_builder.json +1 -0
package/default-pages/solar_explorer.html +1956 -0
package/default-pages/solar_explorer.json +12 -0
package/default-pages/solar_tutorial.html +476 -0
package/default-pages/solar_tutorial.json +1 -0
package/default-pages/two-panel_builder.html +66 -0
package/default-pages/two-panel_builder.json +1 -0
package/default-themes/nebula-dawn.css +682 -0
package/default-themes/nebula-dawn.json +19 -0
package/default-themes/nebula-dusk.css +674 -0
package/default-themes/nebula-dusk.json +19 -0
package/dist/connectors/index.d.ts +3 -0
package/dist/connectors/index.d.ts.map +1 -0
package/dist/connectors/index.js +6 -0
package/dist/connectors/index.js.map +1 -0
package/dist/connectors/registry.d.ts +3 -0
package/dist/connectors/registry.d.ts.map +1 -0
package/dist/connectors/registry.js +100 -0
package/dist/connectors/registry.js.map +1 -0
package/dist/connectors/types.d.ts +61 -0
package/dist/connectors/types.d.ts.map +1 -0
package/dist/connectors/types.js +3 -0
package/dist/connectors/types.js.map +1 -0
package/dist/files.d.ts +2 -0
package/dist/files.d.ts.map +1 -1
package/dist/files.js +12 -1
package/dist/files.js.map +1 -1
package/dist/init.d.ts +8 -1
package/dist/init.d.ts.map +1 -1
package/dist/init.js +155 -3
package/dist/init.js.map +1 -1
package/dist/migrations.d.ts +11 -0
package/dist/migrations.d.ts.map +1 -0
package/dist/migrations.js +281 -0
package/dist/migrations.js.map +1 -0
package/dist/models/index.d.ts +3 -0
package/dist/models/index.d.ts.map +1 -0
package/dist/models/index.js +10 -0
package/dist/models/index.js.map +1 -0
package/dist/models/providers.d.ts +7 -0
package/dist/models/providers.d.ts.map +1 -0
package/dist/models/providers.js +33 -0
package/dist/models/providers.js.map +1 -0
package/dist/models/types.d.ts +21 -0
package/dist/models/types.d.ts.map +1 -0
package/dist/models/types.js +3 -0
package/dist/models/types.js.map +1 -0
package/dist/pages.d.ts +21 -2
package/dist/pages.d.ts.map +1 -1
package/dist/pages.js +202 -23
package/dist/pages.js.map +1 -1
package/dist/scripts.js +2 -2
package/dist/scripts.js.map +1 -1
package/dist/service/createCompletePrompt.d.ts +3 -2
package/dist/service/createCompletePrompt.d.ts.map +1 -1
package/dist/service/createCompletePrompt.js +11 -16
package/dist/service/createCompletePrompt.js.map +1 -1
package/dist/service/debugLog.d.ts +11 -0
package/dist/service/debugLog.d.ts.map +1 -0
package/dist/service/debugLog.js +26 -0
package/dist/service/debugLog.js.map +1 -0
package/dist/service/modelInstructions.d.ts +7 -0
package/dist/service/modelInstructions.d.ts.map +1 -0
package/dist/service/modelInstructions.js +16 -0
package/dist/service/modelInstructions.js.map +1 -0
package/dist/service/requiresSettings.d.ts +2 -2
package/dist/service/requiresSettings.d.ts.map +1 -1
package/dist/service/requiresSettings.js.map +1 -1
package/dist/service/server.d.ts.map +1 -1
package/dist/service/server.js +15 -0
package/dist/service/server.js.map +1 -1
package/dist/service/transformPage.d.ts +81 -2
package/dist/service/transformPage.d.ts.map +1 -1
package/dist/service/transformPage.js +672 -82
package/dist/service/transformPage.js.map +1 -1
package/dist/service/useApiRoutes.d.ts.map +1 -1
package/dist/service/useApiRoutes.js +579 -13
package/dist/service/useApiRoutes.js.map +1 -1
package/dist/service/useConnectorRoutes.d.ts +4 -0
package/dist/service/useConnectorRoutes.d.ts.map +1 -0
package/dist/service/useConnectorRoutes.js +389 -0
package/dist/service/useConnectorRoutes.js.map +1 -0
package/dist/service/useDataRoutes.d.ts.map +1 -1
package/dist/service/useDataRoutes.js +83 -70
package/dist/service/useDataRoutes.js.map +1 -1
package/dist/service/usePageRoutes.d.ts.map +1 -1
package/dist/service/usePageRoutes.js +243 -38
package/dist/service/usePageRoutes.js.map +1 -1
package/dist/settings.d.ts +33 -4
package/dist/settings.d.ts.map +1 -1
package/dist/settings.js +108 -15
package/dist/settings.js.map +1 -1
package/dist/synthos-cli.d.ts.map +1 -1
package/dist/synthos-cli.js +11 -1
package/dist/synthos-cli.js.map +1 -1
package/dist/themes.d.ts +9 -0
package/dist/themes.d.ts.map +1 -0
package/dist/themes.js +64 -0
package/dist/themes.js.map +1 -0
package/package.json +6 -3
package/required-pages/builder.html +74 -0
package/required-pages/builder.json +1 -0
package/required-pages/pages.html +169 -126
package/required-pages/pages.json +1 -0
package/required-pages/settings.html +812 -156
package/required-pages/settings.json +1 -0
package/required-pages/synthos_apis.html +272 -0
package/required-pages/synthos_apis.json +1 -0
package/required-pages/synthos_scripts.html +87 -0
package/required-pages/synthos_scripts.json +1 -0
package/src/connectors/index.ts +12 -0
package/src/connectors/registry.ts +98 -0
package/src/connectors/types.ts +68 -0
package/src/files.ts +11 -0
package/src/init.ts +151 -5
package/src/migrations.ts +266 -0
package/src/models/index.ts +2 -0
package/src/models/providers.ts +33 -0
package/src/models/types.ts +23 -0
package/src/pages.ts +234 -26
package/src/scripts.ts +2 -2
package/src/service/createCompletePrompt.ts +14 -18
package/src/service/debugLog.ts +17 -0
package/src/service/modelInstructions.ts +14 -0
package/src/service/requiresSettings.ts +3 -3
package/src/service/server.ts +19 -2
package/src/service/transformPage.ts +709 -88
package/src/service/useApiRoutes.ts +632 -16
package/src/service/useConnectorRoutes.ts +427 -0
package/src/service/useDataRoutes.ts +87 -71
package/src/service/usePageRoutes.ts +237 -44
package/src/settings.ts +143 -20
package/src/synthos-cli.ts +11 -1
package/src/themes.ts +71 -0
package/default-pages/[application].html +0 -95
package/default-pages/[markdown].html +0 -271
package/default-pages/[sidebar].html +0 -114
package/default-pages/[split-application].html +0 -118
package/default-pages/solar_system.html +0 -432
package/default-pages/space_invaders.html +0 -617
package/required-pages/apis.html +0 -362
package/required-pages/home.html +0 -126
package/required-pages/scripts.html +0 -350

package/src/service/usePageRoutes.ts CHANGED Viewed

@@ -1,14 +1,95 @@
-import { loadPageState, normalizePageName, savePageState, updatePageState } from "../pages";
-import { hasConfiguredSettings, loadSettings } from "../settings";
+import { loadPageMetadata, loadPageState, normalizePageName, PAGE_VERSION, REQUIRED_PAGES, savePageMetadata, savePageState, updatePageState } from "../pages";
+import { getModelEntry, hasConfiguredSettings, loadSettings } from "../settings";
 import { Application } from 'express';
-import { transformPage, transformPageAsObject } from "./transformPage";
+import { transformPage } from "./transformPage";
+import { getModelInstructions } from "./modelInstructions";
 import { SynthOSConfig } from "../init";
 import { createCompletePrompt } from "./createCompletePrompt";
 import { completePrompt } from "agentm-core";
+import { green, red, dim, estimateTokens } from "./debugLog";
+import { loadThemeInfo } from "../themes";
+import * as cheerio from 'cheerio';
-const HOME_PAGE_ROUTE = '/home';
+/**
+ * Required CDN imports that must be present on every v2 page.
+ * Each entry maps a detection selector to the script tag src to inject.
+ */
+const REQUIRED_IMPORTS: { selector: string; src: string }[] = [
+    { selector: 'script[src*="marked"]', src: 'https://cdnjs.cloudflare.com/ajax/libs/marked/14.1.1/marked.min.js' },
+];
+/**
+ * Uses cheerio to ensure every required import is present in the page's <head>.
+ * Skips imports that already exist (detected via selector).
+ */
+function ensureRequiredImports(html: string, pageVersion: number): string {
+    if (pageVersion < 2) return html;
+    const $ = cheerio.load(html);
+    for (const imp of REQUIRED_IMPORTS) {
+        if ($(imp.selector).length === 0) {
+            $('head').append(`<script src="${imp.src}"></script>\n`);
+        }
+    }
+    return $.html();
+}
+const HOME_PAGE_ROUTE = '/builder';
 const PAGE_NOT_FOUND = 'Page not found';
+function injectPageInfoScript(html: string, pageName: string): string {
+    const tag = `<script id="page-info" src="/api/page-info.js?page=${encodeURIComponent(pageName)}"></script>`;
+    // Replace any existing page-info script (may have a stale page name from the template)
+    const existing = html.match(/<script\s+id="page-info"[^>]*><\/script>/);
+    if (existing) {
+        return html.replace(existing[0], tag);
+    }
+    const idx = html.indexOf('</head>');
+    if (idx !== -1) {
+        return html.slice(0, idx) + tag + '\n' + html.slice(idx);
+    }
+    return tag + '\n' + html;
+}
+function injectPageHelpers(html: string, pageVersion: number): string {
+    if (pageVersion < 2) return html;
+    const tag = `<script id="page-helpers" src="/api/page-helpers.js?v=${pageVersion}"></script>`;
+    // Replace any existing page-helpers script (may be at wrong position from prior LLM output)
+    const existing = html.match(/<script\s+id="page-helpers"[^>]*><\/script>/);
+    if (existing) {
+        return html.replace(existing[0], tag);
+    }
+    // Inject into <head> after page-info so helpers are available before inline body scripts
+    const pageInfo = html.indexOf('id="page-info"');
+    if (pageInfo !== -1) {
+        const closeTag = html.indexOf('</script>', pageInfo);
+        if (closeTag !== -1) {
+            const insertAt = closeTag + '</script>'.length;
+            return html.slice(0, insertAt) + '\n' + tag + html.slice(insertAt);
+        }
+    }
+    const idx = html.indexOf('</head>');
+    if (idx !== -1) {
+        return html.slice(0, idx) + tag + '\n' + html.slice(idx);
+    }
+    return tag + '\n' + html;
+}
+function injectPageScript(html: string, pageVersion: number): string {
+    if (pageVersion < 2) return html;
+    if (html.includes('id="page-script"')) return html;
+    const tag = `<script id="page-script" src="/api/page-script.js?v=${pageVersion}"></script>`;
+    const idx = html.indexOf('</body>');
+    if (idx !== -1) {
+        return html.slice(0, idx) + tag + '\n' + html.slice(idx);
+    }
+    return html + '\n' + tag;
+}
 export function usePageRoutes(config: SynthOSConfig, app: Application): void {
     // Redirect / to /home page
     app.get('/', (req, res) => res.redirect(HOME_PAGE_ROUTE));
@@ -19,7 +100,7 @@ export function usePageRoutes(config: SynthOSConfig, app: Application): void {
         const { page } = req.params;
         const isConfigured = await hasConfiguredSettings(config.pagesFolder);
         if (!isConfigured && page !== 'settings') {
-            res.redirect('/settings');
+            res.redirect('/settings?firstRun=1');
             return;
         }
@@ -30,7 +111,21 @@ export function usePageRoutes(config: SynthOSConfig, app: Application): void {
             return;
         }
-        res.send(pageState);
+        // Load page metadata for version-based script injection
+        const metadata = await loadPageMetadata(config.pagesFolder, page, config.requiredPagesFolder);
+        const pageVersion = metadata?.pageVersion ?? 0;
+        // Block outdated pages (redirect to /pages so user sees upgrade UI)
+        if (pageVersion < PAGE_VERSION && !REQUIRED_PAGES.includes(page)) {
+            res.redirect('/pages');
+            return;
+        }
+        let html = ensureRequiredImports(pageState, pageVersion);
+        html = injectPageInfoScript(html, page);
+        html = injectPageHelpers(html, pageVersion);
+        html = injectPageScript(html, pageVersion);
+        res.send(html);
     });
     // Page reset
@@ -39,7 +134,7 @@ export function usePageRoutes(config: SynthOSConfig, app: Application): void {
         const { page } = req.params;
         const isConfigured = await hasConfiguredSettings(config.pagesFolder);
         if (!isConfigured) {
-            res.redirect('/settings');
+            res.redirect('/settings?firstRun=1');
             return;
         }
@@ -54,32 +149,82 @@ export function usePageRoutes(config: SynthOSConfig, app: Application): void {
     });
     // Page save
-    app.get('/:page/save', async (req, res) => {
-        // Redirect if settings not configured
-        const { page } = req.params;
-        const isConfigured = await hasConfiguredSettings(config.pagesFolder);
-        if (!isConfigured) {
-            res.redirect('/settings');
-            return;
-        }
+    app.post('/:page/save', async (req, res) => {
+        try {
+            // Redirect if settings not configured
+            const { page } = req.params;
+            const isConfigured = await hasConfiguredSettings(config.pagesFolder);
+            if (!isConfigured) {
+                res.status(400).json({ error: 'Settings not configured' });
+                return;
+            }
-        // Normalize and validate save-as parameter
-        const saveAs = normalizePageName(req.query['name'] as string);
-        if (!saveAs) {
-            res.status(400).send('Invalid or missing name parameter');
-            return;
-        }
+            // Extract fields from JSON body
+            const { title, categories, greeting } = req.body;
+            if (!title || typeof title !== 'string') {
+                res.status(400).json({ error: 'title is required' });
+                return;
+            }
+            if (!categories || !Array.isArray(categories) || categories.length === 0) {
+                res.status(400).json({ error: 'categories is required (array of strings)' });
+                return;
+            }
-        // Load page state
-        const pageState = await loadPageWithFallback(page, config, false);
-        if (!pageState) {
-            res.status(404).send(PAGE_NOT_FOUND);
-            return;
-        }
+            // Normalize page name from title
+            const saveAs = normalizePageName(title);
+            if (!saveAs) {
+                res.status(400).json({ error: 'Invalid title — cannot derive a page name' });
+                return;
+            }
+            // Reject reserved names
+            if (saveAs === 'builder') {
+                res.status(400).json({ error: '"Builder" is a reserved page name' });
+                return;
+            }
+            // Load page state
+            let pageState = await loadPageWithFallback(page, config, false);
+            if (!pageState) {
+                res.status(404).json({ error: PAGE_NOT_FOUND });
+                return;
+            }
+            // If greeting is provided, process with cheerio
+            if (greeting && typeof greeting === 'string' && greeting.trim().length > 0) {
+                const $ = cheerio.load(pageState);
+                const messages = $('#chatMessages .chat-message');
+                // Keep only the first message, remove the rest
+                messages.slice(1).remove();
+                // Update the greeting text in the first message
+                const firstP = messages.first().find('p');
+                const strong = firstP.find('strong');
+                if (strong.length) {
+                    firstP.html('<strong>Synthos:</strong> ' + greeting.trim());
+                }
+                pageState = $.html();
+            }
+            // Save as new page
+            await savePageState(config.pagesFolder, saveAs, pageState, title, categories);
+            // Also update metadata with categories (in case page.json already existed)
+            await savePageMetadata(config.pagesFolder, saveAs, {
+                title,
+                categories,
+                pinned: false,
+                showInAll: true,
+                createdDate: new Date().toISOString(),
+                lastModified: new Date().toISOString(),
+                pageVersion: PAGE_VERSION,
+                mode: 'unlocked',
+            });
-        // Save as new page and redirect to saved page
-        await savePageState(config.pagesFolder, saveAs, pageState);
-        res.redirect(`/${saveAs}`);
+            res.json({ redirect: `/${saveAs}` });
+        } catch (err: unknown) {
+            console.error(err);
+            res.status(500).json({ error: (err as Error).message });
+        }
     });
     // Page transformation
@@ -108,28 +253,76 @@ export function usePageRoutes(config: SynthOSConfig, app: Application): void {
             }
             // Create model instance
-            const innerCompletePrompt = await createCompletePrompt(config.pagesFolder, req.body.model);
-            const completePrompt: completePrompt = (args) => {
-                // console.log(`SYSTEM:\n${args.system!.content}`);
-                // console.log(`PROMPT:\n${args.prompt!.content}`);
-                return innerCompletePrompt(args);
+            const innerCompletePrompt = await createCompletePrompt(config.pagesFolder, 'builder', req.body.model);
+            const debugVerbose = config.debugPageUpdates;
+            let inputChars = 0;
+            let outputChars = 0;
+            const completePrompt: completePrompt = async (args) => {
+                if (debugVerbose) {
+                    console.log(green(dim('\n  ===== PAGE UPDATE REQUEST =====')));
+                    console.log(green(`  SYSTEM:\n${args.system?.content}`));
+                    console.log(green(`\n  PROMPT:\n${args.prompt.content}`));
+                }
+                inputChars += (args.system?.content?.length ?? 0) + (args.prompt.content?.length ?? 0);
+                const result = await innerCompletePrompt(args);
+                if (result.completed) {
+                    outputChars += result.value?.length ?? 0;
+                }
+                if (debugVerbose) {
+                    console.log(green(dim('\n  ----- PAGE UPDATE RESPONSE -----')));
+                    if (result.completed) {
+                        console.log(green(`  RESPONSE:\n${result.value}`));
+                    } else {
+                        console.log(red(`  ERROR: ${result.error?.message}`));
+                    }
+                    console.log(green(dim('  ================================\n')));
+                }
+                return result;
             }
-            // Transform and cache updated page
+            // Transform and cache updated page
             const pagesFolder = config.pagesFolder;
-            const { maxTokens, instructions, model } = await loadSettings(config.pagesFolder);
-            const result = model.startsWith('gpt-') ?
-                await transformPageAsObject({ pagesFolder, pageState, message, maxTokens, instructions, completePrompt }) :
-                await transformPage({ pagesFolder, pageState, message, maxTokens, instructions, completePrompt });
+            const settings = await loadSettings(config.pagesFolder);
+            const builder = getModelEntry(settings, 'builder');
+            const { configuration, instructions } = builder;
+            const maxTokens = configuration.maxTokens;
+            const theme = settings.theme;
+            const themeInfo = await loadThemeInfo(theme ?? 'nebula-dusk', config);
+            const modelInstructions = getModelInstructions(builder.provider);
+            const configuredConnectors = settings.connectors;
+            const result = await transformPage({ pagesFolder, pageState, message, maxTokens, instructions, modelInstructions, completePrompt, themeInfo, configuredConnectors });
             if (result.completed) {
-                updatePageState(page, result.value!);
-                res.send(result.value!);
+                const { html, changeCount } = result.value!;
+                if (config.debug) {
+                    const inTokens = estimateTokens(inputChars).toLocaleString();
+                    const outTokens = estimateTokens(outputChars).toLocaleString();
+                    console.log(`  page: ${page} | message: ${message.length} chars | changes: ${changeCount} ops | ~${inTokens} in / ~${outTokens} out tokens`);
+                }
+                updatePageState(page, html);
+                // Update lastModified timestamp in page metadata
+                const metadata = await loadPageMetadata(pagesFolder, page, config.requiredPagesFolder);
+                if (metadata) {
+                    metadata.lastModified = new Date().toISOString();
+                    await savePageMetadata(pagesFolder, page, metadata);
+                }
+                // Inject required imports and page scripts (same as GET)
+                const pv = metadata?.pageVersion ?? 0;
+                let out = ensureRequiredImports(html, pv);
+                out = injectPageInfoScript(out, page);
+                out = injectPageHelpers(out, pv);
+                out = injectPageScript(out, pv);
+                res.send(out);
             } else {
                 throw result.error;
             }
         } catch (err: unknown) {
-            console.error(err);
+            if (config.debug) {
+                console.log(red(`  ERROR: ${(err as Error).message}`));
+            } else {
+                console.error(err);
+            }
             res.status(500).send((err as Error).message);
         }
     });

package/src/settings.ts CHANGED Viewed

@@ -1,60 +1,183 @@
 import {checkIfExists, loadFile, saveFile} from './files';
 import path from 'path';
+import { ModelEntry, ProviderName, detectProvider } from './models';
-let _settings: Partial<Settings>|undefined;
+let _settings: Partial<SettingsV2>|undefined;
-export interface Settings {
+export interface ServiceConfig {
+    apiKey: string;
+    enabled: boolean;
+}
+export type ServicesConfig = { [serviceId: string]: ServiceConfig };
+// Re-export ModelEntry from models so existing imports from settings still work
+export type { ModelEntry } from './models';
+/**
+ * V1 settings shape (flat, single model). Used as migration source.
+ */
+export interface SettingsV1 {
     serviceApiKey: string;
     model: string;
     maxTokens: number;
     imageQuality: 'standard' | 'hd';
     instructions?: string;
     logCompletions?: boolean;
+    theme?: string;
+    services?: ServicesConfig;
 }
-export const DefaultSettings: Settings = {
-    serviceApiKey: '',
-    model: '',
-    maxTokens: 32000,
-    imageQuality: 'standard',
-    instructions: '',
-    logCompletions: false
+/**
+ * V2 settings shape with versioned models array.
+ */
+export interface SettingsV2 {
+    version: 2;
+    theme: string;
+    models: ModelEntry[];
+    features: string[];
+    services?: ServicesConfig;
+    connectors?: ServicesConfig;
+}
+export const DefaultSettings: SettingsV2 = {
+    version: 2,
+    theme: 'nebula-dawn',
+    models: [
+        {
+            use: 'builder',
+            provider: 'Anthropic',
+            configuration: { apiKey: '', model: '', maxTokens: 32000 },
+            imageQuality: 'standard',
+            instructions: '',
+            logCompletions: false,
+        },
+        {
+            use: 'chat',
+            provider: 'Anthropic',
+            configuration: { apiKey: '', model: '', maxTokens: 32000 },
+            imageQuality: 'standard',
+            instructions: '',
+            logCompletions: false,
+        },
+    ],
+    features: [],
+    services: {},
+    connectors: {}
 };
+/**
+ * Find a model entry by its `use` field. Falls back to default if not found.
+ */
+export function getModelEntry(settings: SettingsV2, use: 'builder' | 'chat'): ModelEntry {
+    const entry = settings.models.find(m => m.use === use);
+    if (entry) return entry;
+    return DefaultSettings.models.find(m => m.use === use)!;
+}
+/**
+ * Migrate a v1 settings object to v2 by detecting provider from model prefix
+ * and wrapping fields into the new configuration object.
+ */
+function migrateV1toV2(raw: Record<string, unknown>): SettingsV2 {
+    const v1 = raw as unknown as SettingsV1;
+    const rawModel = v1.model ?? '';
+    // Migrate retired model names
+    const model = rawModel === 'claude-opus-4-5' ? 'claude-opus-4-6' : rawModel;
+    const detected = detectProvider(model);
+    const provider: ProviderName = detected?.name ?? 'Anthropic';
+    // Default chat to claude-haiku-4-5 when migrating from an Anthropic model
+    const chatModel = provider === 'Anthropic' ? 'claude-haiku-4-5' : model;
+    return {
+        version: 2,
+        theme: v1.theme ?? 'nebula-dusk',
+        models: [
+            {
+                use: 'builder',
+                provider,
+                configuration: {
+                    apiKey: v1.serviceApiKey ?? '',
+                    model,
+                    maxTokens: v1.maxTokens ?? 32000,
+                },
+                imageQuality: v1.imageQuality ?? 'standard',
+                instructions: v1.instructions ?? '',
+                logCompletions: v1.logCompletions ?? false,
+            },
+            {
+                use: 'chat',
+                provider,
+                configuration: {
+                    apiKey: v1.serviceApiKey ?? '',
+                    model: chatModel,
+                    maxTokens: v1.maxTokens ?? 32000,
+                },
+                imageQuality: v1.imageQuality ?? 'standard',
+                instructions: v1.instructions ?? '',
+                logCompletions: v1.logCompletions ?? false,
+            },
+        ],
+        features: [],
+        services: v1.services,
+    };
+}
 export async function hasConfiguredSettings(folder: string): Promise<boolean> {
     const settings = await loadSettings(folder);
-    if (typeof settings.serviceApiKey !== 'string' || settings.serviceApiKey.length == 0) {
+    const builder = getModelEntry(settings, 'builder');
+    if (typeof builder.configuration.apiKey !== 'string' || builder.configuration.apiKey.length == 0) {
         return false;
     }
-    if (typeof settings.model !== 'string' || settings.model.length == 0) {
+    if (typeof builder.configuration.model !== 'string' || builder.configuration.model.length == 0) {
         return false;
     }
-    if (typeof settings.maxTokens !== 'number' || settings.maxTokens <= 0) {
+    if (typeof builder.configuration.maxTokens !== 'number' || builder.configuration.maxTokens <= 0) {
         return false;
     }
-    return true;
+    return true;
 }
-export async function loadSettings(folder: string): Promise<Settings> {
+export async function loadSettings(folder: string): Promise<SettingsV2> {
     if (_settings == undefined) {
-        // Check for file to exist
         const filename = path.join(folder, 'settings.json');
         if (await checkIfExists(filename)) {
             try {
-                // Load and parse file
-                _settings = JSON.parse(await loadFile(filename));
+                const raw = JSON.parse(await loadFile(filename));
+                if (!raw.version) {
+                    // V1 file — migrate
+                    console.log('Migrating settings.json from v1 to v2...');
+                    const migrated = migrateV1toV2(raw);
+                    _settings = migrated;
+                    await saveFile(filename, JSON.stringify(migrated, null, 4));
+                } else {
+                    _settings = raw as Partial<SettingsV2>;
+                }
             } catch {
                 // Invalid JSON
             }
         }
     }
-    // Return settings from file
-    return {...DefaultSettings, ..._settings};
+    const merged = {...DefaultSettings, ..._settings, models: _settings?.models ?? DefaultSettings.models};
+    // Auto-migrate: copy services into connectors if connectors is empty
+    const connectors = merged.connectors ?? {};
+    const services = merged.services ?? {};
+    if (Object.keys(connectors).length === 0 && Object.keys(services).length > 0) {
+        merged.connectors = { ...services };
+    }
+    return merged;
 }
-export async function saveSettings(folder: string, settings: Partial<Settings>): Promise<void> {
+export async function saveSettings(folder: string, settings: Partial<SettingsV2>): Promise<void> {
     _settings = {..._settings, ...settings};
+    if (settings.models) {
+        _settings.models = settings.models;
+    }
+    _settings.version = 2;
     await saveFile(path.join(folder, 'settings.json'), JSON.stringify(_settings, null, 4));
 }

package/src/synthos-cli.ts CHANGED Viewed

@@ -20,9 +20,19 @@ export async function run() {
                     type: 'boolean',
                     default: true
                 })
+                .option('debug', {
+                    describe: `Log all server requests with timing and page update summaries.`,
+                    type: 'boolean',
+                    default: false
+                })
+                .option('debug-page-updates', {
+                    describe: `Log model input/output for page transformations to the console.`,
+                    type: 'boolean',
+                    default: false
+                })
                 .demandOption([]);
         }, async (args) => {
-            const config = createConfig();
+            const config = createConfig('.synthos', { debug: args.debug, debugPageUpdates: args.debugPageUpdates });
             await init(config, args.pages);
             await server(config).listen(args.port, async () => {
                 console.log(`SynthOS server is running on http://localhost:${args.port}`);

package/src/themes.ts ADDED Viewed

@@ -0,0 +1,71 @@
+import path from 'path';
+import { checkIfExists, listFiles, loadFile } from './files';
+import { SynthOSConfig } from './init';
+export interface ThemeInfo {
+    mode: 'light' | 'dark';
+    colors: Record<string, string>;
+}
+function userThemesFolder(config: SynthOSConfig): string {
+    return path.join(config.pagesFolder, 'themes');
+}
+export async function loadThemeInfo(name: string, config: SynthOSConfig): Promise<ThemeInfo | undefined> {
+    // Check user's local themes first, then fall back to package defaults
+    const localPath = path.join(userThemesFolder(config), `${name}.json`);
+    if (await checkIfExists(localPath)) {
+        const raw = await loadFile(localPath);
+        return raw ? JSON.parse(raw) : undefined;
+    }
+    const defaultPath = path.join(config.defaultThemesFolder, `${name}.json`);
+    if (await checkIfExists(defaultPath)) {
+        const raw = await loadFile(defaultPath);
+        return raw ? JSON.parse(raw) : undefined;
+    }
+    return undefined;
+}
+export async function loadTheme(name: string, config: SynthOSConfig): Promise<string | undefined> {
+    // Check user's local themes first, then fall back to package defaults
+    const localPath = path.join(userThemesFolder(config), `${name}.css`);
+    if (await checkIfExists(localPath)) {
+        return await loadFile(localPath);
+    }
+    const defaultPath = path.join(config.defaultThemesFolder, `${name}.css`);
+    if (await checkIfExists(defaultPath)) {
+        return await loadFile(defaultPath);
+    }
+    return undefined;
+}
+export async function listThemes(config: SynthOSConfig): Promise<string[]> {
+    const names = new Set<string>();
+    // Collect from user's local themes folder
+    const localFolder = userThemesFolder(config);
+    if (await checkIfExists(localFolder)) {
+        const files = await listFiles(localFolder);
+        for (const f of files) {
+            if (f.endsWith('.css')) {
+                names.add(f.replace(/\.css$/, ''));
+            }
+        }
+    }
+    // Collect from package defaults
+    if (await checkIfExists(config.defaultThemesFolder)) {
+        const files = await listFiles(config.defaultThemesFolder);
+        for (const f of files) {
+            if (f.endsWith('.css')) {
+                names.add(f.replace(/\.css$/, ''));
+            }
+        }
+    }
+    return Array.from(names).sort();
+}