netra-artifacts 0.1.0-alpha.0

package/dist-cjs/prompts/markdownPrompt.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MARKDOWN_SYSTEM_PROMPT = void 0;
+const systemPrompt_js_1 = require("./systemPrompt.js");
+/** System prompt for plain markdown chat answers. */
+exports.MARKDOWN_SYSTEM_PROMPT = `${systemPrompt_js_1.BASE_SYSTEM_PROMPT}
+
+You are answering in MARKDOWN mode. Reply with a normal, well-structured markdown message:
+- Use headings, lists, and tables where they help.
+- Use fenced code blocks for code.
+- Be direct and avoid filler.
+- Do NOT emit any <assistant_message> or <html_artifact> tags in this mode — just write the markdown answer.`;
+//# sourceMappingURL=markdownPrompt.js.map

package/dist-cjs/prompts/markdownPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownPrompt.js","sourceRoot":"","sources":["../../src/prompts/markdownPrompt.ts"],"names":[],"mappings":";;;AAAA,uDAAuD;AAEvD,qDAAqD;AACxC,QAAA,sBAAsB,GAAG,GAAG,oCAAkB;;;;;;6GAMkD,CAAC"}

package/dist-cjs/prompts/systemPrompt.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BASE_SYSTEM_PROMPT = void 0;
+/** Shared preamble identifying the assistant and its two output modes. */
+exports.BASE_SYSTEM_PROMPT = `You are a helpful assistant that answers either as markdown text or as a single self-contained static HTML/CSS artifact. You never mix the two: a response is entirely one mode. You write clearly, accurately, and concisely.`;
+//# sourceMappingURL=systemPrompt.js.map

package/dist-cjs/prompts/systemPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemPrompt.js","sourceRoot":"","sources":["../../src/prompts/systemPrompt.ts"],"names":[],"mappings":";;;AAAA,0EAA0E;AAC7D,QAAA,kBAAkB,GAAG,gOAAgO,CAAC"}

package/dist-cjs/sanitizer/dangerousPatterns.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * Regex building blocks for the static-HTML sanitizer. These are deliberately
+ * conservative: the sanitizer's job is to guarantee that no JavaScript can run
+ * inside the artifact iframe, regardless of how creative the model gets.
+ *
+ * The sanitizer is regex-based on purpose: it must run identically on the
+ * server (Node) and the client (browser) with zero DOM dependency.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FORM_TAGS = exports.SVG_BLOCK = exports.INLINE_STYLE_ATTR = exports.STYLE_BLOCK = exports.CSS_IMPORT = exports.EXTERNAL_LINK = exports.STYLESHEET_LINK = exports.CSS_EXPRESSION = exports.DANGEROUS_URL_ATTR = exports.EVENT_HANDLER_ATTR = exports.META_REFRESH = exports.EMBED_OPEN = exports.EMBED_BLOCK = exports.SCRIPT_OPEN = exports.SCRIPT_BLOCK = void 0;
+/** `<script>...</script>`, including attributes and across newlines. */
+exports.SCRIPT_BLOCK = /<script\b[^>]*>[\s\S]*?<\/script\s*>/gi;
+/** A dangling/self-closed `<script ...>` with no closing tag. */
+exports.SCRIPT_OPEN = /<script\b[^>]*\/?>/gi;
+/** `<iframe>`, `<object>`, `<embed>`, `<base>`, `<frame>`, `<frameset>`. */
+exports.EMBED_BLOCK = /<(iframe|object|embed|frame|frameset)\b[^>]*>[\s\S]*?<\/\1\s*>/gi;
+exports.EMBED_OPEN = /<(iframe|object|embed|frame|frameset|base)\b[^>]*\/?>/gi;
+/** `<meta http-equiv="refresh" ...>` — used for redirect/navigation tricks. */
+exports.META_REFRESH = /<meta\b[^>]*http-equiv\s*=\s*["']?refresh["']?[^>]*>/gi;
+/**
+ * Inline event-handler attributes (`onclick`, `onload`, `onerror`, ...).
+ * Matches quoted, single-quoted, and unquoted values.
+ */
+exports.EVENT_HANDLER_ATTR = /\s+on[a-z]+\s*=\s*(?:"[^"]*"|'[^']*'|[^\s>]+)/gi;
+/** `javascript:` / `vbscript:` / `data:text/html` protocol URLs in attributes. */
+exports.DANGEROUS_URL_ATTR = /\s+(href|src|action|formaction|xlink:href|background|poster)\s*=\s*(?:"\s*(?:javascript|vbscript|data:text\/html)[^"]*"|'\s*(?:javascript|vbscript|data:text\/html)[^']*'|\s*(?:javascript|vbscript):[^\s>]*)/gi;
+/** `style="...:expression(...)..."` — legacy IE script-in-CSS vector. */
+exports.CSS_EXPRESSION = /expression\s*\(/gi;
+/** External stylesheet links: `<link rel="stylesheet" ...>`. */
+exports.STYLESHEET_LINK = /<link\b[^>]*rel\s*=\s*["']?stylesheet["']?[^>]*>/gi;
+/** Any `<link>` pointing at an http(s) resource (fonts, preconnect, etc.). */
+exports.EXTERNAL_LINK = /<link\b[^>]*>/gi;
+/** `@import url(...)` inside CSS. */
+exports.CSS_IMPORT = /@import\b[^;]+;?/gi;
+/** `<style>...</style>` blocks. */
+exports.STYLE_BLOCK = /<style\b[^>]*>[\s\S]*?<\/style\s*>/gi;
+/** Inline `style="..."` attributes. */
+exports.INLINE_STYLE_ATTR = /\s+style\s*=\s*(?:"[^"]*"|'[^']*')/gi;
+/** `<svg>...</svg>` blocks. */
+exports.SVG_BLOCK = /<svg\b[^>]*>[\s\S]*?<\/svg\s*>/gi;
+/** Form-related tags (open + close), used when forms are disallowed. */
+exports.FORM_TAGS = /<\/?(form|input|button|label|textarea|select|option|fieldset|legend|datalist|output)\b[^>]*>/gi;
+//# sourceMappingURL=dangerousPatterns.js.map

package/dist-cjs/sanitizer/dangerousPatterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dangerousPatterns.js","sourceRoot":"","sources":["../../src/sanitizer/dangerousPatterns.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,wEAAwE;AAC3D,QAAA,YAAY,GAAG,wCAAwC,CAAC;AACrE,iEAAiE;AACpD,QAAA,WAAW,GAAG,sBAAsB,CAAC;AAElD,4EAA4E;AAC/D,QAAA,WAAW,GACtB,kEAAkE,CAAC;AACxD,QAAA,UAAU,GACrB,yDAAyD,CAAC;AAE5D,+EAA+E;AAClE,QAAA,YAAY,GAAG,wDAAwD,CAAC;AAErF;;;GAGG;AACU,QAAA,kBAAkB,GAC7B,iDAAiD,CAAC;AAEpD,kFAAkF;AACrE,QAAA,kBAAkB,GAC7B,iNAAiN,CAAC;AAEpN,yEAAyE;AAC5D,QAAA,cAAc,GAAG,mBAAmB,CAAC;AAElD,gEAAgE;AACnD,QAAA,eAAe,GAC1B,oDAAoD,CAAC;AACvD,8EAA8E;AACjE,QAAA,aAAa,GAAG,iBAAiB,CAAC;AAE/C,qCAAqC;AACxB,QAAA,UAAU,GAAG,oBAAoB,CAAC;AAE/C,mCAAmC;AACtB,QAAA,WAAW,GAAG,sCAAsC,CAAC;AAElE,uCAAuC;AAC1B,QAAA,iBAAiB,GAAG,sCAAsC,CAAC;AAExE,+BAA+B;AAClB,QAAA,SAAS,GAAG,kCAAkC,CAAC;AAE5D,wEAAwE;AAC3D,QAAA,SAAS,GACpB,gGAAgG,CAAC"}

package/dist-cjs/sanitizer/index.js

@@ -0,0 +1,43 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dangerousPatterns = void 0;
+__exportStar(require("./sanitizeHtml.js"), exports);
+__exportStar(require("./sanitizeConfig.js"), exports);
+exports.dangerousPatterns = __importStar(require("./dangerousPatterns.js"));
+//# sourceMappingURL=index.js.map

package/dist-cjs/sanitizer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sanitizer/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,sDAAoC;AACpC,4EAA4D"}

package/dist-cjs/sanitizer/sanitizeConfig.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSanitizeOptions = resolveSanitizeOptions;
+const defaults_js_1 = require("../constants/defaults.js");
+const mergeConfig_js_1 = require("../utils/mergeConfig.js");
+/** Resolve partial sanitize options against the static-safe defaults. */
+function resolveSanitizeOptions(options) {
+    const merged = (0, mergeConfig_js_1.mergeConfig)(defaults_js_1.DEFAULT_SANITIZE_OPTIONS, options);
+    // Scripts are never allowed, no matter what a caller passes.
+    merged.allowScripts = false;
+    return merged;
+}
+//# sourceMappingURL=sanitizeConfig.js.map

package/dist-cjs/sanitizer/sanitizeConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizeConfig.js","sourceRoot":"","sources":["../../src/sanitizer/sanitizeConfig.ts"],"names":[],"mappings":";;AAKA,wDAOC;AAZD,0DAAoE;AACpE,4DAAsD;AAGtD,yEAAyE;AACzE,SAAgB,sBAAsB,CACpC,OAAyB;IAEzB,MAAM,MAAM,GAAG,IAAA,4BAAW,EAAC,sCAAwB,EAAE,OAAO,CAAC,CAAC;IAC9D,6DAA6D;IAC7D,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist-cjs/sanitizer/sanitizeHtml.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeHtml = sanitizeHtml;
+exports.sanitize = sanitize;
+exports.escapeHtml = escapeHtml;
+const sanitizeConfig_js_1 = require("./sanitizeConfig.js");
+const dangerousPatterns_js_1 = require("./dangerousPatterns.js");
+// A <link> is kept under allowExternalFonts only if its href starts with a
+// Google Fonts host (covers stylesheet links and preconnect hints).
+const ALLOWED_FONT_LINK = /href\s*=\s*["']https:\/\/fonts\.(googleapis|gstatic)\.com/i;
+// An @import is kept only if it targets the Google Fonts CSS host.
+const ALLOWED_FONT_IMPORT = /@import\s+(?:url\()?\s*["']?https:\/\/fonts\.googleapis\.com/i;
+/**
+ * Strip everything that could execute or load JavaScript from an HTML string,
+ * keeping static markup, CSS, SVG, and forms according to `options`.
+ *
+ * Fail-open: if anything throws, we return the input HTML-escaped inside a
+ * `<pre>` so the iframe shows inert text rather than crashing the render.
+ */
+function sanitizeHtml(input, options) {
+    const opts = (0, sanitizeConfig_js_1.resolveSanitizeOptions)(options);
+    try {
+        if (typeof input !== "string") {
+            return { html: "", modified: false, failedOpen: false };
+        }
+        let html = input;
+        const before = html;
+        // 1. Scripts — always removed.
+        html = html.replace(dangerousPatterns_js_1.SCRIPT_BLOCK, "").replace(dangerousPatterns_js_1.SCRIPT_OPEN, "");
+        // 2. Nested browsing contexts & navigation tricks — always removed.
+        html = html
+            .replace(dangerousPatterns_js_1.EMBED_BLOCK, "")
+            .replace(dangerousPatterns_js_1.EMBED_OPEN, "")
+            .replace(dangerousPatterns_js_1.META_REFRESH, "");
+        // 3. Inline event handlers — always removed.
+        html = html.replace(dangerousPatterns_js_1.EVENT_HANDLER_ATTR, "");
+        // 4. javascript:/vbscript:/data:text/html URLs — always removed.
+        html = html.replace(dangerousPatterns_js_1.DANGEROUS_URL_ATTR, "");
+        // 5. CSS expression() — always removed.
+        html = html.replace(dangerousPatterns_js_1.CSS_EXPRESSION, "void(");
+        // 6. External CSS / fonts.
+        if (opts.allowExternalFonts) {
+            // Keep ONLY links/imports pointing at the Google Fonts hosts; strip the
+            // rest. This permits distinctive typography without opening a hole for
+            // arbitrary external stylesheets.
+            html = html
+                .replace(dangerousPatterns_js_1.EXTERNAL_LINK, (tag) => ALLOWED_FONT_LINK.test(tag) ? tag : "")
+                .replace(dangerousPatterns_js_1.CSS_IMPORT, (imp) => ALLOWED_FONT_IMPORT.test(imp) ? imp : "");
+        }
+        else {
+            html = html.replace(dangerousPatterns_js_1.STYLESHEET_LINK, "").replace(dangerousPatterns_js_1.CSS_IMPORT, "");
+            // Remove any remaining <link> (preconnect/font links) too.
+            html = html.replace(dangerousPatterns_js_1.EXTERNAL_LINK, "");
+        }
+        // 7. Optional element classes.
+        if (!opts.allowStyleTags)
+            html = html.replace(dangerousPatterns_js_1.STYLE_BLOCK, "");
+        if (!opts.allowInlineStyles)
+            html = html.replace(dangerousPatterns_js_1.INLINE_STYLE_ATTR, "");
+        if (!opts.allowSvg)
+            html = html.replace(dangerousPatterns_js_1.SVG_BLOCK, "");
+        if (!opts.allowForms)
+            html = html.replace(dangerousPatterns_js_1.FORM_TAGS, "");
+        return { html, modified: html !== before, failedOpen: false };
+    }
+    catch {
+        return {
+            html: `<pre>${escapeHtml(String(input))}</pre>`,
+            modified: true,
+            failedOpen: true,
+        };
+    }
+}
+/** Convenience wrapper returning only the sanitized string. */
+function sanitize(input, options) {
+    return sanitizeHtml(input, options).html;
+}
+function escapeHtml(input) {
+    return input
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+}
+//# sourceMappingURL=sanitizeHtml.js.map

package/dist-cjs/sanitizer/sanitizeHtml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizeHtml.js","sourceRoot":"","sources":["../../src/sanitizer/sanitizeHtml.ts"],"names":[],"mappings":";;AA2CA,oCAgEC;AAGD,4BAEC;AAED,gCAOC;AAzHD,2DAA6D;AAC7D,iEAgBgC;AAGhC,2EAA2E;AAC3E,oEAAoE;AACpE,MAAM,iBAAiB,GACrB,4DAA4D,CAAC;AAC/D,mEAAmE;AACnE,MAAM,mBAAmB,GACvB,+DAA+D,CAAC;AAUlE;;;;;;GAMG;AACH,SAAgB,YAAY,CAC1B,KAAa,EACb,OAAyB;IAEzB,MAAM,IAAI,GAAG,IAAA,0CAAsB,EAAC,OAAO,CAAC,CAAC;IAE7C,IAAI,CAAC;QACH,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC1D,CAAC;QAED,IAAI,IAAI,GAAG,KAAK,CAAC;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC;QAEpB,+BAA+B;QAC/B,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,mCAAY,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,kCAAW,EAAE,EAAE,CAAC,CAAC;QAE/D,oEAAoE;QACpE,IAAI,GAAG,IAAI;aACR,OAAO,CAAC,kCAAW,EAAE,EAAE,CAAC;aACxB,OAAO,CAAC,iCAAU,EAAE,EAAE,CAAC;aACvB,OAAO,CAAC,mCAAY,EAAE,EAAE,CAAC,CAAC;QAE7B,6CAA6C;QAC7C,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,yCAAkB,EAAE,EAAE,CAAC,CAAC;QAE5C,iEAAiE;QACjE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,yCAAkB,EAAE,EAAE,CAAC,CAAC;QAE5C,wCAAwC;QACxC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,qCAAc,EAAE,OAAO,CAAC,CAAC;QAE7C,2BAA2B;QAC3B,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,wEAAwE;YACxE,uEAAuE;YACvE,kCAAkC;YAClC,IAAI,GAAG,IAAI;iBACR,OAAO,CAAC,oCAAa,EAAE,CAAC,GAAG,EAAE,EAAE,CAC9B,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CACvC;iBACA,OAAO,CAAC,iCAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAC3B,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CACzC,CAAC;QACN,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,sCAAe,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,iCAAU,EAAE,EAAE,CAAC,CAAC;YACjE,2DAA2D;YAC3D,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,oCAAa,EAAE,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,+BAA+B;QAC/B,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,kCAAW,EAAE,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,CAAC,iBAAiB;YAAE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,wCAAiB,EAAE,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,gCAAS,EAAE,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,gCAAS,EAAE,EAAE,CAAC,CAAC;QAEzD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,KAAK,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,IAAI,EAAE,QAAQ,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ;YAC/C,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;SACjB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,SAAgB,QAAQ,CAAC,KAAa,EAAE,OAAyB;IAC/D,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;AAC3C,CAAC;AAED,SAAgB,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK;SACT,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC"}

package/dist-cjs/server/config.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveServerConfig = resolveServerConfig;
+exports.latestUserText = latestUserText;
+const defaults_js_1 = require("../constants/defaults.js");
+const markdownPrompt_js_1 = require("../prompts/markdownPrompt.js");
+const htmlArtifactPrompt_js_1 = require("../prompts/htmlArtifactPrompt.js");
+/** Fill in defaults and precompute the prompts for a request. */
+function resolveServerConfig(options) {
+    const allowForms = options.allowForms ?? true;
+    const allowInlineStyles = options.allowInlineStyles ?? true;
+    const allowStyleTags = options.allowStyleTags ?? true;
+    const allowSvg = options.allowSvg ?? true;
+    const allowExternalFonts = options.allowExternalFonts ?? false;
+    const htmlSystemPrompt = options.htmlSystemPrompt ??
+        (0, htmlArtifactPrompt_js_1.buildHtmlArtifactPrompt)({
+            styleProfile: options.styleProfile,
+            allowExternalFonts,
+            allowForms,
+            theme: options.theme,
+            presentation: options.presentation,
+        });
+    return {
+        messages: options.messages,
+        generateTextStream: options.generateTextStream,
+        mode: options.mode ?? "auto",
+        generateText: options.generateText,
+        classify: options.classify,
+        system: options.system,
+        markdownSystemPrompt: options.markdownSystemPrompt ?? markdownPrompt_js_1.MARKDOWN_SYSTEM_PROMPT,
+        htmlSystemPrompt,
+        htmlSystemPromptOverride: options.htmlSystemPrompt,
+        styleProfile: options.styleProfile,
+        theme: options.theme,
+        presentation: options.presentation,
+        sanitize: {
+            allowForms,
+            allowScripts: false,
+            allowInlineStyles,
+            allowStyleTags,
+            allowSvg,
+            allowExternalFonts,
+        },
+        temperature: options.temperature,
+        snapshotIntervalMs: options.snapshotIntervalMs ?? defaults_js_1.DEFAULT_SNAPSHOT_INTERVAL_MS,
+        abortSignal: options.abortSignal,
+    };
+}
+/** Extract the latest user message text for classification. */
+function latestUserText(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const message = messages[i];
+        if (!message || message.role !== "user")
+            continue;
+        return messageToText(message.content);
+    }
+    return "";
+}
+function messageToText(content) {
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map((part) => typeof part === "object" && part && "text" in part
+            ? String(part.text ?? "")
+            : "")
+            .join(" ")
+            .trim();
+    }
+    return "";
+}
+//# sourceMappingURL=config.js.map

package/dist-cjs/server/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/server/config.ts"],"names":[],"mappings":";;AAUA,kDA6CC;AAGD,wCAOC;AAjED,0DAAwE;AACxE,oEAAsE;AACtE,4EAA2E;AAO3E,iEAAiE;AACjE,SAAgB,mBAAmB,CACjC,OAA4C;IAE5C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;IAC9C,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,IAAI,CAAC;IAC5D,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC;IACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;IAC1C,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,KAAK,CAAC;IAE/D,MAAM,gBAAgB,GACpB,OAAO,CAAC,gBAAgB;QACxB,IAAA,+CAAuB,EAAC;YACtB,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,kBAAkB;YAClB,UAAU;YACV,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC,CAAC;IAEL,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM;QAC5B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,IAAI,0CAAsB;QAC5E,gBAAgB;QAChB,wBAAwB,EAAE,OAAO,CAAC,gBAAgB;QAClD,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,QAAQ,EAAE;YACR,UAAU;YACV,YAAY,EAAE,KAAK;YACnB,iBAAiB;YACjB,cAAc;YACd,QAAQ;YACR,kBAAkB;SACnB;QACD,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,kBAAkB,EAChB,OAAO,CAAC,kBAAkB,IAAI,0CAA4B;QAC5D,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,SAAgB,cAAc,CAAC,QAAuB;IACpD,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;YAAE,SAAS;QAClD,OAAO,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,aAAa,CAAC,OAA+B;IACpD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO;aACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACZ,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI;YAChD,CAAC,CAAC,MAAM,CAAE,IAA0B,CAAC,IAAI,IAAI,EAAE,CAAC;YAChD,CAAC,CAAC,EAAE,CACP;aACA,IAAI,CAAC,GAAG,CAAC;aACT,IAAI,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist-cjs/server/createArtifactStreamResponse.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createArtifactStreamResponse = createArtifactStreamResponse;
+const classifyMode_js_1 = require("../classifier/classifyMode.js");
+const rules_js_1 = require("../classifier/rules.js");
+const circuitBreaker_js_1 = require("../circuit-breaker/circuitBreaker.js");
+const events_js_1 = require("../stream/events.js");
+const config_js_1 = require("./config.js");
+const createSseResponse_js_1 = require("./createSseResponse.js");
+const createHtmlArtifactStream_js_1 = require("./createHtmlArtifactStream.js");
+const createMarkdownStream_js_1 = require("./createMarkdownStream.js");
+const htmlArtifactPrompt_js_1 = require("../prompts/htmlArtifactPrompt.js");
+// Shared breaker (process-memory). Falls back to markdown when HTML generation
+// keeps failing, so a broken model/prompt doesn't repeatedly burn tokens.
+const htmlBreaker = new circuitBreaker_js_1.CircuitBreaker({ key: "html_artifact" });
+/**
+ * The package's primary server entry point. Classifies the request (unless a
+ * mode is forced), emits a `mode` event, then streams the appropriate response
+ * as Server-Sent Events. Returns a `Response` ready to return from a Next.js
+ * route handler (or any Web-standard handler).
+ */
+function createArtifactStreamResponse(options) {
+    const config = (0, config_js_1.resolveServerConfig)(options);
+    const producer = async (emit) => {
+        const mode = await resolveMode(config.mode, config);
+        emit(events_js_1.event.mode(mode));
+        if (mode === "markdown") {
+            await (0, createMarkdownStream_js_1.streamMarkdown)(config, emit);
+            emit(events_js_1.event.done());
+            return;
+        }
+        try {
+            await (0, createHtmlArtifactStream_js_1.streamHtmlArtifact)(resolveHtmlConfigForMode(config, mode), emit);
+            htmlBreaker.recordSuccess();
+        }
+        catch (err) {
+            htmlBreaker.recordFailure();
+            const message = err instanceof Error ? err.message : String(err);
+            // Recoverable: the client keeps the last valid snapshot it received.
+            emit(events_js_1.event.error(`Artifact generation failed: ${message}`, true));
+        }
+        emit(events_js_1.event.done());
+    };
+    return (0, createSseResponse_js_1.createSseResponse)(producer);
+}
+async function resolveMode(requested, config) {
+    if (requested === "markdown")
+        return "markdown";
+    if (requested === "artifact" || requested === "html_artifact") {
+        // Honor an explicit request, but still respect an open circuit.
+        return htmlBreaker.allowRequest() ? "artifact" : "markdown";
+    }
+    if (requested === "generative_ui") {
+        return htmlBreaker.allowRequest() ? "generative_ui" : "markdown";
+    }
+    // auto
+    const query = (0, config_js_1.latestUserText)(config.messages);
+    const classification = config.classify
+        ? await config.classify({
+            query,
+            messages: config.messages,
+            abortSignal: config.abortSignal,
+        })
+        : await (0, classifyMode_js_1.classifyMode)({
+            generateText: config.generateText,
+            query,
+            abortSignal: config.abortSignal,
+        });
+    let mode = normalizeMode(typeof classification === "string" ? classification : classification.mode);
+    // Deterministic override: if the request explicitly signals an inline /
+    // camouflage / generative-UI intent, prefer that over a model "artifact" pick
+    // (the model often labels a UI showcase as a standalone document). This is
+    // what keeps "generative UI", "camouflage", "showcase", etc. transparent.
+    if (mode === "artifact" && (0, rules_js_1.classifyByRules)(query).mode === "generative_ui") {
+        mode = "generative_ui";
+    }
+    if ((mode === "artifact" || mode === "generative_ui") && !htmlBreaker.allowRequest()) {
+        return "markdown";
+    }
+    return mode;
+}
+function normalizeMode(mode) {
+    return mode === "html_artifact" ? "artifact" : mode;
+}
+function resolveHtmlConfigForMode(config, mode) {
+    const presentation = mode === "generative_ui" ? "seamless" : "card";
+    const seamless = presentation === "seamless";
+    if (config.htmlSystemPromptOverride) {
+        return { ...config, presentation };
+    }
+    return {
+        ...config,
+        htmlSystemPrompt: (0, htmlArtifactPrompt_js_1.buildHtmlArtifactPrompt)({
+            // Camouflage must match the host (theme + style profile). A standalone
+            // artifact is its OWN world: give it full creative freedom — no host
+            // theme and no imposed style profile, so it picks the best design
+            // (any palette, light/dark/vivid) per the request.
+            styleProfile: seamless ? config.styleProfile : undefined,
+            allowExternalFonts: config.sanitize.allowExternalFonts,
+            allowForms: config.sanitize.allowForms,
+            theme: seamless ? config.theme : undefined,
+            presentation,
+        }),
+        presentation,
+    };
+}
+//# sourceMappingURL=createArtifactStreamResponse.js.map

package/dist-cjs/server/createArtifactStreamResponse.js.map

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

package/dist-cjs/server/createHtmlArtifactStream.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.streamHtmlArtifact = streamHtmlArtifact;
+exports.streamHtmlArtifactFromTextStream = streamHtmlArtifactFromTextStream;
+const lifecycle_js_1 = require("../core/lifecycle.js");
+const artifactEnvelope_js_1 = require("../artifacts/artifactEnvelope.js");
+const artifactEnvelope_js_2 = require("../artifacts/artifactEnvelope.js");
+const buffering_js_1 = require("../stream/buffering.js");
+const sanitizeHtml_js_1 = require("../sanitizer/sanitizeHtml.js");
+function composeSystem(...parts) {
+    return parts.filter(Boolean).join("\n\n");
+}
+/**
+ * Generate an HTML artifact. Streams a short assistant message, then the
+ * artifact: `artifact_start`, buffered `artifact_delta`s, periodic sanitized
+ * `artifact_snapshot`s, and finally a sanitized `artifact_done` derived from an
+ * authoritative full-text parse.
+ */
+async function streamHtmlArtifact(config, emit) {
+    const textStream = await config.generateTextStream({
+        system: composeSystem(config.system, config.htmlSystemPrompt),
+        messages: config.messages,
+        temperature: config.temperature,
+        abortSignal: config.abortSignal,
+    });
+    return streamHtmlArtifactFromTextStream({
+        textStream,
+        sanitize: config.sanitize,
+        snapshotIntervalMs: config.snapshotIntervalMs,
+    }, emit);
+}
+/**
+ * Provider-agnostic artifact streamer. Use this when a framework such as
+ * LangChain gives you an `AsyncIterable<string>`. The caller is responsible
+ * for prompting the model with
+ * `HTML_ARTIFACT_SYSTEM_PROMPT` (or equivalent) before passing chunks here.
+ */
+async function streamHtmlArtifactFromTextStream(options, emit) {
+    const message = new lifecycle_js_1.MessageLifecycle(emit);
+    const artifact = new lifecycle_js_1.ArtifactLifecycle(emit);
+    const parser = new artifactEnvelope_js_1.StreamingEnvelopeParser();
+    const buffer = new buffering_js_1.ArtifactBuffer();
+    const snapshotIntervalMs = options.snapshotIntervalMs ?? 0;
+    message.start();
+    let rawText = "";
+    let artifactStarted = false;
+    let lastSnapshotAt = 0;
+    const maybeSnapshot = (force = false) => {
+        const now = Date.now();
+        if (!force && now - lastSnapshotAt < snapshotIntervalMs)
+            return;
+        const candidate = buffer.commit();
+        if (!candidate)
+            return;
+        lastSnapshotAt = now;
+        const { html } = (0, sanitizeHtml_js_1.sanitizeHtml)(candidate, options.sanitize);
+        artifact.snapshot(html);
+    };
+    for await (const chunk of options.textStream) {
+        rawText += chunk;
+        for (const ev of parser.feed(chunk)) {
+            if (ev.kind === "message") {
+                message.delta(ev.delta);
+            }
+            else if (ev.kind === "artifact_open") {
+                // The short message ends as soon as the artifact begins.
+                message.done();
+                artifact.start(ev.title);
+                artifactStarted = true;
+            }
+            else {
+                buffer.append(ev.delta);
+                artifact.delta(ev.delta);
+                maybeSnapshot();
+            }
+        }
+    }
+    // Drain any buffered tail.
+    for (const ev of parser.flush()) {
+        if (ev.kind === "message")
+            message.delta(ev.delta);
+        else if (ev.kind === "artifact_open") {
+            message.done();
+            artifact.start(ev.title);
+            artifactStarted = true;
+        }
+        else {
+            buffer.append(ev.delta);
+            artifact.delta(ev.delta);
+        }
+    }
+    // Authoritative final parse over the entire model output.
+    const parsed = (0, artifactEnvelope_js_2.parseArtifactEnvelope)(rawText);
+    const finalSource = parsed.hasArtifact ? parsed.html : buffer.raw;
+    if (!artifactStarted && !finalSource.trim()) {
+        message.done(parsed.assistantMessage || rawText.trim() || "I couldn't generate an artifact for that request.");
+        return {
+            messageId: message.id,
+            artifactId: null,
+            finalHtml: "",
+        };
+    }
+    if (!artifactStarted) {
+        // The streaming split never opened an artifact; recover from the final parse.
+        message.done(parsed.assistantMessage || undefined);
+        artifact.start(parsed.title);
+    }
+    else {
+        message.done();
+    }
+    const { html: finalHtml } = (0, sanitizeHtml_js_1.sanitizeHtml)(finalSource, options.sanitize);
+    artifact.done(finalHtml);
+    return {
+        messageId: message.id,
+        artifactId: artifact.id,
+        finalHtml,
+    };
+}
+//# sourceMappingURL=createHtmlArtifactStream.js.map

package/dist-cjs/server/createHtmlArtifactStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createHtmlArtifactStream.js","sourceRoot":"","sources":["../../src/server/createHtmlArtifactStream.ts"],"names":[],"mappings":";;AAoCA,gDAmBC;AAQD,4EAsFC;AArJD,uDAI8B;AAC9B,0EAA2E;AAC3E,0EAAyE;AACzE,yDAAwD;AACxD,kEAA4D;AAG5D,SAAS,aAAa,CAAC,GAAG,KAA6B;IACrD,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC;AAiBD;;;;;GAKG;AACI,KAAK,UAAU,kBAAkB,CACtC,MAA4B,EAC5B,IAAU;IAEV,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC;QACjD,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,gBAAgB,CAAC;QAC7D,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAC;IAEH,OAAO,gCAAgC,CACrC;QACE,UAAU;QACV,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;KAC9C,EACD,IAAI,CACL,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,gCAAgC,CACpD,OAAsC,EACtC,IAAU;IAEV,MAAM,OAAO,GAAG,IAAI,+BAAgB,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,gCAAiB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,6CAAuB,EAAE,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,6BAAc,EAAE,CAAC;IACpC,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,CAAC,CAAC;IAE3D,OAAO,CAAC,KAAK,EAAE,CAAC;IAEhB,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,IAAI,cAAc,GAAG,CAAC,CAAC;IAEvB,MAAM,aAAa,GAAG,CAAC,KAAK,GAAG,KAAK,EAAE,EAAE;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,KAAK,IAAI,GAAG,GAAG,cAAc,GAAG,kBAAkB;YAAE,OAAO;QAChE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,cAAc,GAAG,GAAG,CAAC;QACrB,MAAM,EAAE,IAAI,EAAE,GAAG,IAAA,8BAAY,EAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3D,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC;IAEF,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QAC7C,OAAO,IAAI,KAAK,CAAC;QACjB,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,IAAI,EAAE,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC1B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;iBAAM,IAAI,EAAE,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBACvC,yDAAyD;gBACzD,OAAO,CAAC,IAAI,EAAE,CAAC;gBACf,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;gBACzB,eAAe,GAAG,IAAI,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;gBACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;gBACzB,aAAa,EAAE,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;QAChC,IAAI,EAAE,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;aAC9C,IAAI,EAAE,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACrC,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;YACzB,eAAe,GAAG,IAAI,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;YACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,0DAA0D;IAC1D,MAAM,MAAM,GAAG,IAAA,2CAAqB,EAAC,OAAO,CAAC,CAAC;IAE9C,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;IAClE,IAAI,CAAC,eAAe,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,OAAO,CAAC,IAAI,EAAE,IAAI,mDAAmD,CAAC,CAAC;QAC/G,OAAO;YACL,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,EAAE;SACd,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,8EAA8E;QAC9E,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,SAAS,CAAC,CAAC;QACnD,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,EAAE,CAAC;IACjB,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,IAAA,8BAAY,EAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEzB,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,EAAE;QACrB,UAAU,EAAE,QAAQ,CAAC,EAAE;QACvB,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist-cjs/server/createMarkdownStream.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.streamMarkdown = streamMarkdown;
+exports.streamMarkdownFromTextStream = streamMarkdownFromTextStream;
+const lifecycle_js_1 = require("../core/lifecycle.js");
+function composeSystem(...parts) {
+    return parts.filter(Boolean).join("\n\n");
+}
+/**
+ * Stream a plain markdown answer, emitting `message_start` / `message_delta` /
+ * `message_done`. Returns the full assistant text.
+ */
+async function streamMarkdown(config, emit, messageId) {
+    const textStream = await config.generateTextStream({
+        system: composeSystem(config.system, config.markdownSystemPrompt),
+        messages: config.messages,
+        temperature: config.temperature,
+        abortSignal: config.abortSignal,
+    });
+    return streamMarkdownFromTextStream({ textStream }, emit, messageId);
+}
+/** Provider-agnostic markdown streamer for any source of text chunks. */
+async function streamMarkdownFromTextStream(options, emit, messageId) {
+    const message = new lifecycle_js_1.MessageLifecycle(emit, messageId);
+    message.start();
+    for await (const delta of options.textStream) {
+        message.delta(delta);
+    }
+    return message.done();
+}
+//# sourceMappingURL=createMarkdownStream.js.map

package/dist-cjs/server/createMarkdownStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMarkdownStream.js","sourceRoot":"","sources":["../../src/server/createMarkdownStream.ts"],"names":[],"mappings":";;AAWA,wCAaC;AAOD,oEAaC;AA5CD,uDAAmE;AAGnE,SAAS,aAAa,CAAC,GAAG,KAA6B;IACrD,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,cAAc,CAClC,MAA4B,EAC5B,IAAU,EACV,SAAkB;IAElB,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC;QACjD,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,CAAC;QACjE,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAC;IAEH,OAAO,4BAA4B,CAAC,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AACvE,CAAC;AAMD,yEAAyE;AAClE,KAAK,UAAU,4BAA4B,CAChD,OAAkC,EAClC,IAAU,EACV,SAAkB;IAElB,MAAM,OAAO,GAAG,IAAI,+BAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACtD,OAAO,CAAC,KAAK,EAAE,CAAC;IAEhB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QAC7C,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC"}

package/dist-cjs/server/createSseResponse.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSseResponse = createSseResponse;
+const createArtifactStream_js_1 = require("../core/createArtifactStream.js");
+const createArtifactResponse_js_1 = require("../core/createArtifactResponse.js");
+/**
+ * Compose a producer into a ready-to-return SSE `Response`. This is the bridge
+ * between the framework-agnostic core stream and a route handler's return.
+ */
+function createSseResponse(producer, init) {
+    const stream = (0, createArtifactStream_js_1.createArtifactStream)(producer);
+    return (0, createArtifactResponse_js_1.createArtifactResponse)(stream, init);
+}
+//# sourceMappingURL=createSseResponse.js.map

package/dist-cjs/server/createSseResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSseResponse.js","sourceRoot":"","sources":["../../src/server/createSseResponse.ts"],"names":[],"mappings":";;AAQA,8CAMC;AAdD,6EAAuE;AACvE,iFAA2E;AAG3E;;;GAGG;AACH,SAAgB,iBAAiB,CAC/B,QAAgC,EAChC,IAAmB;IAEnB,MAAM,MAAM,GAAG,IAAA,8CAAoB,EAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO,IAAA,kDAAsB,EAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC9C,CAAC"}