synthos 0.8.0 → 0.9.0

package/dist/builders/types.js

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPENAI_CHANGE_OPS_SCHEMA = exports.CHANGE_OPS_FORMAT_INSTRUCTION_NO_RANGED = exports.CHANGE_OPS_SCHEMA_NO_RANGED = exports.CHANGE_OPS_SCHEMA = exports.CHANGE_OPS_FORMAT_INSTRUCTION = void 0;
+// ---------------------------------------------------------------------------
+// Change operations output format — text instruction for non-structured builders
+// ---------------------------------------------------------------------------
+/**
+ * Text instruction that tells the model to return a JSON array of change operations.
+ * Append this to <INSTRUCTIONS> for builders that don't support structured outputs.
+ */
+exports.CHANGE_OPS_FORMAT_INSTRUCTION = `Return a JSON array of change operations to apply to the page. Do NOT return the full HTML page.
+
+Each operation must be one of:
+{ "op": "update", "nodeId": "<data-node-id>", "html": "<new innerHTML>" }
+  — replaces the innerHTML of the target element
+
+{ "op": "replace", "nodeId": "<data-node-id>", "html": "<new outerHTML>" }
+  — replaces the entire element (outerHTML) with new markup
+
+{ "op": "delete", "nodeId": "<data-node-id>" }
+  — removes the element from the page
+
+{ "op": "insert", "parentId": "<data-node-id>", "position": "prepend"|"append"|"before"|"after", "html": "<new element HTML>" }
+  — inserts new HTML relative to the parent element
+
+{ "op": "style-element", "nodeId": "<data-node-id>", "style": "<css style string>" }
+  — sets the style attribute of the target element (must be unlocked)
+
+{ "op": "search-replace", "nodeId": "<data-node-id>", "search": "<exact text to find>", "replace": "<replacement text>" }
+  — finds exact text within a script/style block and replaces it. Use empty string for replace to delete.
+
+{ "op": "search-insert", "nodeId": "<data-node-id>", "after": "<exact text to find>", "content": "<new lines to insert>" }
+  — inserts new content immediately after the matched text in a script/style block.
+
+For partial edits to large scripts/styles, use search-replace or search-insert instead of
+replacing the entire block with update.
+Copy the search/after text exactly as it appears in the source.
+When making multiple edits to the same block, ensure each search string targets distinct text.
+To delete code, use search-replace with an empty replace string.
+
+Return ONLY the JSON array. Example:
+[
+  { "op": "update", "nodeId": "5", "html": "<p>Hello world</p>" },
+  { "op": "insert", "parentId": "3", "position": "append", "html": "<div class=\\"msg\\">New message</div>" }
+]`;
+// ---------------------------------------------------------------------------
+// Change operations JSON schema — for structured output (constrained decoding)
+// ---------------------------------------------------------------------------
+/**
+ * JSON schema matching the ChangeOp union type for Anthropic structured outputs.
+ * The top-level schema is an array of change operations.
+ */
+exports.CHANGE_OPS_SCHEMA = {
+    type: 'array',
+    items: {
+        anyOf: [
+            {
+                type: 'object',
+                properties: {
+                    op: { type: 'string', const: 'update' },
+                    nodeId: { type: 'string' },
+                    html: { type: 'string' },
+                },
+                required: ['op', 'nodeId', 'html'],
+                additionalProperties: false,
+            },
+            {
+                type: 'object',
+                properties: {
+                    op: { type: 'string', const: 'replace' },
+                    nodeId: { type: 'string' },
+                    html: { type: 'string' },
+                },
+                required: ['op', 'nodeId', 'html'],
+                additionalProperties: false,
+            },
+            {
+                type: 'object',
+                properties: {
+                    op: { type: 'string', const: 'delete' },
+                    nodeId: { type: 'string' },
+                },
+                required: ['op', 'nodeId'],
+                additionalProperties: false,
+            },
+            {
+                type: 'object',
+                properties: {
+                    op: { type: 'string', const: 'insert' },
+                    parentId: { type: 'string' },
+                    position: { type: 'string', enum: ['prepend', 'append', 'before', 'after'] },
+                    html: { type: 'string' },
+                },
+                required: ['op', 'parentId', 'position', 'html'],
+                additionalProperties: false,
+            },
+            {
+                type: 'object',
+                properties: {
+                    op: { type: 'string', const: 'style-element' },
+                    nodeId: { type: 'string' },
+                    style: { type: 'string' },
+                },
+                required: ['op', 'nodeId', 'style'],
+                additionalProperties: false,
+            },
+            {
+                type: 'object',
+                properties: {
+                    op: { type: 'string', const: 'search-replace' },
+                    nodeId: { type: 'string' },
+                    search: { type: 'string' },
+                    replace: { type: 'string' },
+                },
+                required: ['op', 'nodeId', 'search', 'replace'],
+                additionalProperties: false,
+            },
+            {
+                type: 'object',
+                properties: {
+                    op: { type: 'string', const: 'search-insert' },
+                    nodeId: { type: 'string' },
+                    after: { type: 'string' },
+                    content: { type: 'string' },
+                },
+                required: ['op', 'nodeId', 'after', 'content'],
+                additionalProperties: false,
+            },
+        ],
+    },
+};
+/**
+ * Variant of CHANGE_OPS_SCHEMA that omits ranged write operations (search-replace, search-insert).
+ * Used for medium/hard/re-write changes where the model should replace full blocks instead of
+ * attempting partial edits.
+ */
+exports.CHANGE_OPS_SCHEMA_NO_RANGED = {
+    type: 'array',
+    items: {
+        anyOf: [
+            {
+                type: 'object',
+                properties: {
+                    op: { type: 'string', const: 'update' },
+                    nodeId: { type: 'string' },
+                    html: { type: 'string' },
+                },
+                required: ['op', 'nodeId', 'html'],
+                additionalProperties: false,
+            },
+            {
+                type: 'object',
+                properties: {
+                    op: { type: 'string', const: 'replace' },
+                    nodeId: { type: 'string' },
+                    html: { type: 'string' },
+                },
+                required: ['op', 'nodeId', 'html'],
+                additionalProperties: false,
+            },
+            {
+                type: 'object',
+                properties: {
+                    op: { type: 'string', const: 'delete' },
+                    nodeId: { type: 'string' },
+                },
+                required: ['op', 'nodeId'],
+                additionalProperties: false,
+            },
+            {
+                type: 'object',
+                properties: {
+                    op: { type: 'string', const: 'insert' },
+                    parentId: { type: 'string' },
+                    position: { type: 'string', enum: ['prepend', 'append', 'before', 'after'] },
+                    html: { type: 'string' },
+                },
+                required: ['op', 'parentId', 'position', 'html'],
+                additionalProperties: false,
+            },
+            {
+                type: 'object',
+                properties: {
+                    op: { type: 'string', const: 'style-element' },
+                    nodeId: { type: 'string' },
+                    style: { type: 'string' },
+                },
+                required: ['op', 'nodeId', 'style'],
+                additionalProperties: false,
+            },
+        ],
+    },
+};
+/**
+ * Text instruction variant for no-ranged-writes mode.
+ * Tells the model to use `update` for full innerHTML replacement instead of partial edits.
+ */
+exports.CHANGE_OPS_FORMAT_INSTRUCTION_NO_RANGED = `For script and style blocks, use "update" to replace the full innerHTML or "replace" to replace the full outerHTML. Do NOT use partial search-replace edits.`;
+/**
+ * OpenAI structured outputs require a root-level object.
+ * This wraps CHANGE_OPS_SCHEMA in { changes: [...] }.
+ */
+exports.OPENAI_CHANGE_OPS_SCHEMA = {
+    type: 'object',
+    properties: {
+        changes: exports.CHANGE_OPS_SCHEMA,
+    },
+    required: ['changes'],
+    additionalProperties: false,
+};
+//# sourceMappingURL=types.js.map

package/dist/builders/types.js.map

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

package/dist/connectors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connectors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EACR,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACvB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connectors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACzE,YAAY,EACR,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACvB,MAAM,SAAS,CAAC"}

package/dist/connectors/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONNECTOR_REGISTRY = void 0;
+exports.getConnectorRegistry = exports.loadConnectorRegistry = void 0;
 var registry_1 = require("./registry");
-Object.defineProperty(exports, "CONNECTOR_REGISTRY", { enumerable: true, get: function () { return registry_1.CONNECTOR_REGISTRY; } });
+Object.defineProperty(exports, "loadConnectorRegistry", { enumerable: true, get: function () { return registry_1.loadConnectorRegistry; } });
+Object.defineProperty(exports, "getConnectorRegistry", { enumerable: true, get: function () { return registry_1.getConnectorRegistry; } });
 //# sourceMappingURL=index.js.map

package/dist/connectors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connectors/index.ts"],"names":[],"mappings":";;;AAAA,uCAAgD;AAAvC,8GAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connectors/index.ts"],"names":[],"mappings":";;;AAAA,uCAAyE;AAAhE,iHAAA,qBAAqB,OAAA;AAAE,gHAAA,oBAAoB,OAAA"}

package/dist/connectors/registry.d.ts

@@ -1,3 +1,4 @@
 import { ConnectorDefinition } from './types';
-export declare const CONNECTOR_REGISTRY: ConnectorDefinition[];
+export declare function loadConnectorRegistry(connectorsDirs: string[]): ConnectorDefinition[];
+export declare function getConnectorRegistry(connectorsDirs?: string[]): ConnectorDefinition[];
 //# sourceMappingURL=registry.d.ts.map

package/dist/connectors/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/connectors/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAiB,MAAM,SAAS,CAAC;AAc7D,eAAO,MAAM,kBAAkB,EAAE,mBAAmB,EAKH,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/connectors/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAiB,MAAM,SAAS,CAAC;AAY7D,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,mBAAmB,EAAE,CAgBrF;AAID,wBAAgB,oBAAoB,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,mBAAmB,EAAE,CAOrF"}

package/dist/connectors/registry.js

@@ -23,10 +23,9 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONNECTOR_REGISTRY = void 0;
+exports.getConnectorRegistry = exports.loadConnectorRegistry = void 0;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const connectorsDir = __dirname;
 function loadConnectorJson(dir) {
     const file = path.join(dir, 'connector.json');
     if (!fs.existsSync(file))
@@ -37,10 +36,34 @@ function loadConnectorJson(dir) {
         hints: raw.hints ? raw.hints.join('\n') : undefined
     };
 }
-exports.CONNECTOR_REGISTRY = fs
-    .readdirSync(connectorsDir, { withFileTypes: true })
-    .filter(d => d.isDirectory())
-    .map(d => loadConnectorJson(path.join(connectorsDir, d.name)))
-    .filter((d) => d !== null)
-    .sort((a, b) => a.name.localeCompare(b.name));
+function loadConnectorRegistry(connectorsDirs) {
+    const seen = new Set();
+    const results = [];
+    for (const dir of connectorsDirs) {
+        if (!fs.existsSync(dir))
+            continue;
+        const entries = fs.readdirSync(dir, { withFileTypes: true })
+            .filter(d => d.isDirectory());
+        for (const d of entries) {
+            const def = loadConnectorJson(path.join(dir, d.name));
+            if (def && !seen.has(def.id)) {
+                seen.add(def.id);
+                results.push(def);
+            }
+        }
+    }
+    return results.sort((a, b) => a.name.localeCompare(b.name));
+}
+exports.loadConnectorRegistry = loadConnectorRegistry;
+let _registry;
+let _registryKey;
+function getConnectorRegistry(connectorsDirs) {
+    const key = connectorsDirs ? connectorsDirs.join('|') : undefined;
+    if (!_registry || (connectorsDirs && key !== _registryKey)) {
+        _registry = loadConnectorRegistry(connectorsDirs ?? [path.join(__dirname, '../../service-connectors')]);
+        _registryKey = key;
+    }
+    return _registry;
+}
+exports.getConnectorRegistry = getConnectorRegistry;
 //# sourceMappingURL=registry.js.map

package/dist/connectors/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/connectors/registry.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAG7B,MAAM,aAAa,GAAG,SAAS,CAAC;AAEhC,SAAS,iBAAiB,CAAC,GAAW;IAClC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAC9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,GAAG,GAAkB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACtE,OAAO;QACH,GAAG,GAAG;QACN,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KACtD,CAAC;AACN,CAAC;AAEY,QAAA,kBAAkB,GAA0B,EAAE;KACtD,WAAW,CAAC,aAAa,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;KACnD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;KAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;KAC7D,MAAM,CAAC,CAAC,CAAC,EAA4B,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;KACnD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/connectors/registry.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAG7B,SAAS,iBAAiB,CAAC,GAAW;IAClC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAC9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,GAAG,GAAkB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACtE,OAAO;QACH,GAAG,GAAG;QACN,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KACtD,CAAC;AACN,CAAC;AAED,SAAgB,qBAAqB,CAAC,cAAwB;IAC1D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAA0B,EAAE,CAAC;IAC1C,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE;QAC9B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAClC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aACvD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAClC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE;YACrB,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACtD,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;gBAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;aACrB;SACJ;KACJ;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAChE,CAAC;AAhBD,sDAgBC;AAED,IAAI,SAA4C,CAAC;AACjD,IAAI,YAAgC,CAAC;AACrC,SAAgB,oBAAoB,CAAC,cAAyB;IAC1D,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,IAAI,CAAC,SAAS,IAAI,CAAC,cAAc,IAAI,GAAG,KAAK,YAAY,CAAC,EAAE;QACxD,SAAS,GAAG,qBAAqB,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,0BAA0B,CAAC,CAAC,CAAC,CAAC;QACxG,YAAY,GAAG,GAAG,CAAC;KACtB;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAPD,oDAOC"}

package/dist/customizer/Customizer.d.ts

@@ -0,0 +1,57 @@
+import { Application } from 'express';
+import { SynthOSConfig } from '../init';
+import { ContextSection } from '../builders/types';
+export type RouteInstaller = (config: SynthOSConfig, app: Application) => void;
+export declare class Customizer {
+    protected disabled: Set<string>;
+    protected extraRoutes: RouteInstaller[];
+    /** Route hints for the LLM prompt (fork developers can add custom hints). */
+    protected routeHintEntries: {
+        hints: string;
+    }[];
+    /** Custom instructions appended to transformPage's instruction block. */
+    protected customTransformInstructions: string[];
+    /** Custom context sections appended to the builder's additional sections. */
+    protected customContextSections: ContextSection[];
+    /** Name of the local data folder created in the user's project directory. */
+    get localFolder(): string;
+    /** Folders containing built-in system pages (builder, settings, etc.) */
+    get requiredPagesFolders(): string[];
+    /** Folders containing starter page templates copied on init */
+    get defaultPagesFolders(): string[];
+    /** Folders containing theme CSS/JSON files */
+    get defaultThemesFolders(): string[];
+    /** Folders containing versioned static files (page-v2.js, helpers-v2.js, etc.) */
+    get staticFilesFolders(): string[];
+    /** Folders containing connector JSON definitions */
+    get serviceConnectorsFolders(): string[];
+    /** Folders containing default scripts copied on init */
+    get defaultScriptsFolders(): string[];
+    /** Route path for the "browse all pages/tabs" listing page.
+     *  Override in a derived class to change the redirect target for outdated pages. */
+    get tabsListRoute(): string;
+    /** Product name used in LLM prompts and branding strings.
+     *  Override in a derived class for white-labeling. */
+    get productName(): string;
+    disable(...groups: string[]): this;
+    enable(...groups: string[]): this;
+    isEnabled(group: string): boolean;
+    addRoutes(...installers: (RouteInstaller | {
+        installer: RouteInstaller;
+        hints: string;
+    })[]): this;
+    getExtraRoutes(): RouteInstaller[];
+    /** Add route hints that will be shown to the LLM in transformPage. */
+    addRouteHints(...hints: string[]): this;
+    /** Get all custom route hints. */
+    getRouteHints(): string[];
+    /** Add custom instructions for the transformPage LLM prompt. */
+    addTransformInstructions(...instructions: string[]): this;
+    /** Get custom transform instructions. */
+    getTransformInstructions(): string[];
+    /** Add custom context sections for the builder. */
+    addContextSections(...sections: ContextSection[]): this;
+    /** Get custom context sections. */
+    getContextSections(): ContextSection[];
+}
+//# sourceMappingURL=Customizer.d.ts.map

package/dist/customizer/Customizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Customizer.d.ts","sourceRoot":"","sources":["../../src/customizer/Customizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;AAE/E,qBAAa,UAAU;IACnB,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAa;IAC5C,SAAS,CAAC,WAAW,EAAE,cAAc,EAAE,CAAM;IAE7C,6EAA6E;IAC7E,SAAS,CAAC,gBAAgB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAM;IAErD,yEAAyE;IACzE,SAAS,CAAC,2BAA2B,EAAE,MAAM,EAAE,CAAM;IAErD,6EAA6E;IAC7E,SAAS,CAAC,qBAAqB,EAAE,cAAc,EAAE,CAAM;IAKvD,6EAA6E;IAC7E,IAAI,WAAW,IAAI,MAAM,CAExB;IASD,yEAAyE;IACzE,IAAI,oBAAoB,IAAI,MAAM,EAAE,CAEnC;IAED,+DAA+D;IAC/D,IAAI,mBAAmB,IAAI,MAAM,EAAE,CAElC;IAED,8CAA8C;IAC9C,IAAI,oBAAoB,IAAI,MAAM,EAAE,CAEnC;IAED,kFAAkF;IAClF,IAAI,kBAAkB,IAAI,MAAM,EAAE,CAEjC;IAED,oDAAoD;IACpD,IAAI,wBAAwB,IAAI,MAAM,EAAE,CAEvC;IAED,wDAAwD;IACxD,IAAI,qBAAqB,IAAI,MAAM,EAAE,CAEpC;IAED;wFACoF;IACpF,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;0DACsD;IACtD,IAAI,WAAW,IAAI,MAAM,CAExB;IAMD,OAAO,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAKlC,MAAM,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAKjC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMjC,SAAS,CAAC,GAAG,UAAU,EAAE,CAAC,cAAc,GAAG;QAAE,SAAS,EAAE,cAAc,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,GAAG,IAAI;IAYjG,cAAc,IAAI,cAAc,EAAE;IAMlC,sEAAsE;IACtE,aAAa,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAKvC,kCAAkC;IAClC,aAAa,IAAI,MAAM,EAAE;IAMzB,gEAAgE;IAChE,wBAAwB,CAAC,GAAG,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI;IAKzD,yCAAyC;IACzC,wBAAwB,IAAI,MAAM,EAAE;IAMpC,mDAAmD;IACnD,kBAAkB,CAAC,GAAG,QAAQ,EAAE,cAAc,EAAE,GAAG,IAAI;IAKvD,mCAAmC;IACnC,kBAAkB,IAAI,cAAc,EAAE;CAGzC"}

package/dist/customizer/Customizer.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Customizer = void 0;
+class Customizer {
+    disabled = new Set();
+    extraRoutes = [];
+    /** Route hints for the LLM prompt (fork developers can add custom hints). */
+    routeHintEntries = [];
+    /** Custom instructions appended to transformPage's instruction block. */
+    customTransformInstructions = [];
+    /** Custom context sections appended to the builder's additional sections. */
+    customContextSections = [];
+    // --- Local data folder ---
+    // Override in a derived class to change the local project folder name.
+    /** Name of the local data folder created in the user's project directory. */
+    get localFolder() {
+        return '.synthos';
+    }
+    // --- Content folder paths ---
+    // Override these in a derived class to point to your fork's folders.
+    // Each getter returns `string[]`. The sentinel value `'default'` is
+    // resolved by `createConfig()` to the built-in SynthOS folder for that
+    // getter. Forks can return additional paths alongside (or instead of)
+    // `'default'` to layer custom folders.
+    /** Folders containing built-in system pages (builder, settings, etc.) */
+    get requiredPagesFolders() {
+        return ['default'];
+    }
+    /** Folders containing starter page templates copied on init */
+    get defaultPagesFolders() {
+        return ['default'];
+    }
+    /** Folders containing theme CSS/JSON files */
+    get defaultThemesFolders() {
+        return ['default'];
+    }
+    /** Folders containing versioned static files (page-v2.js, helpers-v2.js, etc.) */
+    get staticFilesFolders() {
+        return ['default'];
+    }
+    /** Folders containing connector JSON definitions */
+    get serviceConnectorsFolders() {
+        return ['default'];
+    }
+    /** Folders containing default scripts copied on init */
+    get defaultScriptsFolders() {
+        return ['default'];
+    }
+    /** Route path for the "browse all pages/tabs" listing page.
+     *  Override in a derived class to change the redirect target for outdated pages. */
+    get tabsListRoute() {
+        return '/pages';
+    }
+    /** Product name used in LLM prompts and branding strings.
+     *  Override in a derived class for white-labeling. */
+    get productName() {
+        return 'SynthOS';
+    }
+    // --- Feature group control ---
+    // Built-in groups: 'pages', 'api', 'connectors', 'agents',
+    //   'data', 'brainstorm', 'search', 'scripts'
+    disable(...groups) {
+        for (const g of groups)
+            this.disabled.add(g);
+        return this;
+    }
+    enable(...groups) {
+        for (const g of groups)
+            this.disabled.delete(g);
+        return this;
+    }
+    isEnabled(group) {
+        return !this.disabled.has(group);
+    }
+    // --- Custom routes ---
+    addRoutes(...installers) {
+        for (const entry of installers) {
+            if (typeof entry === 'function') {
+                this.extraRoutes.push(entry);
+            }
+            else {
+                this.extraRoutes.push(entry.installer);
+                this.routeHintEntries.push({ hints: entry.hints });
+            }
+        }
+        return this;
+    }
+    getExtraRoutes() {
+        return this.extraRoutes;
+    }
+    // --- Route hints ---
+    /** Add route hints that will be shown to the LLM in transformPage. */
+    addRouteHints(...hints) {
+        for (const h of hints)
+            this.routeHintEntries.push({ hints: h });
+        return this;
+    }
+    /** Get all custom route hints. */
+    getRouteHints() {
+        return this.routeHintEntries.map(e => e.hints);
+    }
+    // --- Custom transform instructions ---
+    /** Add custom instructions for the transformPage LLM prompt. */
+    addTransformInstructions(...instructions) {
+        this.customTransformInstructions.push(...instructions);
+        return this;
+    }
+    /** Get custom transform instructions. */
+    getTransformInstructions() {
+        return this.customTransformInstructions;
+    }
+    // --- Custom context sections ---
+    /** Add custom context sections for the builder. */
+    addContextSections(...sections) {
+        this.customContextSections.push(...sections);
+        return this;
+    }
+    /** Get custom context sections. */
+    getContextSections() {
+        return this.customContextSections;
+    }
+}
+exports.Customizer = Customizer;
+//# sourceMappingURL=Customizer.js.map

package/dist/customizer/Customizer.js.map

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

package/dist/customizer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/customizer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/dist/customizer/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.customizer = exports.Customizer = void 0;
+var Customizer_1 = require("./Customizer");
+Object.defineProperty(exports, "Customizer", { enumerable: true, get: function () { return Customizer_1.Customizer; } });
+const Customizer_2 = require("./Customizer");
+// Default instance — replace with an App specific customizer
+exports.customizer = new Customizer_2.Customizer();
+//# sourceMappingURL=index.js.map

package/dist/customizer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/customizer/index.ts"],"names":[],"mappings":";;;AAAA,2CAA0D;AAAjD,wGAAA,UAAU,OAAA;AACnB,6CAA0C;AAE1C,6DAA6D;AAChD,QAAA,UAAU,GAAG,IAAI,uBAAU,EAAE,CAAC"}

package/dist/files.d.ts

@@ -9,4 +9,20 @@ export declare function saveFile(path: string, content: string): Promise<void>;
 export declare function deleteFile(path: string): Promise<void>;
 export declare function copyFolderRecursive(srcFolder: string, destFolder: string): Promise<void>;
 export declare function deleteFolder(dirPath: string): Promise<void>;
+/**
+ * Search folders in order, return the full path to the first existing match
+ * for the given filename.
+ */
+export declare function findFileInFolders(folders: string[], filename: string): Promise<string | undefined>;
+/**
+ * Merge file listings from multiple folders. First folder takes priority on
+ * name collisions (earlier occurrence wins).
+ */
+export declare function listFilesFromFolders(folders: string[]): Promise<string[]>;
+/**
+ * Copy files from multiple source folders into a single destination.
+ * First folder takes priority on duplicate filenames (copy is skipped
+ * if the file already exists in dest from an earlier folder).
+ */
+export declare function copyFilesFromFolders(folders: string[], destFolder: string): Promise<void>;
 //# sourceMappingURL=files.d.ts.map

package/dist/files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAGA,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOlE;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKjF;AAED,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASpF;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE/D;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAKpE;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE5D;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5D;AAED,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY9F;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjE"}
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAGA,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOlE;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKjF;AAED,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASpF;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE/D;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAKpE;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE5D;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5D;AAED,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY9F;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjE;AAID;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQxG;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAc/E;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAc/F"}

package/dist/files.js

@@ -26,7 +26,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deleteFolder = exports.copyFolderRecursive = exports.deleteFile = exports.saveFile = exports.loadFile = exports.listFolders = exports.listFiles = exports.ensureFolderExists = exports.copyFiles = exports.copyFile = exports.checkIfExists = void 0;
+exports.copyFilesFromFolders = exports.listFilesFromFolders = exports.findFileInFolders = exports.deleteFolder = exports.copyFolderRecursive = exports.deleteFile = exports.saveFile = exports.loadFile = exports.listFolders = exports.listFiles = exports.ensureFolderExists = exports.copyFiles = exports.copyFile = exports.checkIfExists = void 0;
 const fs = __importStar(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
 async function checkIfExists(path) {
@@ -102,4 +102,63 @@ async function deleteFolder(dirPath) {
     await fs.rm(dirPath, { recursive: true });
 }
 exports.deleteFolder = deleteFolder;
+// --- Multi-folder helpers ---
+/**
+ * Search folders in order, return the full path to the first existing match
+ * for the given filename.
+ */
+async function findFileInFolders(folders, filename) {
+    for (const folder of folders) {
+        const candidate = path_1.default.join(folder, filename);
+        if (await checkIfExists(candidate)) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+exports.findFileInFolders = findFileInFolders;
+/**
+ * Merge file listings from multiple folders. First folder takes priority on
+ * name collisions (earlier occurrence wins).
+ */
+async function listFilesFromFolders(folders) {
+    const seen = new Set();
+    const result = [];
+    for (const folder of folders) {
+        if (!await checkIfExists(folder))
+            continue;
+        const files = await listFiles(folder);
+        for (const f of files) {
+            if (!seen.has(f)) {
+                seen.add(f);
+                result.push(f);
+            }
+        }
+    }
+    return result;
+}
+exports.listFilesFromFolders = listFilesFromFolders;
+/**
+ * Copy files from multiple source folders into a single destination.
+ * First folder takes priority on duplicate filenames (copy is skipped
+ * if the file already exists in dest from an earlier folder).
+ */
+async function copyFilesFromFolders(folders, destFolder) {
+    await ensureFolderExists(destFolder);
+    const copied = new Set();
+    for (const folder of folders) {
+        if (!await checkIfExists(folder))
+            continue;
+        const files = await fs.readdir(folder);
+        for (const file of files) {
+            if (copied.has(file))
+                continue;
+            copied.add(file);
+            const srcPath = path_1.default.join(folder, file);
+            const destPath = path_1.default.join(destFolder, file);
+            await fs.copyFile(srcPath, destPath);
+        }
+    }
+}
+exports.copyFilesFromFolders = copyFilesFromFolders;
 //# sourceMappingURL=files.js.map