netra-artifacts 0.1.0-alpha.0

package/dist/server/config.js

@@ -0,0 +1,68 @@
+import { DEFAULT_SNAPSHOT_INTERVAL_MS } from "../constants/defaults.js";
+import { MARKDOWN_SYSTEM_PROMPT } from "../prompts/markdownPrompt.js";
+import { buildHtmlArtifactPrompt } from "../prompts/htmlArtifactPrompt.js";
+/** Fill in defaults and precompute the prompts for a request. */
+export 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 ??
+        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 ?? 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 ?? DEFAULT_SNAPSHOT_INTERVAL_MS,
+        abortSignal: options.abortSignal,
+    };
+}
+/** Extract the latest user message text for classification. */
+export 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/server/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/server/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAO3E,iEAAiE;AACjE,MAAM,UAAU,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,uBAAuB,CAAC;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,sBAAsB;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,4BAA4B;QAC5D,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,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/server/createArtifactStreamResponse.d.ts

@@ -0,0 +1,9 @@
+import type { CreateArtifactStreamResponseOptions } from "../types/server.js";
+/**
+ * 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).
+ */
+export declare function createArtifactStreamResponse(options: CreateArtifactStreamResponseOptions): Response;
+//# sourceMappingURL=createArtifactStreamResponse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createArtifactStreamResponse.d.ts","sourceRoot":"","sources":["../../src/server/createArtifactStreamResponse.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,mCAAmC,EAEpC,MAAM,oBAAoB,CAAC;AAQ5B;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mCAAmC,GAC3C,QAAQ,CA2BV"}

package/dist/server/createArtifactStreamResponse.js

@@ -0,0 +1,104 @@
+import { classifyMode } from "../classifier/classifyMode.js";
+import { classifyByRules } from "../classifier/rules.js";
+import { CircuitBreaker } from "../circuit-breaker/circuitBreaker.js";
+import { event } from "../stream/events.js";
+import { latestUserText, resolveServerConfig } from "./config.js";
+import { createSseResponse } from "./createSseResponse.js";
+import { streamHtmlArtifact } from "./createHtmlArtifactStream.js";
+import { streamMarkdown } from "./createMarkdownStream.js";
+import { buildHtmlArtifactPrompt } from "../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({ 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).
+ */
+export function createArtifactStreamResponse(options) {
+    const config = resolveServerConfig(options);
+    const producer = async (emit) => {
+        const mode = await resolveMode(config.mode, config);
+        emit(event.mode(mode));
+        if (mode === "markdown") {
+            await streamMarkdown(config, emit);
+            emit(event.done());
+            return;
+        }
+        try {
+            await 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(event.error(`Artifact generation failed: ${message}`, true));
+        }
+        emit(event.done());
+    };
+    return 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 = latestUserText(config.messages);
+    const classification = config.classify
+        ? await config.classify({
+            query,
+            messages: config.messages,
+            abortSignal: config.abortSignal,
+        })
+        : await 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" && 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: 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/server/createArtifactStreamResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createArtifactStreamResponse.js","sourceRoot":"","sources":["../../src/server/createArtifactStreamResponse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAQ3E,+EAA+E;AAC/E,0EAA0E;AAC1E,MAAM,WAAW,GAAG,IAAI,cAAc,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,CAAC,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,OAA4C;IAE5C,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAA2B,KAAK,EAAE,IAAU,EAAE,EAAE;QAC5D,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAEvB,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACxB,MAAM,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,kBAAkB,CAAC,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;YACvE,WAAW,CAAC,aAAa,EAAE,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,aAAa,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,qEAAqE;YACrE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,+BAA+B,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACrB,CAAC,CAAC;IAEF,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,SAAsD,EACtD,MAA4B;IAE5B,IAAI,SAAS,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAChD,IAAI,SAAS,KAAK,UAAU,IAAI,SAAS,KAAK,eAAe,EAAE,CAAC;QAC9D,gEAAgE;QAChE,OAAO,WAAW,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;IAC9D,CAAC;IACD,IAAI,SAAS,KAAK,eAAe,EAAE,CAAC;QAClC,OAAO,WAAW,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC;IACnE,CAAC;IAED,OAAO;IACP,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ;QACpC,CAAC,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC;YACpB,KAAK;YACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC;QACJ,CAAC,CAAC,MAAM,YAAY,CAAC;YACjB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,KAAK;YACL,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC,CAAC;IACP,IAAI,IAAI,GAAG,aAAa,CACtB,OAAO,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAC1E,CAAC;IAEF,wEAAwE;IACxE,8EAA8E;IAC9E,2EAA2E;IAC3E,0EAA0E;IAC1E,IAAI,IAAI,KAAK,UAAU,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QAC3E,IAAI,GAAG,eAAe,CAAC;IACzB,CAAC;IAED,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,EAAE,CAAC;QACrF,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CAAC,IAAoC;IACzD,OAAO,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;AACtD,CAAC;AAED,SAAS,wBAAwB,CAC/B,MAA4B,EAC5B,IAAkB;IAElB,MAAM,YAAY,GAChB,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;IACjD,MAAM,QAAQ,GAAG,YAAY,KAAK,UAAU,CAAC;IAE7C,IAAI,MAAM,CAAC,wBAAwB,EAAE,CAAC;QACpC,OAAO,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,CAAC;IACrC,CAAC;IAED,OAAO;QACL,GAAG,MAAM;QACT,gBAAgB,EAAE,uBAAuB,CAAC;YACxC,uEAAuE;YACvE,qEAAqE;YACrE,kEAAkE;YAClE,mDAAmD;YACnD,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;YACxD,kBAAkB,EAAE,MAAM,CAAC,QAAQ,CAAC,kBAAkB;YACtD,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU;YACtC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YAC1C,YAAY;SACb,CAAC;QACF,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/server/createHtmlArtifactStream.d.ts

@@ -0,0 +1,30 @@
+import { type Emit } from "../core/lifecycle.js";
+import type { ResolvedServerConfig } from "../types/server.js";
+export interface HtmlArtifactStreamResult {
+    messageId: string;
+    artifactId: string | null;
+    finalHtml: string;
+}
+export interface HtmlArtifactTextStreamOptions {
+    /** Raw model text chunks, already prompted to emit the Netra envelope. */
+    textStream: AsyncIterable<string>;
+    /** Sanitizer config used for snapshots and final HTML. */
+    sanitize: ResolvedServerConfig["sanitize"];
+    /** Snapshot cadence in milliseconds. Use 0 for every renderable delta. */
+    snapshotIntervalMs?: number;
+}
+/**
+ * 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.
+ */
+export declare function streamHtmlArtifact(config: ResolvedServerConfig, emit: Emit): Promise<HtmlArtifactStreamResult>;
+/**
+ * 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.
+ */
+export declare function streamHtmlArtifactFromTextStream(options: HtmlArtifactTextStreamOptions, emit: Emit): Promise<HtmlArtifactStreamResult>;
+//# sourceMappingURL=createHtmlArtifactStream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createHtmlArtifactStream.d.ts","sourceRoot":"","sources":["../../src/server/createHtmlArtifactStream.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,IAAI,EACV,MAAM,sBAAsB,CAAC;AAK9B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAM/D,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,6BAA6B;IAC5C,0EAA0E;IAC1E,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,0DAA0D;IAC1D,QAAQ,EAAE,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAC3C,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,wBAAwB,CAAC,CAgBnC;AAED;;;;;GAKG;AACH,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,6BAA6B,EACtC,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,wBAAwB,CAAC,CAmFnC"}

package/dist/server/createHtmlArtifactStream.js

@@ -0,0 +1,115 @@
+import { ArtifactLifecycle, MessageLifecycle, } from "../core/lifecycle.js";
+import { StreamingEnvelopeParser } from "../artifacts/artifactEnvelope.js";
+import { parseArtifactEnvelope } from "../artifacts/artifactEnvelope.js";
+import { ArtifactBuffer } from "../stream/buffering.js";
+import { sanitizeHtml } from "../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.
+ */
+export 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.
+ */
+export async function streamHtmlArtifactFromTextStream(options, emit) {
+    const message = new MessageLifecycle(emit);
+    const artifact = new ArtifactLifecycle(emit);
+    const parser = new StreamingEnvelopeParser();
+    const buffer = new 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 } = 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 = 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 } = sanitizeHtml(finalSource, options.sanitize);
+    artifact.done(finalHtml);
+    return {
+        messageId: message.id,
+        artifactId: artifact.id,
+        finalHtml,
+    };
+}
+//# sourceMappingURL=createHtmlArtifactStream.js.map

package/dist/server/createHtmlArtifactStream.js.map

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

package/dist/server/createMarkdownStream.d.ts

@@ -0,0 +1,13 @@
+import { type Emit } from "../core/lifecycle.js";
+import type { ResolvedServerConfig } from "../types/server.js";
+/**
+ * Stream a plain markdown answer, emitting `message_start` / `message_delta` /
+ * `message_done`. Returns the full assistant text.
+ */
+export declare function streamMarkdown(config: ResolvedServerConfig, emit: Emit, messageId?: string): Promise<string>;
+export interface MarkdownTextStreamOptions {
+    textStream: AsyncIterable<string>;
+}
+/** Provider-agnostic markdown streamer for any source of text chunks. */
+export declare function streamMarkdownFromTextStream(options: MarkdownTextStreamOptions, emit: Emit, messageId?: string): Promise<string>;
+//# sourceMappingURL=createMarkdownStream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createMarkdownStream.d.ts","sourceRoot":"","sources":["../../src/server/createMarkdownStream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAM/D;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,IAAI,EACV,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CASjB;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,yEAAyE;AACzE,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,yBAAyB,EAClC,IAAI,EAAE,IAAI,EACV,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CASjB"}

package/dist/server/createMarkdownStream.js

@@ -0,0 +1,27 @@
+import { MessageLifecycle } from "../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.
+ */
+export 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. */
+export async function streamMarkdownFromTextStream(options, emit, messageId) {
+    const message = new MessageLifecycle(emit, messageId);
+    message.start();
+    for await (const delta of options.textStream) {
+        message.delta(delta);
+    }
+    return message.done();
+}
+//# sourceMappingURL=createMarkdownStream.js.map

package/dist/server/createMarkdownStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMarkdownStream.js","sourceRoot":"","sources":["../../src/server/createMarkdownStream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAa,MAAM,sBAAsB,CAAC;AAGnE,SAAS,aAAa,CAAC,GAAG,KAA6B;IACrD,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,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;AACzE,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,OAAkC,EAClC,IAAU,EACV,SAAkB;IAElB,MAAM,OAAO,GAAG,IAAI,gBAAgB,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/server/createSseResponse.d.ts

@@ -0,0 +1,7 @@
+import type { ArtifactStreamProducer } from "../core/lifecycle.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.
+ */
+export declare function createSseResponse(producer: ArtifactStreamProducer, init?: ResponseInit): Response;
+//# sourceMappingURL=createSseResponse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createSseResponse.d.ts","sourceRoot":"","sources":["../../src/server/createSseResponse.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,sBAAsB,EAChC,IAAI,CAAC,EAAE,YAAY,GAClB,QAAQ,CAGV"}

package/dist/server/createSseResponse.js

@@ -0,0 +1,11 @@
+import { createArtifactStream } from "../core/createArtifactStream.js";
+import { createArtifactResponse } from "../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.
+ */
+export function createSseResponse(producer, init) {
+    const stream = createArtifactStream(producer);
+    return createArtifactResponse(stream, init);
+}
+//# sourceMappingURL=createSseResponse.js.map

package/dist/server/createSseResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSseResponse.js","sourceRoot":"","sources":["../../src/server/createSseResponse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAG3E;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAgC,EAChC,IAAmB;IAEnB,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC9C,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,12 @@
+export { createArtifactStreamResponse } from "./createArtifactStreamResponse.js";
+export { createSseResponse } from "./createSseResponse.js";
+export { streamMarkdown, streamMarkdownFromTextStream, type MarkdownTextStreamOptions, } from "./createMarkdownStream.js";
+export { streamHtmlArtifact, streamHtmlArtifactFromTextStream, type HtmlArtifactStreamResult, type HtmlArtifactTextStreamOptions, } from "./createHtmlArtifactStream.js";
+export { resolveServerConfig, latestUserText } from "./config.js";
+export { classifyMode, classifyByRules } from "../classifier/index.js";
+export { CircuitBreaker, MemoryCircuitStore, } from "../circuit-breaker/index.js";
+export { sanitizeHtml, sanitize } from "../sanitizer/index.js";
+export { parseArtifactEnvelope, StreamingEnvelopeParser, } from "../artifacts/artifactEnvelope.js";
+export { buildHtmlArtifactPrompt, HTML_ARTIFACT_SYSTEM_PROMPT, MARKDOWN_SYSTEM_PROMPT, } from "../prompts/index.js";
+export type * from "../types/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,cAAc,EACd,4BAA4B,EAC5B,KAAK,yBAAyB,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,kBAAkB,EAClB,gCAAgC,EAChC,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,GACnC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EACL,cAAc,EACd,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAE7B,mBAAmB,mBAAmB,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,12 @@
+export { createArtifactStreamResponse } from "./createArtifactStreamResponse.js";
+export { createSseResponse } from "./createSseResponse.js";
+export { streamMarkdown, streamMarkdownFromTextStream, } from "./createMarkdownStream.js";
+export { streamHtmlArtifact, streamHtmlArtifactFromTextStream, } from "./createHtmlArtifactStream.js";
+export { resolveServerConfig, latestUserText } from "./config.js";
+// Re-export the pieces a server integrator commonly needs.
+export { classifyMode, classifyByRules } from "../classifier/index.js";
+export { CircuitBreaker, MemoryCircuitStore, } from "../circuit-breaker/index.js";
+export { sanitizeHtml, sanitize } from "../sanitizer/index.js";
+export { parseArtifactEnvelope, StreamingEnvelopeParser, } from "../artifacts/artifactEnvelope.js";
+export { buildHtmlArtifactPrompt, HTML_ARTIFACT_SYSTEM_PROMPT, MARKDOWN_SYSTEM_PROMPT, } from "../prompts/index.js";
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,cAAc,EACd,4BAA4B,GAE7B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,kBAAkB,EAClB,gCAAgC,GAGjC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElE,2DAA2D;AAC3D,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EACL,cAAc,EACd,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,qBAAqB,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+export * from "./server/index.js";
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC"}

package/dist/server.js

@@ -0,0 +1,3 @@
+// Convenience top-level entry mirroring the `./server` subpath export.
+export * from "./server/index.js";
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,cAAc,mBAAmB,CAAC"}

package/dist/stream/assembleDocument.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Stateless one-shot wrapper over {@link PredictiveHtmlParser}. Given the full
+ * partial HTML received so far, it returns an always-valid, renderable document
+ * by predicting the missing closing tags. Equivalent in output to feeding the
+ * same bytes incrementally — use the parser directly for true incremental
+ * streaming (carrying state across chunks).
+ *
+ * Fail-open: never throws; returns the input untouched on error.
+ */
+export interface AssembledDocument {
+    /** A document/fragment safe to drop into an iframe right now. */
+    html: string;
+    /** True once a closing `</html>` has been seen (model finished). */
+    complete: boolean;
+    /** True when there is visible body content worth rendering. */
+    renderable: boolean;
+}
+export declare function assembleStreamingHtml(partial: string): AssembledDocument;
+/**
+ * Incremental, stateful counterpart to {@link assembleStreamingHtml}. Holds one
+ * {@link PredictiveHtmlParser} across the whole stream and feeds it only the
+ * newly-arrived tail on each {@link update}, so total parse cost is O(n) over
+ * the stream instead of O(n²) (one-shot re-parses everything every frame).
+ *
+ * Pass the full accumulated raw HTML received so far on every call — the
+ * projector slices off whatever it hasn't consumed yet, so skipped/throttled
+ * frames are fine: the next call simply catches up on the larger tail. The
+ * input is expected to be append-only; if a shorter, non-prefix string arrives
+ * (a reset/new artifact) the projector re-syncs from scratch.
+ */
+export declare class StreamingHtmlProjector {
+    private parser;
+    /** Offset in the raw stream where real content begins (-1 = undecided). */
+    private start;
+    /** Chars of the content region (raw.slice(start)) already pushed. */
+    private fed;
+    private lastRaw;
+    /** Feed the full accumulated raw HTML; returns the current projection. */
+    update(raw: string): AssembledDocument;
+    reset(): void;
+}
+//# sourceMappingURL=assembleDocument.d.ts.map

package/dist/stream/assembleDocument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembleDocument.d.ts","sourceRoot":"","sources":["../../src/stream/assembleDocument.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,QAAQ,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAmBxE;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAA8B;IAC5C,2EAA2E;IAC3E,OAAO,CAAC,KAAK,CAAM;IACnB,qEAAqE;IACrE,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,OAAO,CAAM;IAErB,0EAA0E;IAC1E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB;IAoCtC,KAAK,IAAI,IAAI;CAMd"}