netra-artifacts 0.1.0-alpha.0

package/dist/stream/assembleDocument.js

@@ -0,0 +1,104 @@
+import { cleanArtifactHtml } from "../artifacts/artifactEnvelope.js";
+import { PredictiveHtmlParser } from "./predictiveHtmlParser.js";
+export function assembleStreamingHtml(partial) {
+    if (typeof partial !== "string") {
+        return { html: "", complete: false, renderable: false };
+    }
+    const source = cleanArtifactHtml(partial);
+    if (source.trim() === "") {
+        return { html: "", complete: false, renderable: false };
+    }
+    try {
+        const parser = new PredictiveHtmlParser();
+        const html = parser.push(source);
+        return {
+            html,
+            complete: parser.complete,
+            renderable: parser.isRenderable(),
+        };
+    }
+    catch {
+        return { html: partial, complete: false, renderable: true };
+    }
+}
+/**
+ * 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 class StreamingHtmlProjector {
+    parser = new PredictiveHtmlParser();
+    /** Offset in the raw stream where real content begins (-1 = undecided). */
+    start = -1;
+    /** Chars of the content region (raw.slice(start)) already pushed. */
+    fed = 0;
+    lastRaw = "";
+    /** Feed the full accumulated raw HTML; returns the current projection. */
+    update(raw) {
+        if (typeof raw !== "string" || raw === "") {
+            return { html: "", complete: false, renderable: false };
+        }
+        // Re-sync if the stream isn't an append of what we've seen (reset/replace).
+        if (!raw.startsWith(this.lastRaw))
+            this.reset();
+        this.lastRaw = raw;
+        if (this.start === -1) {
+            const resolved = resolveContentStart(raw);
+            if (resolved === -1) {
+                // Leading whitespace/fence not yet resolvable — nothing safe to render.
+                return { html: "", complete: false, renderable: false };
+            }
+            this.start = resolved;
+        }
+        const content = raw.slice(this.start);
+        if (content.length > this.fed) {
+            const delta = content.slice(this.fed);
+            this.fed = content.length;
+            try {
+                this.parser.push(delta);
+            }
+            catch {
+                // PredictiveHtmlParser fails open internally; guard defensively.
+            }
+        }
+        return {
+            html: this.parser.render(),
+            complete: this.parser.complete,
+            renderable: this.parser.isRenderable(),
+        };
+    }
+    reset() {
+        this.parser.reset();
+        this.start = -1;
+        this.fed = 0;
+        this.lastRaw = "";
+    }
+}
+/**
+ * Where real artifact content starts in the raw stream: past leading
+ * whitespace, and past a single opening ```/```html code fence if the model
+ * wrapped its output. Returns -1 while the answer can't be determined yet
+ * (buffer is all whitespace, or a fence opener whose newline hasn't arrived).
+ */
+function resolveContentStart(raw) {
+    let i = 0;
+    while (i < raw.length && /\s/.test(raw[i]))
+        i++;
+    if (i >= raw.length)
+        return -1; // all whitespace so far — wait
+    if (raw.startsWith("```", i)) {
+        const nl = raw.indexOf("\n", i);
+        if (nl === -1)
+            return -1; // fence opener incomplete — wait
+        return nl + 1;
+    }
+    return i;
+}
+//# sourceMappingURL=assembleDocument.js.map

package/dist/stream/assembleDocument.js.map

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

package/dist/stream/buffering.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Accumulates streamed artifact deltas and tracks the last *renderable*
+ * snapshot. Partial HTML mid-stream is frequently broken; the predictive parser
+ * repairs the current frontier into a temporary valid projection, while keeping
+ * the raw stream as the source of truth for final output and code view.
+ */
+export declare class ArtifactBuffer {
+    private chunks;
+    private joined;
+    private dirty;
+    private _lastValidSnapshot;
+    /** Append a streamed delta. */
+    append(delta: string): void;
+    /** The full aggregated raw HTML received so far. */
+    get raw(): string;
+    /** The last snapshot that passed the renderable heuristic. */
+    get lastValidSnapshot(): string;
+    /**
+     * Promote the current buffer to a snapshot if the predictive parser says
+     * there is visible body content. Returns the snapshot that should be
+     * displayed (new one if renderable, else the last good one). Pass an explicit
+     * `html` to commit a known-good final document.
+     */
+    commit(html?: string): string;
+    /** Force-set the final snapshot (used on `artifact_done`). */
+    finalize(html: string): string;
+    reset(): void;
+}
+/**
+ * Heuristic: is this partial HTML safe enough to drop into an iframe without
+ * obvious breakage? We require that we are not in the middle of an open tag,
+ * not inside an unterminated `<style>` block, and not mid-way through an HTML
+ * entity. This is intentionally conservative — false negatives just mean we
+ * wait for the next chunk.
+ */
+export declare function looksRenderable(html: string): boolean;
+//# sourceMappingURL=buffering.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buffering.d.ts","sourceRoot":"","sources":["../../src/stream/buffering.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,kBAAkB,CAAM;IAEhC,+BAA+B;IAC/B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM3B,oDAAoD;IACpD,IAAI,GAAG,IAAI,MAAM,CAMhB;IAED,8DAA8D;IAC9D,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAc7B,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAS9B,KAAK,IAAI,IAAI;CAMd;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAkBrD"}

package/dist/stream/buffering.js

@@ -0,0 +1,97 @@
+import { cleanArtifactHtml } from "../artifacts/artifactEnvelope.js";
+import { assembleStreamingHtml } from "./assembleDocument.js";
+/**
+ * Accumulates streamed artifact deltas and tracks the last *renderable*
+ * snapshot. Partial HTML mid-stream is frequently broken; the predictive parser
+ * repairs the current frontier into a temporary valid projection, while keeping
+ * the raw stream as the source of truth for final output and code view.
+ */
+export class ArtifactBuffer {
+    chunks = [];
+    joined = "";
+    dirty = false;
+    _lastValidSnapshot = "";
+    /** Append a streamed delta. */
+    append(delta) {
+        if (!delta)
+            return;
+        this.chunks.push(delta);
+        this.dirty = true;
+    }
+    /** The full aggregated raw HTML received so far. */
+    get raw() {
+        if (this.dirty) {
+            this.joined = this.chunks.join("");
+            this.dirty = false;
+        }
+        return this.joined;
+    }
+    /** The last snapshot that passed the renderable heuristic. */
+    get lastValidSnapshot() {
+        return this._lastValidSnapshot;
+    }
+    /**
+     * Promote the current buffer to a snapshot if the predictive parser says
+     * there is visible body content. Returns the snapshot that should be
+     * displayed (new one if renderable, else the last good one). Pass an explicit
+     * `html` to commit a known-good final document.
+     */
+    commit(html) {
+        const candidate = cleanArtifactHtml(html ?? this.raw);
+        if (html !== undefined) {
+            this._lastValidSnapshot = candidate;
+            return this._lastValidSnapshot;
+        }
+        const assembled = assembleStreamingHtml(candidate);
+        if (assembled.renderable) {
+            this._lastValidSnapshot = assembled.html;
+        }
+        return this._lastValidSnapshot;
+    }
+    /** Force-set the final snapshot (used on `artifact_done`). */
+    finalize(html) {
+        const finalHtml = cleanArtifactHtml(html);
+        this._lastValidSnapshot = finalHtml;
+        this.chunks = [finalHtml];
+        this.joined = finalHtml;
+        this.dirty = false;
+        return finalHtml;
+    }
+    reset() {
+        this.chunks = [];
+        this.joined = "";
+        this.dirty = false;
+        this._lastValidSnapshot = "";
+    }
+}
+/**
+ * Heuristic: is this partial HTML safe enough to drop into an iframe without
+ * obvious breakage? We require that we are not in the middle of an open tag,
+ * not inside an unterminated `<style>` block, and not mid-way through an HTML
+ * entity. This is intentionally conservative — false negatives just mean we
+ * wait for the next chunk.
+ */
+export function looksRenderable(html) {
+    if (!html)
+        return false;
+    // Don't render while sitting inside an unclosed tag: last '<' after last '>'.
+    const lastOpen = html.lastIndexOf("<");
+    const lastClose = html.lastIndexOf(">");
+    if (lastOpen > lastClose)
+        return false;
+    // Balanced <style> blocks.
+    const styleOpen = countMatches(html, /<style[\s>]/gi);
+    const styleClose = countMatches(html, /<\/style>/gi);
+    if (styleOpen !== styleClose)
+        return false;
+    // Not mid-entity (e.g. "&amp" without ";").
+    const trailingEntity = /&[a-z0-9#]*$/i.test(html);
+    if (trailingEntity)
+        return false;
+    return true;
+}
+function countMatches(input, pattern) {
+    const matches = input.match(pattern);
+    return matches ? matches.length : 0;
+}
+//# sourceMappingURL=buffering.js.map

package/dist/stream/buffering.js.map

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

package/dist/stream/debounce.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Trailing-edge debounce. Returns a wrapped function plus `flush` (run now)
+ * and `cancel` (drop the pending call). Used to throttle iframe srcDoc updates
+ * while artifact deltas stream in.
+ */
+export interface Debounced<A extends unknown[]> {
+    (...args: A): void;
+    flush: () => void;
+    cancel: () => void;
+}
+export declare function debounce<A extends unknown[]>(fn: (...args: A) => void, waitMs: number): Debounced<A>;
+//# sourceMappingURL=debounce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../src/stream/debounce.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE;IAC5C,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,EAC1C,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,EACxB,MAAM,EAAE,MAAM,GACb,SAAS,CAAC,CAAC,CAAC,CAsCd"}

package/dist/stream/debounce.js

@@ -0,0 +1,36 @@
+export function debounce(fn, waitMs) {
+    let timer = null;
+    let lastArgs = null;
+    const run = () => {
+        if (lastArgs) {
+            const args = lastArgs;
+            lastArgs = null;
+            fn(...args);
+        }
+    };
+    const debounced = ((...args) => {
+        lastArgs = args;
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            timer = null;
+            run();
+        }, waitMs);
+    });
+    debounced.flush = () => {
+        if (timer) {
+            clearTimeout(timer);
+            timer = null;
+        }
+        run();
+    };
+    debounced.cancel = () => {
+        if (timer) {
+            clearTimeout(timer);
+            timer = null;
+        }
+        lastArgs = null;
+    };
+    return debounced;
+}
+//# sourceMappingURL=debounce.js.map

package/dist/stream/debounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.js","sourceRoot":"","sources":["../../src/stream/debounce.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,QAAQ,CACtB,EAAwB,EACxB,MAAc;IAEd,IAAI,KAAK,GAAyC,IAAI,CAAC;IACvD,IAAI,QAAQ,GAAa,IAAI,CAAC;IAE9B,MAAM,GAAG,GAAG,GAAG,EAAE;QACf,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,QAAQ,CAAC;YACtB,QAAQ,GAAG,IAAI,CAAC;YAChB,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,IAAO,EAAE,EAAE;QAChC,QAAQ,GAAG,IAAI,CAAC;QAChB,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,KAAK,GAAG,IAAI,CAAC;YACb,GAAG,EAAE,CAAC;QACR,CAAC,EAAE,MAAM,CAAC,CAAC;IACb,CAAC,CAAiB,CAAC;IAEnB,SAAS,CAAC,KAAK,GAAG,GAAG,EAAE;QACrB,IAAI,KAAK,EAAE,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QACD,GAAG,EAAE,CAAC;IACR,CAAC,CAAC;IAEF,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE;QACtB,IAAI,KAAK,EAAE,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QACD,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/stream/decoder.d.ts

@@ -0,0 +1,17 @@
+import type { ArtifactStreamEvent } from "../types/stream.js";
+/**
+ * Incremental SSE decoder. Feed it raw text chunks; it returns any complete
+ * protocol events found so far. Frames are separated by a blank line and the
+ * payload lives on `data:` lines (concatenated per the SSE spec).
+ */
+export declare class SseDecoder {
+    private buffer;
+    /** Push a chunk of text and drain any complete events. */
+    push(chunk: string): ArtifactStreamEvent[];
+    /** Drain any trailing buffered frame at end-of-stream. */
+    flush(): ArtifactStreamEvent[];
+    private frameSeparatorLen;
+    private indexOfFrameEnd;
+    private parseFrame;
+}
+//# sourceMappingURL=decoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../../src/stream/decoder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAM;IAEpB,0DAA0D;IAC1D,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAgB1C,0DAA0D;IAC1D,KAAK,IAAI,mBAAmB,EAAE;IAQ9B,OAAO,CAAC,iBAAiB,CAAK;IAE9B,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,UAAU;CAsBnB"}

package/dist/stream/decoder.js

@@ -0,0 +1,71 @@
+import { safeJsonParse } from "../utils/safeJsonParse.js";
+import { isArtifactStreamEvent } from "./events.js";
+/**
+ * Incremental SSE decoder. Feed it raw text chunks; it returns any complete
+ * protocol events found so far. Frames are separated by a blank line and the
+ * payload lives on `data:` lines (concatenated per the SSE spec).
+ */
+export class SseDecoder {
+    buffer = "";
+    /** Push a chunk of text and drain any complete events. */
+    push(chunk) {
+        this.buffer += chunk;
+        const events = [];
+        // Normalize CRLF so the split is reliable across platforms.
+        let separatorIndex;
+        while ((separatorIndex = this.indexOfFrameEnd()) !== -1) {
+            const rawFrame = this.buffer.slice(0, separatorIndex);
+            this.buffer = this.buffer.slice(separatorIndex + this.frameSeparatorLen);
+            const parsed = this.parseFrame(rawFrame);
+            if (parsed)
+                events.push(parsed);
+        }
+        return events;
+    }
+    /** Drain any trailing buffered frame at end-of-stream. */
+    flush() {
+        const remaining = this.buffer.trim();
+        this.buffer = "";
+        if (!remaining)
+            return [];
+        const parsed = this.parseFrame(remaining);
+        return parsed ? [parsed] : [];
+    }
+    frameSeparatorLen = 2;
+    indexOfFrameEnd() {
+        const lf = this.buffer.indexOf("\n\n");
+        const crlf = this.buffer.indexOf("\r\n\r\n");
+        if (crlf !== -1 && (lf === -1 || crlf < lf)) {
+            this.frameSeparatorLen = 4;
+            return crlf;
+        }
+        if (lf !== -1) {
+            this.frameSeparatorLen = 2;
+            return lf;
+        }
+        return -1;
+    }
+    parseFrame(frame) {
+        const dataLines = [];
+        for (const rawLine of frame.split(/\r?\n/)) {
+            const line = rawLine;
+            if (line.startsWith(":"))
+                continue; // comment / heartbeat
+            if (line.startsWith("data:")) {
+                dataLines.push(line.slice(5).replace(/^ /, ""));
+            }
+        }
+        if (dataLines.length === 0)
+            return null;
+        const payload = dataLines.join("\n");
+        const parsed = safeJsonParse(payload, null);
+        if (!isArtifactStreamEvent(parsed))
+            return null;
+        if (parsed.type === "mode" &&
+            parsed.mode === "html_artifact") {
+            return { type: "mode", mode: "artifact" };
+        }
+        return parsed;
+    }
+}
+//# sourceMappingURL=decoder.js.map

package/dist/stream/decoder.js.map

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

package/dist/stream/encoder.d.ts

@@ -0,0 +1,12 @@
+import type { ArtifactStreamEvent } from "../types/stream.js";
+/**
+ * Serialize a protocol event into a single SSE frame. The whole protocol uses
+ * one named event (`artifact`) and JSON-encodes the payload on the `data:`
+ * line, which keeps multi-line HTML safe (no raw newlines reach the wire).
+ */
+export declare function encodeSseEvent(event: ArtifactStreamEvent): string;
+/** Encode an event directly to bytes for a `ReadableStream<Uint8Array>`. */
+export declare function encodeSseEventBytes(event: ArtifactStreamEvent, encoder?: TextEncoder): Uint8Array;
+/** A comment frame used as a keep-alive heartbeat. */
+export declare function encodeSseComment(text?: string): string;
+//# sourceMappingURL=encoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../src/stream/encoder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAGjE;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,GAAE,WAA+B,GACvC,UAAU,CAEZ;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,IAAI,SAAe,GAAG,MAAM,CAE5D"}

package/dist/stream/encoder.js

@@ -0,0 +1,19 @@
+import { SSE_EVENT_NAME } from "../constants/events.js";
+/**
+ * Serialize a protocol event into a single SSE frame. The whole protocol uses
+ * one named event (`artifact`) and JSON-encodes the payload on the `data:`
+ * line, which keeps multi-line HTML safe (no raw newlines reach the wire).
+ */
+export function encodeSseEvent(event) {
+    const data = JSON.stringify(event);
+    return `event: ${SSE_EVENT_NAME}\ndata: ${data}\n\n`;
+}
+/** Encode an event directly to bytes for a `ReadableStream<Uint8Array>`. */
+export function encodeSseEventBytes(event, encoder = new TextEncoder()) {
+    return encoder.encode(encodeSseEvent(event));
+}
+/** A comment frame used as a keep-alive heartbeat. */
+export function encodeSseComment(text = "keep-alive") {
+    return `: ${text}\n\n`;
+}
+//# sourceMappingURL=encoder.js.map

package/dist/stream/encoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.js","sourceRoot":"","sources":["../../src/stream/encoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,UAAU,cAAc,WAAW,IAAI,MAAM,CAAC;AACvD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,mBAAmB,CACjC,KAA0B,EAC1B,UAAuB,IAAI,WAAW,EAAE;IAExC,OAAO,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,gBAAgB,CAAC,IAAI,GAAG,YAAY;IAClD,OAAO,KAAK,IAAI,MAAM,CAAC;AACzB,CAAC"}

package/dist/stream/events.d.ts

@@ -0,0 +1,20 @@
+import type { ArtifactKind, ArtifactMode, ArtifactStreamEvent } from "../types/stream.js";
+/**
+ * Typed factory helpers for every protocol event. Using these keeps the
+ * server producer honest and gives the client exhaustive types.
+ */
+export declare const event: {
+    mode: (mode: ArtifactMode) => ArtifactStreamEvent;
+    messageStart: (messageId: string) => ArtifactStreamEvent;
+    messageDelta: (messageId: string, delta: string) => ArtifactStreamEvent;
+    messageDone: (messageId: string, content: string) => ArtifactStreamEvent;
+    artifactStart: (artifactId: string, title: string, artifactType?: ArtifactKind) => ArtifactStreamEvent;
+    artifactDelta: (artifactId: string, delta: string) => ArtifactStreamEvent;
+    artifactSnapshot: (artifactId: string, html: string) => ArtifactStreamEvent;
+    artifactDone: (artifactId: string, html: string) => ArtifactStreamEvent;
+    error: (message: string, recoverable?: boolean) => ArtifactStreamEvent;
+    done: () => ArtifactStreamEvent;
+};
+/** Runtime guard that an unknown value is a protocol event. */
+export declare function isArtifactStreamEvent(value: unknown): value is ArtifactStreamEvent;
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/stream/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B;;;GAGG;AACH,eAAO,MAAM,KAAK;iBACH,YAAY,KAAG,mBAAmB;8BAErB,MAAM,KAAG,mBAAmB;8BAK5B,MAAM,SAAS,MAAM,KAAG,mBAAmB;6BAM5C,MAAM,WAAW,MAAM,KAAG,mBAAmB;gCAOxD,MAAM,SACX,MAAM,iBACC,YAAY,KACzB,mBAAmB;gCAOM,MAAM,SAAS,MAAM,KAAG,mBAAmB;mCAMxC,MAAM,QAAQ,MAAM,KAAG,mBAAmB;+BAM9C,MAAM,QAAQ,MAAM,KAAG,mBAAmB;qBAMpD,MAAM,4BAAuB,mBAAmB;gBAMvD,mBAAmB;CAC9B,CAAC;AAEF,+DAA+D;AAC/D,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,mBAAmB,CAe9B"}

package/dist/stream/events.js

@@ -0,0 +1,65 @@
+/**
+ * Typed factory helpers for every protocol event. Using these keeps the
+ * server producer honest and gives the client exhaustive types.
+ */
+export const event = {
+    mode: (mode) => ({ type: "mode", mode }),
+    messageStart: (messageId) => ({
+        type: "message_start",
+        messageId,
+    }),
+    messageDelta: (messageId, delta) => ({
+        type: "message_delta",
+        messageId,
+        delta,
+    }),
+    messageDone: (messageId, content) => ({
+        type: "message_done",
+        messageId,
+        content,
+    }),
+    artifactStart: (artifactId, title, artifactType = "html") => ({
+        type: "artifact_start",
+        artifactId,
+        title,
+        artifactType,
+    }),
+    artifactDelta: (artifactId, delta) => ({
+        type: "artifact_delta",
+        artifactId,
+        delta,
+    }),
+    artifactSnapshot: (artifactId, html) => ({
+        type: "artifact_snapshot",
+        artifactId,
+        html,
+    }),
+    artifactDone: (artifactId, html) => ({
+        type: "artifact_done",
+        artifactId,
+        html,
+    }),
+    error: (message, recoverable = true) => ({
+        type: "error",
+        message,
+        recoverable,
+    }),
+    done: () => ({ type: "done" }),
+};
+/** Runtime guard that an unknown value is a protocol event. */
+export function isArtifactStreamEvent(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const type = value.type;
+    return (type === "mode" ||
+        type === "message_start" ||
+        type === "message_delta" ||
+        type === "message_done" ||
+        type === "artifact_start" ||
+        type === "artifact_delta" ||
+        type === "artifact_snapshot" ||
+        type === "artifact_done" ||
+        type === "error" ||
+        type === "done");
+}
+//# sourceMappingURL=events.js.map

package/dist/stream/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/stream/events.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,CAAC,IAAkB,EAAuB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAE3E,YAAY,EAAE,CAAC,SAAiB,EAAuB,EAAE,CAAC,CAAC;QACzD,IAAI,EAAE,eAAe;QACrB,SAAS;KACV,CAAC;IAEF,YAAY,EAAE,CAAC,SAAiB,EAAE,KAAa,EAAuB,EAAE,CAAC,CAAC;QACxE,IAAI,EAAE,eAAe;QACrB,SAAS;QACT,KAAK;KACN,CAAC;IAEF,WAAW,EAAE,CAAC,SAAiB,EAAE,OAAe,EAAuB,EAAE,CAAC,CAAC;QACzE,IAAI,EAAE,cAAc;QACpB,SAAS;QACT,OAAO;KACR,CAAC;IAEF,aAAa,EAAE,CACb,UAAkB,EAClB,KAAa,EACb,eAA6B,MAAM,EACd,EAAE,CAAC,CAAC;QACzB,IAAI,EAAE,gBAAgB;QACtB,UAAU;QACV,KAAK;QACL,YAAY;KACb,CAAC;IAEF,aAAa,EAAE,CAAC,UAAkB,EAAE,KAAa,EAAuB,EAAE,CAAC,CAAC;QAC1E,IAAI,EAAE,gBAAgB;QACtB,UAAU;QACV,KAAK;KACN,CAAC;IAEF,gBAAgB,EAAE,CAAC,UAAkB,EAAE,IAAY,EAAuB,EAAE,CAAC,CAAC;QAC5E,IAAI,EAAE,mBAAmB;QACzB,UAAU;QACV,IAAI;KACL,CAAC;IAEF,YAAY,EAAE,CAAC,UAAkB,EAAE,IAAY,EAAuB,EAAE,CAAC,CAAC;QACxE,IAAI,EAAE,eAAe;QACrB,UAAU;QACV,IAAI;KACL,CAAC;IAEF,KAAK,EAAE,CAAC,OAAe,EAAE,WAAW,GAAG,IAAI,EAAuB,EAAE,CAAC,CAAC;QACpE,IAAI,EAAE,OAAO;QACb,OAAO;QACP,WAAW;KACZ,CAAC;IAEF,IAAI,EAAE,GAAwB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;CACpD,CAAC;AAEF,+DAA+D;AAC/D,MAAM,UAAU,qBAAqB,CACnC,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;IAChD,OAAO,CACL,IAAI,KAAK,MAAM;QACf,IAAI,KAAK,eAAe;QACxB,IAAI,KAAK,eAAe;QACxB,IAAI,KAAK,cAAc;QACvB,IAAI,KAAK,gBAAgB;QACzB,IAAI,KAAK,gBAAgB;QACzB,IAAI,KAAK,mBAAmB;QAC5B,IAAI,KAAK,eAAe;QACxB,IAAI,KAAK,OAAO;QAChB,IAAI,KAAK,MAAM,CAChB,CAAC;AACJ,CAAC"}

package/dist/stream/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./events.js";
+export * from "./encoder.js";
+export * from "./decoder.js";
+export * from "./sse.js";
+export * from "./buffering.js";
+export * from "./debounce.js";
+export * from "./assembleDocument.js";
+export * from "./predictiveHtmlParser.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stream/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC"}

package/dist/stream/index.js

@@ -0,0 +1,9 @@
+export * from "./events.js";
+export * from "./encoder.js";
+export * from "./decoder.js";
+export * from "./sse.js";
+export * from "./buffering.js";
+export * from "./debounce.js";
+export * from "./assembleDocument.js";
+export * from "./predictiveHtmlParser.js";
+//# sourceMappingURL=index.js.map

package/dist/stream/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stream/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC"}

package/dist/stream/predictiveHtmlParser.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Predictive HTML parser for streaming AI output.
+ *
+ * The core idea: keep the real streamed HTML as the immutable *truth*, but for
+ * rendering produce a temporary *projection* that predicts the missing closing
+ * tags from the current parser stack. The model can stream
+ *
+ *     <section><div><h2>Hello
+ *
+ * and the renderer receives a valid document:
+ *
+ *     <section><div><h2>Hello</h2></div></section>
+ *
+ * When the real `</h2></div></section>` arrives later, the stack matches them
+ * and nothing is duplicated — predicted closings are never written back into
+ * the committed truth.
+ *
+ * The parser is incremental: feed it chunks with {@link push}; it carries
+ * partial tokens (tags, comments, raw-text close) across chunk boundaries. It
+ * handles void elements, self-closing tags, quoted attributes containing
+ * `<`/`>`, comments, doctype, raw-text elements (`<style>`/`<script>`/… whose
+ * bodies aren't markup), implicit closing (`<li>`, `<td>`, `<p>`, …), and
+ * mis-nested close tags (`<div><p>x</div>` → closes `p` before `div`).
+ *
+ * It is purely structural — it does NOT sanitize or style. Run the output
+ * through the sanitizer before rendering (the iframe pipeline does this).
+ *
+ * Fail-open: malformed input degrades to text rather than throwing.
+ */
+export declare class PredictiveHtmlParser {
+    private committed;
+    private pending;
+    private stack;
+    private insideRawText;
+    private htmlClosed;
+    /** Feed a chunk; returns the current renderable projection. */
+    push(chunk: string): string;
+    /** The current renderable projection: committed + predicted closings. */
+    render(): string;
+    /** The immutable, never-predicted truth committed so far. */
+    get committedHtml(): string;
+    /** True once a real `</html>` has balanced the document. */
+    get complete(): boolean;
+    /** Is there visible body content worth rendering yet? */
+    isRenderable(): boolean;
+    reset(): void;
+    private process;
+    private handleOpen;
+    private handleClose;
+    private autoCloseImplicit;
+}
+//# sourceMappingURL=predictiveHtmlParser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"predictiveHtmlParser.d.ts","sourceRoot":"","sources":["../../src/stream/predictiveHtmlParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AA8BH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,UAAU,CAAS;IAE3B,+DAA+D;IAC/D,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAa3B,yEAAyE;IACzE,MAAM,IAAI,MAAM;IAWhB,6DAA6D;IAC7D,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,4DAA4D;IAC5D,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,yDAAyD;IACzD,YAAY,IAAI,OAAO;IAQvB,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,OAAO;IAkFf,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,iBAAiB;CAc1B"}