synthos 0.8.0 → 0.9.0

package/dist/builders/anthropic.js

@@ -0,0 +1,227 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseBuilderResponse = exports.buildWithModel = exports.createAnthropicBuilder = exports.classifyRequest = void 0;
+const models_1 = require("../models");
+const transformPage_1 = require("../service/transformPage");
+const types_1 = require("./types");
+const CLASSIFIER_SYSTEM_PROMPT = `You classify user messages for a web page builder. Default to a change request. Only classify as "question" when the user is purely asking for information with zero implication that anything should change.
+
+<DECISION_RULES>
+Step 1 — Is this a pure information question with zero change implication?
+  Examples: "What color is the header?", "How many sections are there?", "What font is the title using?"
+  Yes, and there is absolutely no suggestion that anything should change → "question"
+  No → go to step 2.
+
+Step 2 — Classify complexity:
+  "easy-change": Text edits, color/style tweaks, toggling visibility, adding/removing a single element, minor CSS changes.
+  "medium-change": Modifying existing JS logic, updating event handlers, changing multiple related styles, adding a small feature to existing functionality, updating existing behavior.
+  "hard-change": Complex new features, significant new JS, games, animations, restructuring layout, forms with validation, multi-step work.
+  "re-write": Complete page overhaul, fundamental restructure, "start over", "rebuild", "redo the whole page".
+
+<OUTPUT_FORMAT>
+Return only JSON. No other text.
+- Change: { "classification": "easy-change" } or { "classification": "medium-change" } or { "classification": "hard-change" } or { "classification": "re-write" }
+- Question: { "classification": "question", "answer": "<brief answer>" }`;
+async function classifyRequest(apiKey, pageHtml, userMessage) {
+    try {
+        const sonnet = (0, models_1.anthropic)({ apiKey, model: 'claude-sonnet-4-5' });
+        const result = await sonnet({
+            system: { role: 'system', content: CLASSIFIER_SYSTEM_PROMPT },
+            prompt: { role: 'user', content: `<PAGE_HTML>\n${pageHtml}\n\n<USER_MESSAGE>\n${userMessage}` },
+            jsonMode: true,
+        });
+        if (!result.completed || !result.value) {
+            return { classification: 'hard-change' };
+        }
+        const parsed = JSON.parse(result.value);
+        const c = parsed.classification;
+        if (c === 'question') {
+            return { classification: 'question', answer: typeof parsed.answer === 'string' ? parsed.answer : '' };
+        }
+        if (c === 'easy-change' || c === 'medium-change' || c === 'hard-change' || c === 're-write') {
+            return { classification: c };
+        }
+        return { classification: 'hard-change' };
+    }
+    catch {
+        return { classification: 'hard-change' };
+    }
+}
+exports.classifyRequest = classifyRequest;
+// ---------------------------------------------------------------------------
+// Anthropic builder factory
+// ---------------------------------------------------------------------------
+/**
+ * Create an Anthropic-tuned builder.
+ *
+ * @param complete  The completePrompt function (already configured with API key / model).
+ * @param userInstructions  Optional user-level instructions from settings.
+ * @param productName  Product name for branding in prompts (defaults to 'SynthOS').
+ * @param options  Optional API key and model name for classifier routing.
+ */
+function createAnthropicBuilder(complete, userInstructions, productName, options) {
+    const name = productName ?? 'SynthOS';
+    return {
+        async run(currentPage, additionalSections, userMessage, newBuild, attachments) {
+            try {
+                const isOpus = options?.model?.startsWith('claude-opus-');
+                const noRanged = types_1.CHANGE_OPS_SCHEMA_NO_RANGED;
+                // Non-Opus models or missing apiKey: existing behavior
+                if (!isOpus || !options?.apiKey) {
+                    return buildWithModel(complete, currentPage, additionalSections, userMessage, userInstructions, name, attachments);
+                }
+                // Console errors bypass classification — always route to Opus with no ranged writes
+                if (userMessage.includes('CONSOLE_ERRORS:')) {
+                    console.log('classifyRequest: console errors detected → routing to ' + options.model + ' (no ranged)');
+                    return buildWithModel(complete, currentPage, additionalSections, userMessage, userInstructions, name, attachments, noRanged);
+                }
+                // New builds always use Opus with no ranged writes
+                if (newBuild) {
+                    console.log('classifyRequest: new build → routing to ' + options.model + ' (no ranged)');
+                    return buildWithModel(complete, currentPage, additionalSections, userMessage, userInstructions, name, attachments, noRanged);
+                }
+                // First edit to a saved page (v0→v1) — force Opus with no ranged writes
+                if (options?.isFirstEdit) {
+                    console.log('classifyRequest: first edit (v0→v1) → routing to ' + options.model + ' (no ranged)');
+                    return buildWithModel(complete, currentPage, additionalSections, userMessage, userInstructions, name, attachments, noRanged);
+                }
+                // Try again — force Opus with no ranged writes, skip classification
+                if (options?.tryAgain) {
+                    console.log('classifyRequest: try again → routing to claude-opus-4-6 (no ranged)');
+                    let opus = (0, models_1.anthropic)({ apiKey: options.apiKey, model: 'claude-opus-4-6' });
+                    if (options.wrapModel)
+                        opus = options.wrapModel(opus);
+                    return buildWithModel(opus, currentPage, additionalSections, userMessage, userInstructions, name, attachments, noRanged);
+                }
+                // Classify the request using Sonnet
+                const classifyResult = await classifyRequest(options.apiKey, currentPage.content, userMessage);
+                console.log(`classifyRequest: "${classifyResult.classification}" → routing to ${routeLabel(classifyResult.classification, options.model)}`);
+                // Questions — answer was already provided by the classifier
+                if (classifyResult.classification === 'question') {
+                    return { kind: 'reply', text: classifyResult.answer ?? '' };
+                }
+                // Easy changes use Sonnet with default schema (ranged allowed)
+                if (classifyResult.classification === 'easy-change') {
+                    let sonnet = (0, models_1.anthropic)({ apiKey: options.apiKey, model: 'claude-sonnet-4-5' });
+                    if (options.wrapModel)
+                        sonnet = options.wrapModel(sonnet);
+                    return buildWithModel(sonnet, currentPage, additionalSections, userMessage, userInstructions, name, attachments);
+                }
+                // Medium changes use Sonnet with no ranged writes
+                if (classifyResult.classification === 'medium-change') {
+                    let sonnet = (0, models_1.anthropic)({ apiKey: options.apiKey, model: 'claude-sonnet-4-5' });
+                    if (options.wrapModel)
+                        sonnet = options.wrapModel(sonnet);
+                    return buildWithModel(sonnet, currentPage, additionalSections, userMessage, userInstructions, name, attachments, noRanged);
+                }
+                // Hard changes and re-writes use Opus with no ranged writes
+                return buildWithModel(complete, currentPage, additionalSections, userMessage, userInstructions, name, attachments, noRanged);
+            }
+            catch (err) {
+                return { kind: 'error', error: err instanceof Error ? err : new Error(String(err)) };
+            }
+        }
+    };
+}
+exports.createAnthropicBuilder = createAnthropicBuilder;
+// ---------------------------------------------------------------------------
+// Build flow — shared prompt construction + model call + parsing
+// ---------------------------------------------------------------------------
+async function buildWithModel(model, currentPage, additionalSections, userMessage, userInstructions, productName, attachments, outputSchema) {
+    // -- System message: all static content (cacheable) --
+    const systemParts = [];
+    for (const section of additionalSections) {
+        if (section.content) {
+            systemParts.push(`${section.title}\n${section.content}`);
+        }
+    }
+    const instructionParts = [];
+    if (userInstructions?.trim()) {
+        instructionParts.push(userInstructions);
+    }
+    for (const section of additionalSections) {
+        if (section.instructions?.trim()) {
+            instructionParts.push(section.instructions);
+        }
+    }
+    instructionParts.push((0, transformPage_1.getTransformInstr)(productName));
+    const instructions = instructionParts.filter(s => s.trim() !== '').join('\n');
+    systemParts.push(`<INSTRUCTIONS>\n${instructions}`);
+    const systemContent = systemParts.join('\n\n');
+    // -- User message: dynamic content only (current page + user message) --
+    const promptText = `${currentPage.title}\n${currentPage.content}\n\n<USER_MESSAGE>\n${userMessage}`;
+    // Build prompt content — multimodal when image attachments are present
+    const imageAttachments = (attachments ?? []).filter(a => a.mediaType.startsWith('image/'));
+    let promptContent;
+    if (imageAttachments.length > 0) {
+        const blocks = [{ type: 'text', text: promptText }];
+        for (const att of imageAttachments) {
+            blocks.push({ type: 'image', mediaType: att.mediaType, data: att.data });
+        }
+        promptContent = blocks;
+    }
+    else {
+        promptContent = promptText;
+    }
+    // -- Call model --
+    const result = await model({
+        system: { role: 'system', content: systemContent },
+        prompt: { role: 'user', content: promptContent },
+        cacheSystem: true,
+        outputSchema: outputSchema ?? types_1.CHANGE_OPS_SCHEMA,
+    });
+    if (!result.completed) {
+        return { kind: 'error', error: result.error ?? new Error('Model call failed') };
+    }
+    // -- Parse response --
+    return parseBuilderResponse(result.value);
+}
+exports.buildWithModel = buildWithModel;
+// ---------------------------------------------------------------------------
+// Route label for console logging
+// ---------------------------------------------------------------------------
+function routeLabel(classification, configuredModel) {
+    if (classification === 'question')
+        return 'classifier (answered inline)';
+    if (classification === 'easy-change')
+        return 'claude-sonnet-4-5';
+    if (classification === 'medium-change')
+        return 'claude-sonnet-4-5 (no ranged)';
+    if (classification === 're-write')
+        return configuredModel + ' (re-write)';
+    return configuredModel + ' (no ranged)';
+}
+// ---------------------------------------------------------------------------
+// Response parsing — shared across builders
+// ---------------------------------------------------------------------------
+function parseBuilderResponse(raw) {
+    // Try parsing as a JSON object with a kind discriminator
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            if (parsed.kind === 'transforms' && Array.isArray(parsed.changes)) {
+                return { kind: 'transforms', changes: parsed.changes };
+            }
+            if (parsed.kind === 'reply' && typeof parsed.text === 'string') {
+                return { kind: 'reply', text: parsed.text };
+            }
+        }
+        // Bare array — backward compat
+        if (Array.isArray(parsed)) {
+            return { kind: 'transforms', changes: parsed };
+        }
+    }
+    catch {
+        // fall through to parseChangeList extraction
+    }
+    // Fall back to extracting a JSON array from the response text
+    try {
+        const changes = (0, transformPage_1.parseChangeList)(raw);
+        return { kind: 'transforms', changes };
+    }
+    catch {
+        return { kind: 'error', error: new Error('Failed to parse model response as JSON') };
+    }
+}
+exports.parseBuilderResponse = parseBuilderResponse;
+//# sourceMappingURL=anthropic.js.map

package/dist/builders/anthropic.js.map

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

package/dist/builders/fireworksai.d.ts

@@ -0,0 +1,9 @@
+import { completePrompt } from '../models';
+import { Builder } from './types';
+/**
+ * Create a FireworksAI-tuned builder.
+ * Currently identical to the Anthropic builder — separate file enables
+ * future per-provider tuning.
+ */
+export declare function createFireworksAIBuilder(complete: completePrompt, userInstructions?: string, productName?: string): Builder;
+//# sourceMappingURL=fireworksai.d.ts.map

package/dist/builders/fireworksai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fireworksai.d.ts","sourceRoot":"","sources":["../../src/builders/fireworksai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C,OAAO,EAAE,OAAO,EAAgD,MAAM,SAAS,CAAC;AAEhF;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,cAAc,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAgD3H"}

package/dist/builders/fireworksai.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFireworksAIBuilder = void 0;
+const transformPage_1 = require("../service/transformPage");
+const anthropic_1 = require("./anthropic");
+const types_1 = require("./types");
+/**
+ * Create a FireworksAI-tuned builder.
+ * Currently identical to the Anthropic builder — separate file enables
+ * future per-provider tuning.
+ */
+function createFireworksAIBuilder(complete, userInstructions, productName) {
+    const name = productName ?? 'SynthOS';
+    return {
+        async run(currentPage, additionalSections, userMessage, newBuild, _attachments) {
+            try {
+                // -- System message --
+                const systemParts = [
+                    `${currentPage.title}\n${currentPage.content}`,
+                ];
+                for (const section of additionalSections) {
+                    if (section.content) {
+                        systemParts.push(`${section.title}\n${section.content}`);
+                    }
+                }
+                const systemContent = systemParts.join('\n\n');
+                // -- User message --
+                const instructionParts = [];
+                if (userInstructions?.trim()) {
+                    instructionParts.push(userInstructions);
+                }
+                for (const section of additionalSections) {
+                    if (section.instructions?.trim()) {
+                        instructionParts.push(section.instructions);
+                    }
+                }
+                instructionParts.push((0, transformPage_1.getTransformInstr)(name));
+                instructionParts.push(types_1.CHANGE_OPS_FORMAT_INSTRUCTION);
+                const instructions = instructionParts.filter(s => s.trim() !== '').join('\n');
+                const promptContent = `<USER_MESSAGE>\n${userMessage}\n\n<INSTRUCTIONS>\n${instructions}`;
+                const result = await complete({
+                    system: { role: 'system', content: systemContent },
+                    prompt: { role: 'user', content: promptContent },
+                });
+                if (!result.completed) {
+                    return { kind: 'error', error: result.error ?? new Error('Model call failed') };
+                }
+                return (0, anthropic_1.parseBuilderResponse)(result.value);
+            }
+            catch (err) {
+                return { kind: 'error', error: err instanceof Error ? err : new Error(String(err)) };
+            }
+        }
+    };
+}
+exports.createFireworksAIBuilder = createFireworksAIBuilder;
+//# sourceMappingURL=fireworksai.js.map

package/dist/builders/fireworksai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fireworksai.js","sourceRoot":"","sources":["../../src/builders/fireworksai.ts"],"names":[],"mappings":";;;AACA,4DAA6D;AAC7D,2CAAmD;AACnD,mCAAgF;AAEhF;;;;GAIG;AACH,SAAgB,wBAAwB,CAAC,QAAwB,EAAE,gBAAyB,EAAE,WAAoB;IAC9G,MAAM,IAAI,GAAG,WAAW,IAAI,SAAS,CAAC;IAEtC,OAAO;QACH,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,kBAAkB,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAa;YAC3E,IAAI;gBACA,uBAAuB;gBACvB,MAAM,WAAW,GAAa;oBAC1B,GAAG,WAAW,CAAC,KAAK,KAAK,WAAW,CAAC,OAAO,EAAE;iBACjD,CAAC;gBACF,KAAK,MAAM,OAAO,IAAI,kBAAkB,EAAE;oBACtC,IAAI,OAAO,CAAC,OAAO,EAAE;wBACjB,WAAW,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;qBAC5D;iBACJ;gBACD,MAAM,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAE/C,qBAAqB;gBACrB,MAAM,gBAAgB,GAAa,EAAE,CAAC;gBACtC,IAAI,gBAAgB,EAAE,IAAI,EAAE,EAAE;oBAC1B,gBAAgB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;iBAC3C;gBACD,KAAK,MAAM,OAAO,IAAI,kBAAkB,EAAE;oBACtC,IAAI,OAAO,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE;wBAC9B,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;qBAC/C;iBACJ;gBACD,gBAAgB,CAAC,IAAI,CAAC,IAAA,iCAAiB,EAAC,IAAI,CAAC,CAAC,CAAC;gBAC/C,gBAAgB,CAAC,IAAI,CAAC,qCAA6B,CAAC,CAAC;gBAErD,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC9E,MAAM,aAAa,GAAG,mBAAmB,WAAW,uBAAuB,YAAY,EAAE,CAAC;gBAE1F,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC;oBAC1B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE;oBAClD,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE;iBACnD,CAAC,CAAC;gBAEH,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE;oBACnB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC;iBACnF;gBAED,OAAO,IAAA,gCAAoB,EAAC,MAAM,CAAC,KAAM,CAAC,CAAC;aAC9C;YAAC,OAAO,GAAY,EAAE;gBACnB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;aACxF;QACL,CAAC;KACJ,CAAC;AACN,CAAC;AAhDD,4DAgDC"}

package/dist/builders/index.d.ts

@@ -0,0 +1,13 @@
+import { ProviderName, completePrompt } from '../models';
+import { AnthropicBuilderOptions } from './anthropic';
+import { Builder } from './types';
+export { ContextSection, BuilderResult, Builder, Attachment } from './types';
+export { createAnthropicBuilder, AnthropicBuilderOptions } from './anthropic';
+export { createOpenAIBuilder } from './openai';
+export { createFireworksAIBuilder } from './fireworksai';
+export { parseBuilderResponse } from './anthropic';
+/**
+ * Factory that creates a provider-specific builder.
+ */
+export declare function createBuilder(provider: ProviderName, complete: completePrompt, userInstructions?: string, productName?: string, options?: AnthropicBuilderOptions): Builder;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/builders/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAA0B,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG9E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD;;GAEG;AACH,wBAAgB,aAAa,CACzB,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,cAAc,EACxB,gBAAgB,CAAC,EAAE,MAAM,EACzB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,uBAAuB,GAClC,OAAO,CAWT"}

package/dist/builders/index.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBuilder = exports.parseBuilderResponse = exports.createFireworksAIBuilder = exports.createOpenAIBuilder = exports.createAnthropicBuilder = void 0;
+const anthropic_1 = require("./anthropic");
+const openai_1 = require("./openai");
+const fireworksai_1 = require("./fireworksai");
+var anthropic_2 = require("./anthropic");
+Object.defineProperty(exports, "createAnthropicBuilder", { enumerable: true, get: function () { return anthropic_2.createAnthropicBuilder; } });
+var openai_2 = require("./openai");
+Object.defineProperty(exports, "createOpenAIBuilder", { enumerable: true, get: function () { return openai_2.createOpenAIBuilder; } });
+var fireworksai_2 = require("./fireworksai");
+Object.defineProperty(exports, "createFireworksAIBuilder", { enumerable: true, get: function () { return fireworksai_2.createFireworksAIBuilder; } });
+var anthropic_3 = require("./anthropic");
+Object.defineProperty(exports, "parseBuilderResponse", { enumerable: true, get: function () { return anthropic_3.parseBuilderResponse; } });
+/**
+ * Factory that creates a provider-specific builder.
+ */
+function createBuilder(provider, complete, userInstructions, productName, options) {
+    switch (provider) {
+        case 'Anthropic':
+            return (0, anthropic_1.createAnthropicBuilder)(complete, userInstructions, productName, options);
+        case 'OpenAI':
+            return (0, openai_1.createOpenAIBuilder)(complete, userInstructions, productName);
+        case 'FireworksAI':
+            return (0, fireworksai_1.createFireworksAIBuilder)(complete, userInstructions, productName);
+        default:
+            throw new Error(`Unknown provider: ${provider}`);
+    }
+}
+exports.createBuilder = createBuilder;
+//# sourceMappingURL=index.js.map

package/dist/builders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/builders/index.ts"],"names":[],"mappings":";;;AACA,2CAA8E;AAC9E,qCAA+C;AAC/C,+CAAyD;AAIzD,yCAA8E;AAArE,mHAAA,sBAAsB,OAAA;AAC/B,mCAA+C;AAAtC,6GAAA,mBAAmB,OAAA;AAC5B,6CAAyD;AAAhD,uHAAA,wBAAwB,OAAA;AACjC,yCAAmD;AAA1C,iHAAA,oBAAoB,OAAA;AAE7B;;GAEG;AACH,SAAgB,aAAa,CACzB,QAAsB,EACtB,QAAwB,EACxB,gBAAyB,EACzB,WAAoB,EACpB,OAAiC;IAEjC,QAAQ,QAAQ,EAAE;QACd,KAAK,WAAW;YACZ,OAAO,IAAA,kCAAsB,EAAC,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QACpF,KAAK,QAAQ;YACT,OAAO,IAAA,4BAAmB,EAAC,QAAQ,EAAE,gBAAgB,EAAE,WAAW,CAAC,CAAC;QACxE,KAAK,aAAa;YACd,OAAO,IAAA,sCAAwB,EAAC,QAAQ,EAAE,gBAAgB,EAAE,WAAW,CAAC,CAAC;QAC7E;YACI,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;KACxD;AACL,CAAC;AAjBD,sCAiBC"}

package/dist/builders/openai.d.ts

@@ -0,0 +1,8 @@
+import { completePrompt } from '../models';
+import { Builder } from './types';
+/**
+ * Create an OpenAI-tuned builder.
+ * Uses OpenAI structured outputs (json_schema) for reliable JSON responses.
+ */
+export declare function createOpenAIBuilder(complete: completePrompt, userInstructions?: string, productName?: string): Builder;
+//# sourceMappingURL=openai.d.ts.map

package/dist/builders/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/builders/openai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAgB,MAAM,WAAW,CAAC;AAGzD,OAAO,EAAE,OAAO,EAA2C,MAAM,SAAS,CAAC;AAE3E;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CA8DtH"}

package/dist/builders/openai.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOpenAIBuilder = void 0;
+const transformPage_1 = require("../service/transformPage");
+const anthropic_1 = require("./anthropic");
+const types_1 = require("./types");
+/**
+ * Create an OpenAI-tuned builder.
+ * Uses OpenAI structured outputs (json_schema) for reliable JSON responses.
+ */
+function createOpenAIBuilder(complete, userInstructions, productName) {
+    const name = productName ?? 'SynthOS';
+    return {
+        async run(currentPage, additionalSections, userMessage, newBuild, attachments) {
+            try {
+                // -- System message --
+                const systemParts = [
+                    `${currentPage.title}\n${currentPage.content}`,
+                ];
+                for (const section of additionalSections) {
+                    if (section.content) {
+                        systemParts.push(`${section.title}\n${section.content}`);
+                    }
+                }
+                const systemContent = systemParts.join('\n\n');
+                // -- User message --
+                const instructionParts = [];
+                if (userInstructions?.trim()) {
+                    instructionParts.push(userInstructions);
+                }
+                for (const section of additionalSections) {
+                    if (section.instructions?.trim()) {
+                        instructionParts.push(section.instructions);
+                    }
+                }
+                instructionParts.push((0, transformPage_1.getTransformInstr)(name));
+                const instructions = instructionParts.filter(s => s.trim() !== '').join('\n');
+                const promptText = `<USER_MESSAGE>\n${userMessage}\n\n<INSTRUCTIONS>\n${instructions}`;
+                // Build prompt content — multimodal when image attachments are present
+                const imageAttachments = (attachments ?? []).filter(a => a.mediaType.startsWith('image/'));
+                let promptContent;
+                if (imageAttachments.length > 0) {
+                    const blocks = [{ type: 'text', text: promptText }];
+                    for (const att of imageAttachments) {
+                        blocks.push({ type: 'image', mediaType: att.mediaType, data: att.data });
+                    }
+                    promptContent = blocks;
+                }
+                else {
+                    promptContent = promptText;
+                }
+                const result = await complete({
+                    system: { role: 'system', content: systemContent },
+                    prompt: { role: 'user', content: promptContent },
+                    jsonSchema: types_1.OPENAI_CHANGE_OPS_SCHEMA,
+                });
+                if (!result.completed) {
+                    return { kind: 'error', error: result.error ?? new Error('Model call failed') };
+                }
+                // Unwrap the { changes: [...] } envelope from structured output
+                return parseOpenAIResponse(result.value);
+            }
+            catch (err) {
+                return { kind: 'error', error: err instanceof Error ? err : new Error(String(err)) };
+            }
+        }
+    };
+}
+exports.createOpenAIBuilder = createOpenAIBuilder;
+/**
+ * Parse the OpenAI structured output response.
+ * The schema wraps the array in { changes: [...] }, so unwrap before
+ * delegating to the shared parser.
+ */
+function parseOpenAIResponse(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed) && Array.isArray(parsed.changes)) {
+            return { kind: 'transforms', changes: parsed.changes };
+        }
+    }
+    catch {
+        // fall through to shared parser
+    }
+    return (0, anthropic_1.parseBuilderResponse)(raw);
+}
+//# sourceMappingURL=openai.js.map

package/dist/builders/openai.js.map

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

package/dist/builders/types.d.ts

@@ -0,0 +1,54 @@
+import { ChangeList } from '../service/transformPage';
+/**
+ * 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.
+ */
+export declare const CHANGE_OPS_FORMAT_INSTRUCTION = "Return a JSON array of change operations to apply to the page. Do NOT return the full HTML page.\n\nEach operation must be one of:\n{ \"op\": \"update\", \"nodeId\": \"<data-node-id>\", \"html\": \"<new innerHTML>\" }\n  \u2014 replaces the innerHTML of the target element\n\n{ \"op\": \"replace\", \"nodeId\": \"<data-node-id>\", \"html\": \"<new outerHTML>\" }\n  \u2014 replaces the entire element (outerHTML) with new markup\n\n{ \"op\": \"delete\", \"nodeId\": \"<data-node-id>\" }\n  \u2014 removes the element from the page\n\n{ \"op\": \"insert\", \"parentId\": \"<data-node-id>\", \"position\": \"prepend\"|\"append\"|\"before\"|\"after\", \"html\": \"<new element HTML>\" }\n  \u2014 inserts new HTML relative to the parent element\n\n{ \"op\": \"style-element\", \"nodeId\": \"<data-node-id>\", \"style\": \"<css style string>\" }\n  \u2014 sets the style attribute of the target element (must be unlocked)\n\n{ \"op\": \"search-replace\", \"nodeId\": \"<data-node-id>\", \"search\": \"<exact text to find>\", \"replace\": \"<replacement text>\" }\n  \u2014 finds exact text within a script/style block and replaces it. Use empty string for replace to delete.\n\n{ \"op\": \"search-insert\", \"nodeId\": \"<data-node-id>\", \"after\": \"<exact text to find>\", \"content\": \"<new lines to insert>\" }\n  \u2014 inserts new content immediately after the matched text in a script/style block.\n\nFor partial edits to large scripts/styles, use search-replace or search-insert instead of\nreplacing the entire block with update.\nCopy the search/after text exactly as it appears in the source.\nWhen making multiple edits to the same block, ensure each search string targets distinct text.\nTo delete code, use search-replace with an empty replace string.\n\nReturn ONLY the JSON array. Example:\n[\n  { \"op\": \"update\", \"nodeId\": \"5\", \"html\": \"<p>Hello world</p>\" },\n  { \"op\": \"insert\", \"parentId\": \"3\", \"position\": \"append\", \"html\": \"<div class=\\\"msg\\\">New message</div>\" }\n]";
+/**
+ * JSON schema matching the ChangeOp union type for Anthropic structured outputs.
+ * The top-level schema is an array of change operations.
+ */
+export declare const CHANGE_OPS_SCHEMA: Record<string, unknown>;
+/**
+ * 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.
+ */
+export declare const CHANGE_OPS_SCHEMA_NO_RANGED: Record<string, unknown>;
+/**
+ * Text instruction variant for no-ranged-writes mode.
+ * Tells the model to use `update` for full innerHTML replacement instead of partial edits.
+ */
+export declare const 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: [...] }.
+ */
+export declare const OPENAI_CHANGE_OPS_SCHEMA: Record<string, unknown>;
+export interface ContextSection {
+    /** Section title, e.g. "<CURRENT_PAGE>", "<SERVER_SCRIPTS>" */
+    title: string;
+    /** The text body of this section */
+    content: string;
+    /** How the model should work with this section (appended to instructions) */
+    instructions: string;
+}
+export type BuilderResult = {
+    kind: 'transforms';
+    changes: ChangeList;
+} | {
+    kind: 'reply';
+    text: string;
+} | {
+    kind: 'error';
+    error: Error;
+};
+export interface Attachment {
+    mediaType: string;
+    data: string;
+    name?: string;
+}
+export interface Builder {
+    run(currentPage: ContextSection, additionalSections: ContextSection[], userMessage: string, newBuild: boolean, attachments?: Attachment[]): Promise<BuilderResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/builders/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/builders/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAMtD;;;GAGG;AACH,eAAO,MAAM,6BAA6B,u+DAkCxC,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CA8ErD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAwD/D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uCAAuC,qKAAiK,CAAC;AAEtN;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAO5D,CAAC;AAMF,MAAM,WAAW,cAAc;IAC3B,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;CACxB;AAMD,MAAM,MAAM,aAAa,GACnB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAMtC,MAAM,WAAW,UAAU;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD,MAAM,WAAW,OAAO;IACpB,GAAG,CACC,WAAW,EAAE,cAAc,EAC3B,kBAAkB,EAAE,cAAc,EAAE,EACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,OAAO,EACjB,WAAW,CAAC,EAAE,UAAU,EAAE,GAC3B,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7B"}