synthos 0.6.0 → 0.7.0

package/dist/settings.js

@@ -3,27 +3,102 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.saveSettings = exports.loadSettings = exports.hasConfiguredSettings = exports.DefaultSettings = void 0;
+exports.saveSettings = exports.loadSettings = exports.hasConfiguredSettings = exports.getModelEntry = exports.DefaultSettings = void 0;
 const files_1 = require("./files");
 const path_1 = __importDefault(require("path"));
+const models_1 = require("./models");
 let _settings;
 exports.DefaultSettings = {
-    serviceApiKey: '',
-    model: '',
-    maxTokens: 32000,
-    imageQuality: 'standard',
-    instructions: '',
-    logCompletions: false
+    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.
+ */
+function getModelEntry(settings, use) {
+    const entry = settings.models.find(m => m.use === use);
+    if (entry)
+        return entry;
+    return exports.DefaultSettings.models.find(m => m.use === use);
+}
+exports.getModelEntry = getModelEntry;
+/**
+ * Migrate a v1 settings object to v2 by detecting provider from model prefix
+ * and wrapping fields into the new configuration object.
+ */
+function migrateV1toV2(raw) {
+    const v1 = raw;
+    const rawModel = v1.model ?? '';
+    // Migrate retired model names
+    const model = rawModel === 'claude-opus-4-5' ? 'claude-opus-4-6' : rawModel;
+    const detected = (0, models_1.detectProvider)(model);
+    const provider = 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,
+    };
+}
 async function hasConfiguredSettings(folder) {
     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;
@@ -31,24 +106,42 @@ async function hasConfiguredSettings(folder) {
 exports.hasConfiguredSettings = hasConfiguredSettings;
 async function loadSettings(folder) {
     if (_settings == undefined) {
-        // Check for file to exist
         const filename = path_1.default.join(folder, 'settings.json');
         if (await (0, files_1.checkIfExists)(filename)) {
             try {
-                // Load and parse file
-                _settings = JSON.parse(await (0, files_1.loadFile)(filename));
+                const raw = JSON.parse(await (0, files_1.loadFile)(filename));
+                if (!raw.version) {
+                    // V1 file — migrate
+                    console.log('Migrating settings.json from v1 to v2...');
+                    const migrated = migrateV1toV2(raw);
+                    _settings = migrated;
+                    await (0, files_1.saveFile)(filename, JSON.stringify(migrated, null, 4));
+                }
+                else {
+                    _settings = raw;
+                }
             }
             catch {
                 // Invalid JSON
             }
         }
     }
-    // Return settings from file
-    return { ...exports.DefaultSettings, ..._settings };
+    const merged = { ...exports.DefaultSettings, ..._settings, models: _settings?.models ?? exports.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;
 }
 exports.loadSettings = loadSettings;
 async function saveSettings(folder, settings) {
     _settings = { ..._settings, ...settings };
+    if (settings.models) {
+        _settings.models = settings.models;
+    }
+    _settings.version = 2;
     await (0, files_1.saveFile)(path_1.default.join(folder, 'settings.json'), JSON.stringify(_settings, null, 4));
 }
 exports.saveSettings = saveSettings;

package/dist/settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":";;;;;;AAAA,mCAA0D;AAC1D,gDAAwB;AAExB,IAAI,SAAsC,CAAC;AAW9B,QAAA,eAAe,GAAa;IACrC,aAAa,EAAE,EAAE;IACjB,KAAK,EAAE,EAAE;IACT,SAAS,EAAE,KAAK;IAChB,YAAY,EAAE,UAAU;IACxB,YAAY,EAAE,EAAE;IAChB,cAAc,EAAE,KAAK;CACxB,CAAC;AAEK,KAAK,UAAU,qBAAqB,CAAC,MAAc;IACtD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,OAAO,QAAQ,CAAC,aAAa,KAAK,QAAQ,IAAI,QAAQ,CAAC,aAAa,CAAC,MAAM,IAAI,CAAC,EAAE;QAClF,OAAO,KAAK,CAAC;KAChB;IACD,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE;QAClE,OAAO,KAAK,CAAC;KAChB;IACD,IAAI,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,IAAI,QAAQ,CAAC,SAAS,IAAI,CAAC,EAAE;QACnE,OAAO,KAAK,CAAC;KAChB;IAED,OAAO,IAAI,CAAC;AAChB,CAAC;AAbD,sDAaC;AAEM,KAAK,UAAU,YAAY,CAAC,MAAc;IAC7C,IAAI,SAAS,IAAI,SAAS,EAAE;QACxB,0BAA0B;QAC1B,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QACpD,IAAI,MAAM,IAAA,qBAAa,EAAC,QAAQ,CAAC,EAAE;YAC/B,IAAI;gBACA,sBAAsB;gBACtB,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAA,gBAAQ,EAAC,QAAQ,CAAC,CAAC,CAAC;aACpD;YAAC,MAAM;gBACJ,eAAe;aAClB;SACJ;KACJ;IAED,4BAA4B;IAC5B,OAAO,EAAC,GAAG,uBAAe,EAAE,GAAG,SAAS,EAAC,CAAC;AAC9C,CAAC;AAhBD,oCAgBC;AAEM,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,QAA2B;IAC1E,SAAS,GAAG,EAAC,GAAG,SAAS,EAAE,GAAG,QAAQ,EAAC,CAAC;IACxC,MAAM,IAAA,gBAAQ,EAAC,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC3F,CAAC;AAHD,oCAGC"}
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}

package/dist/synthos-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"synthos-cli.d.ts","sourceRoot":"","sources":["../src/synthos-cli.ts"],"names":[],"mappings":"AAOA,wBAAsB,GAAG,kBA8BxB"}
+{"version":3,"file":"synthos-cli.d.ts","sourceRoot":"","sources":["../src/synthos-cli.ts"],"names":[],"mappings":"AAOA,wBAAsB,GAAG,kBAwCxB"}

package/dist/synthos-cli.js

@@ -23,10 +23,20 @@ async function run() {
             describe: `Include default pages when initializing a new .synthos folder.`,
             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 = (0, init_1.createConfig)();
+        const config = (0, init_1.createConfig)('.synthos', { debug: args.debug, debugPageUpdates: args.debugPageUpdates });
         await (0, init_1.init)(config, args.pages);
         await (0, service_1.server)(config).listen(args.port, async () => {
             console.log(`SynthOS server is running on http://localhost:${args.port}`);

package/dist/synthos-cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"synthos-cli.js","sourceRoot":"","sources":["../src/synthos-cli.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA0B;AAC1B,2CAAwC;AACxC,uCAAmC;AACnC,iCAA4C;AAE5C,MAAM,aAAa,GAAG,IAAI,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAC,CAAC;AAErE,KAAK,UAAU,GAAG;IACrB,MAAM,IAAA,eAAK,EAAC,IAAA,iBAAO,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC;SAC7B,UAAU,CAAC,SAAS,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,4BAA4B,EAAE,CAAC,KAAK,EAAE,EAAE;QACtD,OAAO,KAAK;aACP,MAAM,CAAC,MAAM,EAAE;YACZ,QAAQ,EAAE,yBAAyB;YACnC,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,IAAI;SAChB,CAAC;aACD,MAAM,CAAC,OAAO,EAAE;YACb,QAAQ,EAAE,gEAAgE;YAC1E,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;SAChB,CAAC;aACD,YAAY,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,IAAA,mBAAY,GAAE,CAAC;QAC9B,MAAM,IAAA,WAAI,EAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,IAAA,gBAAM,EAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YAC9C,OAAO,CAAC,GAAG,CAAC,iDAAiD,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAE1E,6BAA6B;YAC7B,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,CAAC,oBAAoB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;SACD,IAAI,EAAE;SACN,aAAa,EAAE;SACf,UAAU,EAAE,CAAC;AACtB,CAAC;AA9BD,kBA8BC"}
+{"version":3,"file":"synthos-cli.js","sourceRoot":"","sources":["../src/synthos-cli.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA0B;AAC1B,2CAAwC;AACxC,uCAAmC;AACnC,iCAA4C;AAE5C,MAAM,aAAa,GAAG,IAAI,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAC,CAAC;AAErE,KAAK,UAAU,GAAG;IACrB,MAAM,IAAA,eAAK,EAAC,IAAA,iBAAO,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC;SAC7B,UAAU,CAAC,SAAS,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,4BAA4B,EAAE,CAAC,KAAK,EAAE,EAAE;QACtD,OAAO,KAAK;aACP,MAAM,CAAC,MAAM,EAAE;YACZ,QAAQ,EAAE,yBAAyB;YACnC,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,IAAI;SAChB,CAAC;aACD,MAAM,CAAC,OAAO,EAAE;YACb,QAAQ,EAAE,gEAAgE;YAC1E,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;SAChB,CAAC;aACD,MAAM,CAAC,OAAO,EAAE;YACb,QAAQ,EAAE,gEAAgE;YAC1E,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;SACjB,CAAC;aACD,MAAM,CAAC,oBAAoB,EAAE;YAC1B,QAAQ,EAAE,iEAAiE;YAC3E,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;SACjB,CAAC;aACD,YAAY,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,IAAA,mBAAY,EAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACxG,MAAM,IAAA,WAAI,EAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,IAAA,gBAAM,EAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YAC9C,OAAO,CAAC,GAAG,CAAC,iDAAiD,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAE1E,6BAA6B;YAC7B,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,CAAC,oBAAoB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;SACD,IAAI,EAAE;SACN,aAAa,EAAE;SACf,UAAU,EAAE,CAAC;AACtB,CAAC;AAxCD,kBAwCC"}

package/dist/themes.d.ts

@@ -0,0 +1,9 @@
+import { SynthOSConfig } from './init';
+export interface ThemeInfo {
+    mode: 'light' | 'dark';
+    colors: Record<string, string>;
+}
+export declare function loadThemeInfo(name: string, config: SynthOSConfig): Promise<ThemeInfo | undefined>;
+export declare function loadTheme(name: string, config: SynthOSConfig): Promise<string | undefined>;
+export declare function listThemes(config: SynthOSConfig): Promise<string[]>;
+//# sourceMappingURL=themes.d.ts.map

package/dist/themes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themes.d.ts","sourceRoot":"","sources":["../src/themes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAMD,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAevG;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAahG;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBzE"}

package/dist/themes.js

@@ -0,0 +1,64 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listThemes = exports.loadTheme = exports.loadThemeInfo = void 0;
+const path_1 = __importDefault(require("path"));
+const files_1 = require("./files");
+function userThemesFolder(config) {
+    return path_1.default.join(config.pagesFolder, 'themes');
+}
+async function loadThemeInfo(name, config) {
+    // Check user's local themes first, then fall back to package defaults
+    const localPath = path_1.default.join(userThemesFolder(config), `${name}.json`);
+    if (await (0, files_1.checkIfExists)(localPath)) {
+        const raw = await (0, files_1.loadFile)(localPath);
+        return raw ? JSON.parse(raw) : undefined;
+    }
+    const defaultPath = path_1.default.join(config.defaultThemesFolder, `${name}.json`);
+    if (await (0, files_1.checkIfExists)(defaultPath)) {
+        const raw = await (0, files_1.loadFile)(defaultPath);
+        return raw ? JSON.parse(raw) : undefined;
+    }
+    return undefined;
+}
+exports.loadThemeInfo = loadThemeInfo;
+async function loadTheme(name, config) {
+    // Check user's local themes first, then fall back to package defaults
+    const localPath = path_1.default.join(userThemesFolder(config), `${name}.css`);
+    if (await (0, files_1.checkIfExists)(localPath)) {
+        return await (0, files_1.loadFile)(localPath);
+    }
+    const defaultPath = path_1.default.join(config.defaultThemesFolder, `${name}.css`);
+    if (await (0, files_1.checkIfExists)(defaultPath)) {
+        return await (0, files_1.loadFile)(defaultPath);
+    }
+    return undefined;
+}
+exports.loadTheme = loadTheme;
+async function listThemes(config) {
+    const names = new Set();
+    // Collect from user's local themes folder
+    const localFolder = userThemesFolder(config);
+    if (await (0, files_1.checkIfExists)(localFolder)) {
+        const files = await (0, files_1.listFiles)(localFolder);
+        for (const f of files) {
+            if (f.endsWith('.css')) {
+                names.add(f.replace(/\.css$/, ''));
+            }
+        }
+    }
+    // Collect from package defaults
+    if (await (0, files_1.checkIfExists)(config.defaultThemesFolder)) {
+        const files = await (0, files_1.listFiles)(config.defaultThemesFolder);
+        for (const f of files) {
+            if (f.endsWith('.css')) {
+                names.add(f.replace(/\.css$/, ''));
+            }
+        }
+    }
+    return Array.from(names).sort();
+}
+exports.listThemes = listThemes;
+//# sourceMappingURL=themes.js.map

package/dist/themes.js.map

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

package/package.json

@@ -2,7 +2,7 @@
     "name": "synthos",
     "author": "Steven Ickman",
     "description": "An AI powered shell experience.",
-    "version": "0.6.0",
+    "version": "0.7.0",
     "license": "MIT",
     "keywords": [
         "synthos",
@@ -20,6 +20,7 @@
     "bin": "./bin/synthos.js",
     "dependencies": {
         "agentm-core": "0.7.2",
+        "cheerio": "^1.2.0",
         "express": "^4.19.2",
         "open": "^10.1.0",
         "openai": "^4.57.0",
@@ -28,6 +29,7 @@
     },
     "devDependencies": {
         "@types/assert": "^1.5.3",
+        "@types/cheerio": "^0.22.35",
         "@types/express": "^4.17.21",
         "@types/mocha": "^8.2.0",
         "@types/node": "^14.14.31",
@@ -43,8 +45,8 @@
         "build": "tsc -b",
         "clean": "rimraf dist tsconfig.tsbuildinfo node_modules",
         "start": "node ./bin/synthos.js",
-        "test": "npm-run-all build test:mocha",
-        "test:mocha": "nyc mocha tests"
+        "test": "npm run build && npm run test:mocha",
+        "test:mocha": "nyc ts-mocha tests/**/*.spec.ts"
     },
     "files": [
         "dist",

package/required-pages/builder.html

@@ -0,0 +1,74 @@
+<!DOCTYPE html><html lang="en"><head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>SynthOS</title>
+    <script id="theme-info" src="/api/theme-info.js" data-locked="true"></script>
+    <link id="theme-css" rel="stylesheet" href="/api/theme.css" data-locked="true">
+    <style>.idle-container{position:absolute;width:100%;height:100%;pointer-events:none;opacity:1;transition:opacity 1s ease-out}.idle-container.hidden{opacity:0}.breathing-orb{position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);width:80px;height:80px;border-radius:50%;background:radial-gradient(circle,rgba(102,126,234,.15) 0,transparent 70%);animation:4s ease-in-out infinite breathe}.breathing-orb::before{content:'';position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);width:8px;height:8px;border-radius:50%;background:rgba(183,148,246,.6);box-shadow:0 0 20px rgba(183,148,246,.4);animation:4s ease-in-out infinite core-pulse}@keyframes breathe{0%,100%{width:80px;height:80px;opacity:.3}50%{width:120px;height:120px;opacity:.6}}@keyframes core-pulse{0%,100%{opacity:.4;box-shadow:0 0 20px rgba(183,148,246,.3)}50%{opacity:.8;box-shadow:0 0 30px rgba(183,148,246,.5)}}.orbit-ring{position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);width:200px;height:200px;border:1px solid rgba(102,126,234,.1);border-radius:50%;animation:20s linear infinite orbit-rotate}.orbit-ring::after{content:'';position:absolute;top:-3px;left:50%;transform:translateX(-50%);width:6px;height:6px;background:rgba(240,147,251,.5);border-radius:50%;box-shadow:0 0 10px rgba(240,147,251,.3)}@keyframes orbit-rotate{from{transform:translate(-50%,-50%) rotate(0)}to{transform:translate(-50%,-50%) rotate(360deg)}}</style>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/d3/7.9.0/d3.min.js"></script>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/marked/14.1.1/marked.min.js"></script>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/mermaid/11.1.0/mermaid.min.js"></script>
+    <script id="page-info" src="/api/page-info.js?page=builder"></script>
+</head>
+<body>
+    <div class="chat-panel" data-locked="true">
+        <div class="chat-header" data-locked="true">SynthOS</div>
+        <div class="chat-messages" id="chatMessages" data-locked="true">
+            <div class="chat-message" id="defaultGreeting"><strong>SynthOS:</strong> What can I create for you? Ask "what can you do?" or "how does this work?" to learn more. Remember to save often!</div>
+            <div class="chat-message" id="firstRunGreeting" style="display:none;">
+                <p><strong>Welcome to SynthOS!</strong></p>
+                <p>You're all set up and ready to start creating. This is the <strong>Builder</strong> — your main workspace. Just type what you want to build into the chat and SynthOS will generate it for you as a live, interactive page.</p>
+                <p>You can create just about anything: dashboards, tools, games, visualizations, forms, calculators — if it can be expressed as a web page, you can build it here through conversation.</p>
+                <p><strong>How pages work:</strong></p>
+                <ul>
+                    <li>Each creation lives on its own <strong>page</strong>. When you save, it gets a name and becomes part of your collection.</li>
+                    <li>The <strong>Pages</strong> button (in the link bar above) takes you to the <strong>Pages Gallery</strong> where you can browse, open, and manage all your saved creations.</li>
+                </ul>
+                <p><strong>Key actions:</strong></p>
+                <ul>
+                    <li><strong>Save</strong> — saves your current page. You'll be prompted for a name the first time. <em>Save often!</em> Your work only persists when you save it.</li>
+                    <li><strong>Reset</strong> — clears the current page back to a blank slate. Useful when you want to start fresh on something new.</li>
+                </ul>
+                <p>When you're ready, we recommend trying the <a href="/solar_tutorial">Solar Tutorial</a> — it's a guided walkthrough that will show you the basics of creating with SynthOS step by step.</p>
+                <p>Have fun building!</p>
+            </div>
+        </div>
+        <div class="link-group" data-locked="true">
+            <a href="#" id="saveLink" data-locked="true">Save</a>
+            <a href="/pages" id="pagesLink" data-locked="true">Pages</a>
+            <a href="#" id="resetLink" data-locked="true">Reset</a>
+        </div>
+        <form action="/" method="POST" id="chatForm" data-locked="true">
+            <input type="text" class="chat-input" id="chatInput" name="message" placeholder="Type a message..." data-locked="true">
+            <button type="submit" class="chat-submit" data-locked="true">Send</button>
+        </form>
+    </div>
+    <div class="viewer-panel" id="viewerPanel">
+        <div class="idle-container" id="idleAnimation">
+            <div class="orbit-ring"></div>
+            <div class="breathing-orb"></div>
+        </div>
+        <div id="loadingOverlay" class="loading-overlay"><div class="spinner"></div></div>
+    </div>
+    <div id="instructions" style="display: none;" data-locked="true"></div>
+    <div id="thoughts" style="display: none;" data-locked="true"></div>
+    <script id="idle-animation">function hideIdleAnimation(){const idleContainer=document.getElementById("idleAnimation");idleContainer&&(idleContainer.classList.add("hidden"),setTimeout(()=>{idleContainer.style.display="none"},1e3))}function showIdleAnimation(){const idleContainer=document.getElementById("idleAnimation");idleContainer&&(idleContainer.style.display="block",setTimeout(()=>{idleContainer.classList.remove("hidden")},10))}</script>
+    <button class="chat-toggle" aria-label="Toggle chat panel">
+        <span class="chat-toggle-dots">
+            <span class="chat-toggle-dot"></span>
+            <span class="chat-toggle-dot"></span>
+            <span class="chat-toggle-dot"></span>
+        </span>
+    </button>
+<script id="first-run-check">
+(function() {
+    var params = new URLSearchParams(window.location.search);
+    if (params.get('firstRun') === 'true') {
+        document.getElementById('defaultGreeting').style.display = 'none';
+        document.getElementById('firstRunGreeting').style.display = '';
+    }
+})();
+</script>
+<script id="page-helpers" src="/api/page-helpers.js?v=2" data-locked="true"></script>
+<script id="page-script" src="/api/page-script.js?v=2" data-locked="true"></script>
+</body></html>

package/required-pages/builder.json

@@ -0,0 +1 @@
+{ "title": "Builder", "categories": ["System"], "pinned": true, "showInAll": true, "pageVersion": 2, "mode": "unlockedS" }