synthos 0.10.0 → 0.11.0

package/dist/service/mediaCache.js

@@ -0,0 +1,182 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMediaCache = void 0;
+const crypto_1 = require("crypto");
+const path_1 = __importDefault(require("path"));
+function hashKey(key) {
+    return (0, crypto_1.createHash)('sha256').update(key).digest('hex');
+}
+const MAX_ENTRIES = 500;
+const CATEGORIES = ['images', 'audio'];
+function createMediaCache(options) {
+    const { storage, cacheRoot } = options;
+    function categoryDir(category) {
+        return path_1.default.join(cacheRoot, category);
+    }
+    async function ensureCategory(category) {
+        await storage.ensureFolderExists(categoryDir(category));
+    }
+    async function get(category, key) {
+        const hash = hashKey(key);
+        const dir = categoryDir(category);
+        const metaPath = path_1.default.join(dir, `${hash}.meta.json`);
+        if (!(await storage.checkIfExists(metaPath))) {
+            return { hit: false };
+        }
+        const meta = JSON.parse(await storage.loadFile(metaPath));
+        const dataPath = path_1.default.join(dir, `${hash}${meta.extension}`);
+        try {
+            const buffer = await storage.loadBuffer(dataPath);
+            // Update last access time for eviction tracking
+            meta.lastAccessedAt = new Date().toISOString();
+            await storage.saveFile(metaPath, JSON.stringify(meta, null, 2));
+            return { hit: true, buffer, contentType: meta.contentType };
+        }
+        catch {
+            return { hit: false };
+        }
+    }
+    async function put(category, key, data, contentType, meta) {
+        await ensureCategory(category);
+        const hash = hashKey(key);
+        const dir = categoryDir(category);
+        const extension = extensionForContentType(contentType);
+        const dataPath = path_1.default.join(dir, `${hash}${extension}`);
+        const metaPath = path_1.default.join(dir, `${hash}.meta.json`);
+        const now = new Date().toISOString();
+        await storage.saveBuffer(dataPath, data);
+        await storage.saveFile(metaPath, JSON.stringify({
+            ...meta,
+            contentType,
+            extension,
+            createdAt: now,
+            lastAccessedAt: now,
+        }, null, 2));
+        // Run eviction after writing the new entry
+        await evict();
+    }
+    async function evict() {
+        // Collect all entries across categories
+        const entries = [];
+        for (const category of CATEGORIES) {
+            const dir = categoryDir(category);
+            if (!(await storage.checkIfExists(dir)))
+                continue;
+            const files = await storage.listFiles(dir);
+            for (const file of files) {
+                if (!file.endsWith('.meta.json'))
+                    continue;
+                const metaPath = path_1.default.join(dir, file);
+                try {
+                    const meta = JSON.parse(await storage.loadFile(metaPath));
+                    const hash = file.replace('.meta.json', '');
+                    const dataPath = path_1.default.join(dir, `${hash}${meta.extension}`);
+                    let size = 0;
+                    try {
+                        const info = await storage.stat(dataPath);
+                        size = info.size;
+                    }
+                    catch { /* data file missing, size stays 0 */ }
+                    entries.push({
+                        category,
+                        hash,
+                        lastAccessedAt: meta.lastAccessedAt || meta.createdAt || '1970-01-01T00:00:00.000Z',
+                        size,
+                        metaPath,
+                        extension: meta.extension,
+                    });
+                }
+                catch { /* skip unreadable meta */ }
+            }
+        }
+        if (entries.length <= MAX_ENTRIES)
+            return;
+        // Sort by lastAccessedAt descending — most recent first
+        entries.sort((a, b) => b.lastAccessedAt.localeCompare(a.lastAccessedAt));
+        // Evict everything beyond the first 500
+        const toEvict = entries.slice(MAX_ENTRIES);
+        for (const entry of toEvict) {
+            const dir = categoryDir(entry.category);
+            const dataPath = path_1.default.join(dir, `${entry.hash}${entry.extension}`);
+            try {
+                await storage.deleteFile(dataPath);
+            }
+            catch { /* ignore */ }
+            try {
+                await storage.deleteFile(entry.metaPath);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    async function invalidate(category, key) {
+        const hash = hashKey(key);
+        const dir = categoryDir(category);
+        const metaPath = path_1.default.join(dir, `${hash}.meta.json`);
+        if (await storage.checkIfExists(metaPath)) {
+            const meta = JSON.parse(await storage.loadFile(metaPath));
+            const dataPath = path_1.default.join(dir, `${hash}${meta.extension}`);
+            try {
+                await storage.deleteFile(dataPath);
+            }
+            catch { /* ignore */ }
+            try {
+                await storage.deleteFile(metaPath);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    async function clearCategory(category) {
+        const dir = categoryDir(category);
+        if (await storage.checkIfExists(dir)) {
+            await storage.deleteFolder(dir);
+        }
+    }
+    async function clearAll() {
+        await clearCategory('images');
+        await clearCategory('audio');
+    }
+    async function stats() {
+        const result = {
+            images: { count: 0, totalBytes: 0 },
+            audio: { count: 0, totalBytes: 0 },
+        };
+        for (const category of CATEGORIES) {
+            const dir = categoryDir(category);
+            if (!(await storage.checkIfExists(dir)))
+                continue;
+            const files = await storage.listFiles(dir);
+            for (const file of files) {
+                if (file.endsWith('.meta.json'))
+                    continue;
+                try {
+                    const info = await storage.stat(path_1.default.join(dir, file));
+                    result[category].count++;
+                    result[category].totalBytes += info.size;
+                }
+                catch { /* skip missing */ }
+            }
+        }
+        return result;
+    }
+    return { get, put, invalidate, clearCategory, clearAll, stats, evict };
+}
+exports.createMediaCache = createMediaCache;
+function extensionForContentType(contentType) {
+    if (contentType.includes('png'))
+        return '.png';
+    if (contentType.includes('jpeg') || contentType.includes('jpg'))
+        return '.jpg';
+    if (contentType.includes('webp'))
+        return '.webp';
+    if (contentType.includes('mpeg') || contentType.includes('mp3'))
+        return '.mp3';
+    if (contentType.includes('wav'))
+        return '.wav';
+    if (contentType.includes('ogg'))
+        return '.ogg';
+    return '.bin';
+}
+//# sourceMappingURL=mediaCache.js.map

package/dist/service/mediaCache.js.map

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

package/dist/service/pageValidator.d.ts

@@ -0,0 +1,25 @@
+/**
+ * pageValidator.ts — Lightweight page validation for LLM-generated HTML.
+ *
+ * Catches common errors (syntax, missing DOM elements, bad synthos.* calls)
+ * before serving pages. No browser binary — static analysis only.
+ *
+ * Layers:
+ *   1. Script extraction + Acorn parse → syntax errors
+ *   2. DOM element ID inventory → missing element references
+ *   3. SynthOS API pattern checks → hallucinated method calls
+ */
+export interface PageValidationError {
+    type: 'syntax-error' | 'missing-element' | 'unknown-api';
+    message: string;
+    source?: string;
+    line?: number;
+    col?: number;
+}
+export interface PageValidationResult {
+    valid: boolean;
+    errors: PageValidationError[];
+    durationMs: number;
+}
+export declare function validatePage(html: string): PageValidationResult;
+//# sourceMappingURL=pageValidator.d.ts.map

package/dist/service/pageValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageValidator.d.ts","sourceRoot":"","sources":["../../src/service/pageValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,cAAc,GAAG,iBAAiB,GAAG,aAAa,CAAC;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACtB;AAsRD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CA2B/D"}

package/dist/service/pageValidator.js

@@ -0,0 +1,315 @@
+"use strict";
+/**
+ * pageValidator.ts — Lightweight page validation for LLM-generated HTML.
+ *
+ * Catches common errors (syntax, missing DOM elements, bad synthos.* calls)
+ * before serving pages. No browser binary — static analysis only.
+ *
+ * Layers:
+ *   1. Script extraction + Acorn parse → syntax errors
+ *   2. DOM element ID inventory → missing element references
+ *   3. SynthOS API pattern checks → hallucinated method calls
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validatePage = void 0;
+const acorn = __importStar(require("acorn"));
+const cheerio = __importStar(require("cheerio"));
+// ---------------------------------------------------------------------------
+// Known injected script IDs — skip these during validation
+// ---------------------------------------------------------------------------
+const INJECTED_SCRIPT_IDS = new Set([
+    'page-bridge',
+    'page-helpers',
+    'page-info',
+    'page-script',
+    'synthos-error-capture',
+    // V3 module scripts
+    'shell-v3',
+    'server-v3',
+    'storage-v3',
+    'script-v3',
+    'connector-v3',
+    'agent-v3',
+]);
+// ---------------------------------------------------------------------------
+// Known SynthOS API surface (from helpers.v3.js)
+// ---------------------------------------------------------------------------
+const KNOWN_SYNTHOS_METHODS = new Set([
+    // data
+    'synthos.data',
+    'synthos.data.list',
+    'synthos.data.get',
+    'synthos.data.save',
+    'synthos.data.remove',
+    // files
+    'synthos.files',
+    'synthos.files.list',
+    'synthos.files.upload',
+    'synthos.files.url',
+    'synthos.files.remove',
+    // shared.data
+    'synthos.shared',
+    'synthos.shared.data',
+    'synthos.shared.data.list',
+    'synthos.shared.data.get',
+    'synthos.shared.data.save',
+    'synthos.shared.data.remove',
+    // shared.files
+    'synthos.shared.files',
+    'synthos.shared.files.list',
+    'synthos.shared.files.upload',
+    'synthos.shared.files.url',
+    'synthos.shared.files.remove',
+    // generate
+    'synthos.generate',
+    'synthos.generate.image',
+    'synthos.generate.completion',
+    // script
+    'synthos.script',
+    'synthos.script.run',
+    // page
+    'synthos.page',
+    'synthos.page.list',
+    'synthos.page.get',
+    'synthos.page.update',
+    'synthos.page.remove',
+    'synthos.page.ask',
+    // search
+    'synthos.search',
+    'synthos.search.web',
+    // connector
+    'synthos.connector',
+    'synthos.connector.call',
+    'synthos.connector.list',
+    // agent
+    'synthos.agent',
+    'synthos.agent.list',
+    'synthos.agent.send',
+    'synthos.agent.sendStream',
+    'synthos.agent.chat',
+    'synthos.agent.chat.send',
+    'synthos.agent.chat.sendStream',
+    'synthos.agent.chat.history',
+    'synthos.agent.chat.abort',
+    'synthos.agent.chat.clear',
+    'synthos.agent.isEnabled',
+    'synthos.agent.getCapabilities',
+    // shell
+    'synthos.shell',
+    'synthos.shell.navigate',
+    'synthos.shell.submitChat',
+    'synthos.shell.setDirty',
+    'synthos.shell.showLoading',
+    'synthos.shell.hideLoading',
+    'synthos.shell.focusChat',
+    'synthos.shell.openSaveModal',
+    'synthos.shell.toggleBuilder',
+    'synthos.shell.openBuilder',
+    'synthos.shell.closeBuilder',
+    'synthos.shell.on',
+]);
+// ---------------------------------------------------------------------------
+// Layer 1: Script Extraction + Acorn Parse
+// ---------------------------------------------------------------------------
+function estimateLineOffset(html, scriptHtml) {
+    const idx = html.indexOf(scriptHtml);
+    if (idx === -1)
+        return 0;
+    let line = 1;
+    for (let i = 0; i < idx; i++) {
+        if (html[i] === '\n')
+            line++;
+    }
+    return line;
+}
+function extractScripts(html) {
+    const $ = cheerio.load(html);
+    const scripts = [];
+    let index = 0;
+    $('script').each((_, el) => {
+        const $el = $(el);
+        // Skip external scripts (have src attribute)
+        if ($el.attr('src'))
+            return;
+        // Skip known injected scripts
+        const id = $el.attr('id');
+        if (id && INJECTED_SCRIPT_IDS.has(id))
+            return;
+        const source = $el.text();
+        if (!source.trim())
+            return;
+        scripts.push({
+            index: index++,
+            source,
+            startLine: estimateLineOffset(html, $.html(el)),
+            isModule: $el.attr('type') === 'module',
+        });
+    });
+    return scripts;
+}
+function parseSyntax(script) {
+    try {
+        acorn.parse(script.source, {
+            ecmaVersion: 'latest',
+            sourceType: script.isModule ? 'module' : 'script',
+            allowAwaitOutsideFunction: true,
+        });
+        return null;
+    }
+    catch (err) {
+        const e = err;
+        return {
+            type: 'syntax-error',
+            message: e.message ?? 'Unknown syntax error',
+            source: `inline-script-${script.index}`,
+            line: e.loc ? script.startLine + e.loc.line : undefined,
+            col: e.loc?.column,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Layer 2: DOM Element ID Inventory
+// ---------------------------------------------------------------------------
+function buildIdInventory(html) {
+    const $ = cheerio.load(html);
+    const ids = new Set();
+    $('[id]').each((_, el) => {
+        const id = $(el).attr('id');
+        if (id)
+            ids.add(id);
+    });
+    return ids;
+}
+/**
+ * Patterns that CREATE element IDs inside script source text. Scripts that
+ * build DOM via `innerHTML = \`...<input id="btnSaveAll">...\`` or assign
+ * `el.id = 'foo'` produce IDs at runtime that `buildIdInventory` misses.
+ * Seeding those IDs as "known" prevents false-positive missing-element
+ * errors for dynamically constructed UI.
+ */
+const ID_CREATE_PATTERNS = [
+    // id="foo" / id='foo' in string literals (innerHTML templates, etc.)
+    /\bid\s*=\s*["']([a-zA-Z_][\w-]*)["']/g,
+    // el.id = 'foo' / obj.id = "foo"
+    /\.id\s*=\s*["']([a-zA-Z_][\w-]*)["']/g,
+];
+function collectDynamicIds(scripts) {
+    const ids = new Set();
+    for (const script of scripts) {
+        for (const pattern of ID_CREATE_PATTERNS) {
+            pattern.lastIndex = 0;
+            let match;
+            while ((match = pattern.exec(script.source)) !== null) {
+                ids.add(match[1]);
+            }
+        }
+    }
+    return ids;
+}
+/** Patterns that reference element IDs in JS code. */
+const ID_REF_PATTERNS = [
+    /getElementById\(\s*['"]([^'"]+)['"]\s*\)/g,
+    /querySelector(?:All)?\(\s*['"]#([^'"]+)['"]\s*\)/g,
+    /\$\(\s*['"]#([^'"]+)['"]\s*\)/g,
+];
+function checkIdReferences(scripts, ids) {
+    const errors = [];
+    for (const script of scripts) {
+        for (const pattern of ID_REF_PATTERNS) {
+            pattern.lastIndex = 0;
+            let match;
+            while ((match = pattern.exec(script.source)) !== null) {
+                const refId = match[1];
+                if (!ids.has(refId)) {
+                    errors.push({
+                        type: 'missing-element',
+                        message: `Script references element '#${refId}' which does not exist in the page`,
+                        source: `inline-script-${script.index}`,
+                    });
+                }
+            }
+        }
+    }
+    return errors;
+}
+// ---------------------------------------------------------------------------
+// Layer 3: SynthOS API Pattern Checks
+// ---------------------------------------------------------------------------
+const SYNTHOS_CALL_PATTERN = /synthos(?:\.[\w]+)+/g;
+function checkSynthosApi(scripts) {
+    const errors = [];
+    const seen = new Set();
+    for (const script of scripts) {
+        SYNTHOS_CALL_PATTERN.lastIndex = 0;
+        let match;
+        while ((match = SYNTHOS_CALL_PATTERN.exec(script.source)) !== null) {
+            const call = match[0];
+            // Deduplicate within a single validation run
+            if (seen.has(call))
+                continue;
+            if (!KNOWN_SYNTHOS_METHODS.has(call)) {
+                seen.add(call);
+                errors.push({
+                    type: 'unknown-api',
+                    message: `Unknown SynthOS API call: ${call}`,
+                    source: `inline-script-${script.index}`,
+                });
+            }
+        }
+    }
+    return errors;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+function validatePage(html) {
+    const start = Date.now();
+    const errors = [];
+    // Layer 1: Extract and parse scripts
+    const scripts = extractScripts(html);
+    for (const script of scripts) {
+        const err = parseSyntax(script);
+        if (err)
+            errors.push(err);
+    }
+    // Layer 2: DOM ID reference checks (only if no syntax errors)
+    if (errors.length === 0) {
+        const ids = buildIdInventory(html);
+        const dynamicIds = collectDynamicIds(scripts);
+        for (const id of dynamicIds)
+            ids.add(id);
+        errors.push(...checkIdReferences(scripts, ids));
+    }
+    // Layer 3: SynthOS API pattern checks (always runs)
+    errors.push(...checkSynthosApi(scripts));
+    return {
+        valid: errors.length === 0,
+        errors,
+        durationMs: Date.now() - start,
+    };
+}
+exports.validatePage = validatePage;
+//# sourceMappingURL=pageValidator.js.map

package/dist/service/pageValidator.js.map

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

package/dist/service/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/service/server.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAC,WAAW,EAAC,MAAM,SAAS,CAAC;AAG7C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAQxC,OAAO,EAAmC,UAAU,EAAE,MAAM,eAAe,CAAC;AAE5E,wBAAgB,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,GAAE,UAA8B,GAAG,WAAW,CA4DrG"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/service/server.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAC,WAAW,EAAC,MAAM,SAAS,CAAC;AAG7C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AASxC,OAAO,EAAmC,UAAU,EAAE,MAAM,eAAe,CAAC;AAE5E,wBAAgB,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,GAAE,UAA8B,GAAG,WAAW,CA+DrG"}

package/dist/service/server.js

@@ -9,6 +9,7 @@ const usePageRoutes_1 = require("./usePageRoutes");
 const useApiRoutes_1 = require("./useApiRoutes");
 const useDataRoutes_1 = require("./useDataRoutes");
 const useFileRoutes_1 = require("./useFileRoutes");
+const useExtractRoutes_1 = require("./useExtractRoutes");
 const useSharedDataRoutes_1 = require("./useSharedDataRoutes");
 const useSharedFileRoutes_1 = require("./useSharedFileRoutes");
 const useConnectorRoutes_1 = require("./useConnectorRoutes");
@@ -57,6 +58,9 @@ function server(config, customizer = customizer_1.customizer) {
     // File routes
     if (customizer.isEnabled('files'))
         (0, useFileRoutes_1.useFileRoutes)(config, app);
+    // Extract routes — schema-typed file extraction via active chat model
+    if (customizer.isEnabled('extract'))
+        (0, useExtractRoutes_1.useExtractRoutes)(config, app);
     // Shared data routes
     if (customizer.isEnabled('shared-data'))
         (0, useSharedDataRoutes_1.useSharedDataRoutes)(config, app);

package/dist/service/server.js.map

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

package/dist/service/sharedTableSchema.d.ts

@@ -0,0 +1,73 @@
+import { SynthOSConfig } from '../init';
+/**
+ * Schema sidecar IO + additive-merge logic. Used by both shared-table and
+ * per-page-table routes — the only difference is the parent folder where the
+ * `<table>.schema.json` file lives.
+ *
+ * Spec: docs/specs/shared-tables-schema-sidecar.md
+ */
+export interface SchemaWrapper {
+    version: number;
+    schema: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+    definedBy?: string;
+}
+export type MergeMode = 'additive' | 'replace';
+export interface MergeConflict {
+    field: string;
+    existing: unknown;
+    incoming: unknown;
+}
+/** Sidecar file path: `<parent>/<table>.schema.json`. */
+export declare function schemaFile(parent: string, table: string): string;
+/** Load the wrapper. Returns undefined if missing or unparsable. */
+export declare function loadSchema(config: SynthOSConfig, parent: string, table: string): Promise<SchemaWrapper | undefined>;
+/** Persist a wrapper to disk. */
+export declare function saveSchema(config: SynthOSConfig, parent: string, table: string, wrapper: SchemaWrapper): Promise<void>;
+/** Delete the schema sidecar. No-op if it doesn't exist. */
+export declare function deleteSchema(config: SynthOSConfig, parent: string, table: string): Promise<void>;
+/**
+ * Apply `incoming` against `existing` per `mode`:
+ *   - 'replace'  → drop existing entirely; incoming wins.
+ *   - 'additive' → union of `properties` (existing wins on overlap if types match;
+ *                  conflicting types reported via `conflicts`); union of `required`.
+ *
+ * Returns the merged schema and any conflicts. On conflict, callers should
+ * surface them as a 409 and NOT persist the result.
+ */
+export declare function mergeSchema(existing: Record<string, unknown> | undefined, incoming: Record<string, unknown>, mode: MergeMode): {
+    merged: Record<string, unknown>;
+    conflicts: MergeConflict[];
+};
+/**
+ * Validate the structural shape of an incoming JSON Schema. Strict-mode
+ * validation against the meta-schema is out of scope; we only check that the
+ * payload is a plain object so we don't persist garbage.
+ */
+export declare function isValidSchemaPayload(s: unknown): s is Record<string, unknown>;
+/**
+ * Build a SchemaWrapper from a plain JSON Schema, using `now` for both
+ * timestamps when no existing wrapper is being preserved.
+ */
+export declare function newSchemaWrapper(schema: Record<string, unknown>, now: string, definedBy?: string): SchemaWrapper;
+/**
+ * Update an existing wrapper, preserving createdAt and bumping updatedAt.
+ */
+export declare function updateSchemaWrapper(existing: SchemaWrapper, schema: Record<string, unknown>, now: string, definedBy?: string): SchemaWrapper;
+/**
+ * Enumerate tables in a namespace folder. A "table" is either:
+ *   - a subfolder containing record files, OR
+ *   - a `<name>.schema.json` sidecar (table may be schemaless until first save).
+ *
+ * Returns one entry per unique table name, with hasSchema + recordCount.
+ *
+ * `reserved` filters out names that occupy the namespace for non-table use
+ * (e.g. `files`, the per-page uploads folder).
+ */
+export declare function listTables(config: SynthOSConfig, parent: string, reserved?: ReadonlySet<string>): Promise<Array<{
+    name: string;
+    hasSchema: boolean;
+    recordCount: number;
+}>>;
+//# sourceMappingURL=sharedTableSchema.d.ts.map