synthos 0.9.0 → 0.10.1

package/src/service/useDataRoutes.ts

@@ -1,6 +1,5 @@
 import { Application, Response } from 'express';
 import { SynthOSConfig } from "../init";
-import { checkIfExists, deleteFile, ensureFolderExists, listFiles, loadFile, saveFile } from "../files";
 import path from "path";
 import { v4 } from "uuid";
 import { clearCachedScripts } from '../scripts';
@@ -17,19 +16,20 @@ export function useDataRoutes(config: SynthOSConfig, app: Application): void {
 // ---------------------------------------------------------------------------
 
 async function handleList(config: SynthOSConfig, page: string, table: string, query: Record<string, any>, res: Response): Promise<void> {
+    const sp = config.storageProvider;
     const folder = tableFolder(config, page, table);
-    if (!(await checkIfExists(folder))) {
+    if (!(await sp.checkIfExists(folder))) {
         res.status(404).json({ error: 'table_not_found', page, table });
         return;
     }
 
-    const ids = (await listFiles(folder)).filter(f => f.endsWith('.json')).map(f => f.replace('.json', ''));
+    const ids = (await sp.listFiles(folder)).filter(f => f.endsWith('.json')).map(f => f.replace('.json', ''));
 
     const rows: Record<string, any>[] = [];
     for (const id of ids) {
         const file = recordFile(folder, id);
         try {
-            const row = JSON.parse(await loadFile(file));
+            const row = JSON.parse(await sp.loadFile(file));
             row.id = id;
             rows.push(row);
         } catch (err: unknown) {
@@ -49,15 +49,16 @@ async function handleList(config: SynthOSConfig, page: string, table: string, qu
 }
 
 async function handleGet(config: SynthOSConfig, page: string, table: string, id: string, res: Response): Promise<void> {
+    const sp = config.storageProvider;
     const folder = tableFolder(config, page, table);
-    if (!(await checkIfExists(folder))) {
+    if (!(await sp.checkIfExists(folder))) {
         res.status(404).json({ error: 'table_not_found', page, table });
         return;
     }
 
     const file = recordFile(folder, id);
     try {
-        const row = JSON.parse(await loadFile(file));
+        const row = JSON.parse(await sp.loadFile(file));
         row.id = id;
         res.json(row);
     } catch (err: unknown) {
@@ -66,13 +67,14 @@ async function handleGet(config: SynthOSConfig, page: string, table: string, id:
 }
 
 async function handleUpsert(config: SynthOSConfig, page: string, table: string, body: any, res: Response): Promise<void> {
+    const sp = config.storageProvider;
     const id = body.id ?? v4();
     const folder = tableFolder(config, page, table);
     const file = recordFile(folder, id);
     try {
         const row = { ...body, id };
-        await ensureFolderExists(folder);
-        await saveFile(file, JSON.stringify(row, null, 4));
+        await sp.ensureFolderExists(folder);
+        await sp.saveFile(file, JSON.stringify(row, null, 4));
         if (table === 'scripts') {
             clearCachedScripts();
         }
@@ -84,11 +86,12 @@ async function handleUpsert(config: SynthOSConfig, page: string, table: string,
 }
 
 async function handleDelete(config: SynthOSConfig, page: string, table: string, id: string, res: Response): Promise<void> {
+    const sp = config.storageProvider;
     const folder = tableFolder(config, page, table);
     const file = recordFile(folder, id);
     try {
-        if (await checkIfExists(file)) {
-            await deleteFile(file);
+        if (await sp.checkIfExists(file)) {
+            await sp.deleteFile(file);
             if (table === 'scripts') {
                 clearCachedScripts();
             }

package/src/service/useFileRoutes.ts

@@ -1,25 +1,25 @@
 import { Application } from 'express';
 import express from 'express';
-import fs from 'fs/promises';
 import path from 'path';
 import { SynthOSConfig } from '../init';
-import { checkIfExists, ensureFolderExists } from '../files';
 
 export function useFileRoutes(config: SynthOSConfig, app: Application): void {
+    const sp = config.storageProvider;
+
     // List files in a page's files/ folder
     app.get('/api/files/:page', async (req, res) => {
         try {
             const folder = filesFolder(config, req.params.page);
-            if (!(await checkIfExists(folder))) {
+            if (!(await sp.checkIfExists(folder))) {
                 res.json({ files: [] });
                 return;
             }
 
-            const entries = await fs.readdir(folder);
+            const entries = await sp.listFiles(folder);
             const files: { name: string; size: number }[] = [];
             for (const entry of entries) {
-                const stat = await fs.stat(path.join(folder, entry));
-                if (stat.isFile()) {
+                const stat = await sp.stat(path.join(folder, entry));
+                if (stat.isFile) {
                     files.push({ name: entry, size: stat.size });
                 }
             }
@@ -39,12 +39,13 @@ export function useFileRoutes(config: SynthOSConfig, app: Application): void {
                 return;
             }
 
-            if (!(await checkIfExists(filePath))) {
+            if (!(await sp.checkIfExists(filePath))) {
                 res.status(404).json({ error: 'File not found' });
                 return;
             }
 
-            res.sendFile(filePath);
+            res.type(path.extname(req.params.filename));
+            sp.createReadStream(filePath).pipe(res);
         } catch (err: unknown) {
             console.error(err);
             res.status(500).json({ error: (err as Error).message });
@@ -67,10 +68,10 @@ export function useFileRoutes(config: SynthOSConfig, app: Application): void {
             }
 
             const folder = filesFolder(config, req.params.page);
-            await ensureFolderExists(folder);
-            await fs.writeFile(filePath, req.body as Buffer);
+            await sp.ensureFolderExists(folder);
+            await sp.saveBuffer(filePath, req.body as Buffer);
 
-            const stat = await fs.stat(filePath);
+            const stat = await sp.stat(filePath);
             res.status(201).json({ name: filename, size: stat.size });
         } catch (err: unknown) {
             console.error(err);
@@ -87,12 +88,12 @@ export function useFileRoutes(config: SynthOSConfig, app: Application): void {
                 return;
             }
 
-            if (!(await checkIfExists(filePath))) {
+            if (!(await sp.checkIfExists(filePath))) {
                 res.status(404).json({ error: 'File not found' });
                 return;
             }
 
-            await fs.unlink(filePath);
+            await sp.deleteFile(filePath);
             res.json({ deleted: true });
         } catch (err: unknown) {
             console.error(err);

package/src/service/usePageRoutes.ts

@@ -13,7 +13,7 @@ import { getConnectorRegistry, ConnectorsConfig, ConnectorOAuthConfig } from "..
 import { AgentConfig } from "../agents";
 import { listScripts } from "../scripts";
 import path from 'path';
-import { checkIfExists, copyFolderRecursive, deleteFile as deleteFileFromDisk, findFileInFolders, loadFile } from "../files";
+import { checkIfExists, findFileInFolders, loadFile } from "../files";
 import * as cheerio from 'cheerio';
 
 /**
@@ -455,7 +455,7 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
     app.get('/:page', async (req, res) => {
         // Redirect if settings not configured
         const { page } = req.params;
-        const isConfigured = await hasConfiguredSettings(config.pagesFolder);
+        const isConfigured = await hasConfiguredSettings(config);
         if (!isConfigured && page !== 'settings') {
             res.redirect('/settings?firstRun=1');
             return;
@@ -470,7 +470,7 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
         }
 
         // Load page metadata for version-based script injection
-        const metadata = await loadPageMetadata(config.pagesFolder, page, config.requiredPagesFolders);
+        const metadata = await loadPageMetadata(config, page, config.requiredPagesFolders);
         const pageVersion = metadata?.pageVersion ?? 0;
 
         // Block outdated pages (redirect to tabs list so user sees upgrade UI)
@@ -480,7 +480,7 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
         }
 
         // Load settings to determine theme version for FluentLM base injection
-        const settings = await loadSettings(config.pagesFolder);
+        const settings = await loadSettings(config);
         const themeName = settings.theme ?? 'nebula-dusk';
         const themeVersion = await loadThemeVersion(themeName, config);
 
@@ -493,7 +493,7 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
 
         // Inject version meta tag so undo/try-again links appear on page load
         {
-            const latestVersion = await getLatestVersion(config.pagesFolder, page);
+            const latestVersion = await getLatestVersion(config, page);
             if (latestVersion > 0) {
                 html = html.replace('</head>', `<meta name="synthos-version" content="${latestVersion}">\n</head>`);
             }
@@ -504,7 +504,7 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
         // Replace branding for white-label forks
         const productName = customizer?.productName ?? 'SynthOS';
         if (productName !== 'SynthOS') {
-            html = html.replace(/SynthOS/g, productName);
+            html = html.replace(/synthos/gi, productName);
         }
 
         res.send(html);
@@ -515,7 +515,7 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
         try {
             // Redirect if settings not configured
             const { page } = req.params;
-            const isConfigured = await hasConfiguredSettings(config.pagesFolder);
+            const isConfigured = await hasConfiguredSettings(config);
             if (!isConfigured) {
                 res.status(400).json({ error: 'Settings not configured' });
                 return;
@@ -571,7 +571,7 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
             }
 
             // Inject save-line marker at the end of chat messages (skip for locked pages)
-            const sourceMetadata = await loadPageMetadata(config.pagesFolder, page, config.requiredPagesFolders);
+            const sourceMetadata = await loadPageMetadata(config, page, config.requiredPagesFolders);
             if (sourceMetadata?.mode !== 'locked') {
                 const $ = cheerio.load(pageState);
                 // Remove any existing save-line first
@@ -584,14 +584,14 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
             }
 
             // Save as new page
-            await savePageState(config.pagesFolder, saveAs, pageState, title, categories);
+            await savePageState(config, saveAs, pageState, title, categories);
 
             // Copy files (sound effects, etc.) from source page when saving as a different name
             if (page !== saveAs) {
                 // Check source page's files/ dir in user pages, then fallback folders
                 let sourceFilesDir: string | undefined;
                 const userFilesDir = path.join(config.pagesFolder, 'pages', page, 'files');
-                if (await checkIfExists(userFilesDir)) {
+                if (await config.storageProvider.checkIfExists(userFilesDir)) {
                     sourceFilesDir = userFilesDir;
                 } else {
                     for (const folder of config.requiredPagesFolders) {
@@ -604,15 +604,15 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
                 }
                 if (sourceFilesDir) {
                     const targetFilesDir = path.join(config.pagesFolder, 'pages', saveAs, 'files');
-                    await copyFolderRecursive(sourceFilesDir, targetFilesDir);
+                    await config.storageProvider.copyFolderRecursive(sourceFilesDir, targetFilesDir);
                 }
             }
 
             // Clear version files after saving (fresh baseline)
-            await clearVersions(config.pagesFolder, saveAs);
+            await clearVersions(config, saveAs);
 
             // Also update metadata with categories (in case page.json already existed)
-            await savePageMetadata(config.pagesFolder, saveAs, {
+            await savePageMetadata(config, saveAs, {
                 title,
                 categories,
                 pinned: false,
@@ -634,25 +634,25 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
     app.post('/:page/undo', async (req, res) => {
         try {
             const { page } = req.params;
-            const pagesFolder = config.pagesFolder;
-            const cv = await getLatestVersion(pagesFolder, page);
+            const sp = config.storageProvider;
+            const cv = await getLatestVersion(config, page);
             if (cv <= 0) {
                 res.status(400).send('Nothing to undo');
                 return;
             }
 
             // Delete the current version file
-            const pageFolder = path.join(pagesFolder, 'pages', page);
+            const pageFolder = path.join(config.pagesFolder, 'pages', page);
             const versionFile = path.join(pageFolder, `page.v${cv}.html`);
-            if (await checkIfExists(versionFile)) {
-                await deleteFileFromDisk(versionFile);
+            if (await sp.checkIfExists(versionFile)) {
+                await sp.deleteFile(versionFile);
             }
 
             // Load previous version (v{cv-1}.html, or page.html if rolling back to v0)
             const prevVersion = cv - 1;
             let previousHtml: string | undefined;
             if (prevVersion > 0) {
-                previousHtml = await loadPageVersion(pagesFolder, page, prevVersion);
+                previousHtml = await loadPageVersion(config, page, prevVersion);
             } else {
                 // v0 = the saved page.html baseline (user folder → required folders fallback)
                 previousHtml = await loadPageWithFallback(page, config, true);
@@ -664,8 +664,8 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
             }
 
             // Inject shell assets (same as GET handler)
-            const settings = await loadSettings(config.pagesFolder);
-            const metadata = await loadPageMetadata(pagesFolder, page, config.requiredPagesFolders);
+            const settings = await loadSettings(config);
+            const metadata = await loadPageMetadata(config, page, config.requiredPagesFolders);
             const pv = metadata?.pageVersion ?? 0;
             const themeName = settings.theme ?? 'nebula-dusk';
             const themeVersion = await loadThemeVersion(themeName, config);
@@ -688,7 +688,7 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
             // Replace branding for white-label forks
             const productName = customizer?.productName ?? 'SynthOS';
             if (productName !== 'SynthOS') {
-                out = out.replace(/SynthOS/g, productName);
+                out = out.replace(/synthos/gi, productName);
             }
 
             res.send(out);
@@ -703,7 +703,7 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
         try {
             // Ensure settings configured
             const { page } = req.params;
-            const isConfigured = await hasConfiguredSettings(config.pagesFolder);
+            const isConfigured = await hasConfiguredSettings(config);
             if (!isConfigured) {
                 res.status(400).send('Settings not configured');
                 return;
@@ -717,7 +717,7 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
             }
 
             // Reject modifications to locked pages
-            const lockMetadata = await loadPageMetadata(config.pagesFolder, page, config.requiredPagesFolders);
+            const lockMetadata = await loadPageMetadata(config, page, config.requiredPagesFolders);
             if (lockMetadata?.mode === 'locked') {
                 res.status(403).send('This page is locked and cannot be modified');
                 return;
@@ -743,7 +743,7 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
             }
 
             // Create model instance
-            const innerCompletePrompt = await createCompletePrompt(config.pagesFolder, 'builder', req.body.model);
+            const innerCompletePrompt = await createCompletePrompt(config, 'builder', req.body.model);
             const debugVerbose = config.debugPageUpdates;
             let inputChars = 0;
             let outputChars = 0;
@@ -775,7 +775,7 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
 
             // Load settings and build context
             const pagesFolder = config.pagesFolder;
-            const settings = await loadSettings(config.pagesFolder);
+            const settings = await loadSettings(config);
             const entry = getModelEntry(settings, 'builder');
             const { instructions } = entry;
             const productName = customizer?.productName ?? 'SynthOS';
@@ -837,8 +837,8 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
             // Detect first edit (v0→v1) for saved pages
             const isRequiredPage = config.requiredPages.includes(page);
             const pageFolder = path.join(pagesFolder, 'pages', page);
-            const pageFileExists = await checkIfExists(path.join(pageFolder, 'page.html'));
-            let currentVersion = await getLatestVersion(pagesFolder, page);
+            const pageFileExists = await config.storageProvider.checkIfExists(path.join(pageFolder, 'page.html'));
+            let currentVersion = await getLatestVersion(config, page);
             const isFirstEdit = !isRequiredPage && pageFileExists && currentVersion === 0;
 
             // Try again — roll back to previous version before re-running the transform
@@ -847,13 +847,13 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
             if (tryAgain && currentVersion > 0) {
                 // Delete current version file
                 const versionFile = path.join(pageFolder, `page.v${currentVersion}.html`);
-                if (await checkIfExists(versionFile)) {
-                    await deleteFileFromDisk(versionFile);
+                if (await config.storageProvider.checkIfExists(versionFile)) {
+                    await config.storageProvider.deleteFile(versionFile);
                 }
                 // Load previous version
                 const prevVersion = currentVersion - 1;
                 if (prevVersion > 0) {
-                    transformInput = await loadPageVersion(pagesFolder, page, prevVersion) ?? pageState;
+                    transformInput = await loadPageVersion(config, page, prevVersion) ?? pageState;
                 } else {
                     transformInput = await loadPageWithFallback(page, config, true) ?? pageState;
                 }
@@ -931,13 +931,13 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
 
                 // Save version snapshot (working state for all pages, undo support for saved pages)
                 const nextVersion = currentVersion + 1;
-                await savePageVersion(pagesFolder, page, nextVersion, html);
+                await savePageVersion(config, page, nextVersion, html);
 
                 // Update lastModified timestamp in page metadata
-                const metadata = await loadPageMetadata(pagesFolder, page, config.requiredPagesFolders);
+                const metadata = await loadPageMetadata(config, page, config.requiredPagesFolders);
                 if (metadata) {
                     metadata.lastModified = new Date().toISOString();
-                    await savePageMetadata(pagesFolder, page, metadata);
+                    await savePageMetadata(config, page, metadata);
                 }
 
                 // Inject required imports and page scripts (same as GET)
@@ -964,7 +964,7 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
 
                 // Replace branding for white-label forks
                 if (productName !== 'SynthOS') {
-                    out = out.replace(/SynthOS/g, productName);
+                    out = out.replace(/synthos/gi, productName);
                 }
 
                 res.send(out);
@@ -985,17 +985,19 @@ export function usePageRoutes(config: SynthOSConfig, app: Application, customize
 export async function loadPageWithFallback(page: string, config: SynthOSConfig, reset: boolean): Promise<string|undefined> {
     if (reset) {
         // Clear working-state versions so we get the fresh template
-        await clearVersions(config.pagesFolder, page);
+        await clearVersions(config, page);
     }
 
     // Try primary pages folder first
-    const pageState = await loadPageState(config.pagesFolder, page);
+    const pageState = await loadPageState(config, page);
     if (pageState) return pageState;
 
-    // Try fallback pages folders
+    // Try fallback pages folders (package content, always local fs)
     for (const folder of config.requiredPagesFolders) {
-        const state = await loadPageState(folder, page);
-        if (state) return state;
+        const candidate = path.join(folder, page, 'page.html');
+        if (await checkIfExists(candidate)) {
+            return await loadFile(candidate);
+        }
     }
     return undefined;
 }

package/src/service/useSharedDataRoutes.ts

@@ -1,6 +1,5 @@
 import { Application, Response } from 'express';
 import { SynthOSConfig } from "../init";
-import { checkIfExists, deleteFile, ensureFolderExists, listFiles, loadFile, saveFile } from "../files";
 import path from "path";
 import { v4 } from "uuid";
 
@@ -16,19 +15,20 @@ export function useSharedDataRoutes(config: SynthOSConfig, app: Application): vo
 // ---------------------------------------------------------------------------
 
 async function handleList(config: SynthOSConfig, table: string, query: Record<string, any>, res: Response): Promise<void> {
+    const sp = config.storageProvider;
     const folder = sharedTableFolder(config, table);
-    if (!(await checkIfExists(folder))) {
+    if (!(await sp.checkIfExists(folder))) {
         res.status(404).json({ error: 'table_not_found', table });
         return;
     }
 
-    const ids = (await listFiles(folder)).filter(f => f.endsWith('.json')).map(f => f.replace('.json', ''));
+    const ids = (await sp.listFiles(folder)).filter(f => f.endsWith('.json')).map(f => f.replace('.json', ''));
 
     const rows: Record<string, any>[] = [];
     for (const id of ids) {
         const file = recordFile(folder, id);
         try {
-            const row = JSON.parse(await loadFile(file));
+            const row = JSON.parse(await sp.loadFile(file));
             row.id = id;
             rows.push(row);
         } catch (err: unknown) {
@@ -48,15 +48,16 @@ async function handleList(config: SynthOSConfig, table: string, query: Record<st
 }
 
 async function handleGet(config: SynthOSConfig, table: string, id: string, res: Response): Promise<void> {
+    const sp = config.storageProvider;
     const folder = sharedTableFolder(config, table);
-    if (!(await checkIfExists(folder))) {
+    if (!(await sp.checkIfExists(folder))) {
         res.status(404).json({ error: 'table_not_found', table });
         return;
     }
 
     const file = recordFile(folder, id);
     try {
-        const row = JSON.parse(await loadFile(file));
+        const row = JSON.parse(await sp.loadFile(file));
         row.id = id;
         res.json(row);
     } catch (err: unknown) {
@@ -65,13 +66,14 @@ async function handleGet(config: SynthOSConfig, table: string, id: string, res:
 }
 
 async function handleUpsert(config: SynthOSConfig, table: string, body: any, res: Response): Promise<void> {
+    const sp = config.storageProvider;
     const id = body.id ?? v4();
     const folder = sharedTableFolder(config, table);
     const file = recordFile(folder, id);
     try {
         const row = { ...body, id };
-        await ensureFolderExists(folder);
-        await saveFile(file, JSON.stringify(row, null, 4));
+        await sp.ensureFolderExists(folder);
+        await sp.saveFile(file, JSON.stringify(row, null, 4));
         res.json(row);
     } catch (err: unknown) {
         console.error(err);
@@ -80,11 +82,12 @@ async function handleUpsert(config: SynthOSConfig, table: string, body: any, res
 }
 
 async function handleDelete(config: SynthOSConfig, table: string, id: string, res: Response): Promise<void> {
+    const sp = config.storageProvider;
     const folder = sharedTableFolder(config, table);
     const file = recordFile(folder, id);
     try {
-        if (await checkIfExists(file)) {
-            await deleteFile(file);
+        if (await sp.checkIfExists(file)) {
+            await sp.deleteFile(file);
         }
         res.json({ success: true });
     } catch (err: unknown) {

package/src/service/useSharedFileRoutes.ts

@@ -1,25 +1,25 @@
 import { Application } from 'express';
 import express from 'express';
-import fs from 'fs/promises';
 import path from 'path';
 import { SynthOSConfig } from '../init';
-import { checkIfExists, ensureFolderExists } from '../files';
 
 export function useSharedFileRoutes(config: SynthOSConfig, app: Application): void {
+    const sp = config.storageProvider;
+
     // List files in the shared files folder
     app.get('/api/shared/files', async (req, res) => {
         try {
             const folder = sharedFilesFolder(config);
-            if (!(await checkIfExists(folder))) {
+            if (!(await sp.checkIfExists(folder))) {
                 res.json({ files: [] });
                 return;
             }
 
-            const entries = await fs.readdir(folder);
+            const entries = await sp.listFiles(folder);
             const files: { name: string; size: number }[] = [];
             for (const entry of entries) {
-                const stat = await fs.stat(path.join(folder, entry));
-                if (stat.isFile()) {
+                const stat = await sp.stat(path.join(folder, entry));
+                if (stat.isFile) {
                     files.push({ name: entry, size: stat.size });
                 }
             }
@@ -39,12 +39,13 @@ export function useSharedFileRoutes(config: SynthOSConfig, app: Application): vo
                 return;
             }
 
-            if (!(await checkIfExists(filePath))) {
+            if (!(await sp.checkIfExists(filePath))) {
                 res.status(404).json({ error: 'File not found' });
                 return;
             }
 
-            res.sendFile(filePath);
+            res.type(path.extname(req.params.filename));
+            sp.createReadStream(filePath).pipe(res);
         } catch (err: unknown) {
             console.error(err);
             res.status(500).json({ error: (err as Error).message });
@@ -67,10 +68,10 @@ export function useSharedFileRoutes(config: SynthOSConfig, app: Application): vo
             }
 
             const folder = sharedFilesFolder(config);
-            await ensureFolderExists(folder);
-            await fs.writeFile(filePath, req.body as Buffer);
+            await sp.ensureFolderExists(folder);
+            await sp.saveBuffer(filePath, req.body as Buffer);
 
-            const stat = await fs.stat(filePath);
+            const stat = await sp.stat(filePath);
             res.status(201).json({ name: filename, size: stat.size });
         } catch (err: unknown) {
             console.error(err);
@@ -87,12 +88,12 @@ export function useSharedFileRoutes(config: SynthOSConfig, app: Application): vo
                 return;
             }
 
-            if (!(await checkIfExists(filePath))) {
+            if (!(await sp.checkIfExists(filePath))) {
                 res.status(404).json({ error: 'File not found' });
                 return;
             }
 
-            await fs.unlink(filePath);
+            await sp.deleteFile(filePath);
             res.json({ deleted: true });
         } catch (err: unknown) {
             console.error(err);

package/src/settings.ts

@@ -1,7 +1,7 @@
-import {checkIfExists, loadFile, saveFile} from './files';
 import path from 'path';
 import { ModelEntry, ProviderName, detectProvider } from './models';
 import { AgentConfig } from './agents';
+import { SynthOSConfig } from './init';
 
 let _settings: Partial<SettingsV2>|undefined;
 
@@ -126,8 +126,8 @@ function migrateV1toV2(raw: Record<string, unknown>): SettingsV2 {
     };
 }
 
-export async function hasConfiguredSettings(folder: string): Promise<boolean> {
-    const settings = await loadSettings(folder);
+export async function hasConfiguredSettings(config: SynthOSConfig): Promise<boolean> {
+    const settings = await loadSettings(config);
     const builder = getModelEntry(settings, 'builder');
     if (typeof builder.configuration.apiKey !== 'string' || builder.configuration.apiKey.length == 0) {
         return false;
@@ -138,18 +138,19 @@ export async function hasConfiguredSettings(folder: string): Promise<boolean> {
     return true;
 }
 
-export async function loadSettings(folder: string): Promise<SettingsV2> {
+export async function loadSettings(config: SynthOSConfig): Promise<SettingsV2> {
+    const sp = config.storageProvider;
     if (_settings == undefined) {
-        const filename = path.join(folder, 'settings.json');
-        if (await checkIfExists(filename)) {
+        const filename = path.join(config.pagesFolder, 'settings.json');
+        if (await sp.checkIfExists(filename)) {
             try {
-                const raw = JSON.parse(await loadFile(filename));
+                const raw = JSON.parse(await sp.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));
+                    await sp.saveFile(filename, JSON.stringify(migrated, null, 4));
                 } else {
                     _settings = raw as Partial<SettingsV2>;
                 }
@@ -171,11 +172,12 @@ export async function loadSettings(folder: string): Promise<SettingsV2> {
     return merged;
 }
 
-export async function saveSettings(folder: string, settings: Partial<SettingsV2>): Promise<void> {
+export async function saveSettings(config: SynthOSConfig, settings: Partial<SettingsV2>): Promise<void> {
+    const sp = config.storageProvider;
     _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));
+    await sp.saveFile(path.join(config.pagesFolder, 'settings.json'), JSON.stringify(_settings, null, 4));
 }