netra-artifacts 0.1.0-alpha.0

package/dist/constants/index.js

@@ -0,0 +1,4 @@
+export * from "./events.js";
+export * from "./sandbox.js";
+export * from "./defaults.js";
+//# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/constants/sandbox.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Iframe sandbox tokens. `allow-scripts` is intentionally absent — generated
+ * artifacts are static HTML/CSS and must never execute JavaScript.
+ */
+export declare const SANDBOX_TOKENS: {
+    readonly FORMS: "allow-forms";
+    readonly POPUPS: "allow-popups";
+    readonly SAME_ORIGIN: "allow-same-origin";
+};
+/**
+ * Default sandbox: forms + same-origin, but NO scripts. `allow-same-origin`
+ * lets the parent measure the document so the iframe can auto-fit its content
+ * height (no inner scrollbar). It is only dangerous when combined with
+ * `allow-scripts` — which is forbidden here — so static artifacts stay safe.
+ */
+export declare const DEFAULT_SANDBOX: string;
+/** Tokens that are forbidden regardless of configuration. */
+export declare const FORBIDDEN_SANDBOX_TOKENS: readonly ["allow-scripts", "allow-top-navigation", "allow-top-navigation-by-user-activation", "allow-modals"];
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/constants/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/constants/sandbox.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAA0D,CAAC;AAEvF,6DAA6D;AAC7D,eAAO,MAAM,wBAAwB,+GAK3B,CAAC"}

package/dist/constants/sandbox.js

@@ -0,0 +1,24 @@
+/**
+ * Iframe sandbox tokens. `allow-scripts` is intentionally absent — generated
+ * artifacts are static HTML/CSS and must never execute JavaScript.
+ */
+export const SANDBOX_TOKENS = {
+    FORMS: "allow-forms",
+    POPUPS: "allow-popups",
+    SAME_ORIGIN: "allow-same-origin",
+};
+/**
+ * Default sandbox: forms + same-origin, but NO scripts. `allow-same-origin`
+ * lets the parent measure the document so the iframe can auto-fit its content
+ * height (no inner scrollbar). It is only dangerous when combined with
+ * `allow-scripts` — which is forbidden here — so static artifacts stay safe.
+ */
+export const DEFAULT_SANDBOX = `${SANDBOX_TOKENS.FORMS} ${SANDBOX_TOKENS.SAME_ORIGIN}`;
+/** Tokens that are forbidden regardless of configuration. */
+export const FORBIDDEN_SANDBOX_TOKENS = [
+    "allow-scripts",
+    "allow-top-navigation",
+    "allow-top-navigation-by-user-activation",
+    "allow-modals",
+];
+//# sourceMappingURL=sandbox.js.map

package/dist/constants/sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../../src/constants/sandbox.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,cAAc;IACtB,WAAW,EAAE,mBAAmB;CACxB,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,cAAc,CAAC,KAAK,IAAI,cAAc,CAAC,WAAW,EAAE,CAAC;AAEvF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,eAAe;IACf,sBAAsB;IACtB,yCAAyC;IACzC,cAAc;CACN,CAAC"}

package/dist/core/createArtifactResponse.d.ts

@@ -0,0 +1,5 @@
+/** SSE response headers tuned to defeat proxy buffering. */
+export declare const SSE_HEADERS: Record<string, string>;
+/** Wrap an SSE byte stream in a `Response` with the correct headers. */
+export declare function createArtifactResponse(stream: ReadableStream<Uint8Array>, init?: ResponseInit): Response;
+//# sourceMappingURL=createArtifactResponse.d.ts.map

package/dist/core/createArtifactResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createArtifactResponse.d.ts","sourceRoot":"","sources":["../../src/core/createArtifactResponse.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAM9C,CAAC;AAEF,wEAAwE;AACxE,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,IAAI,CAAC,EAAE,YAAY,GAClB,QAAQ,CAKV"}

package/dist/core/createArtifactResponse.js

@@ -0,0 +1,16 @@
+/** SSE response headers tuned to defeat proxy buffering. */
+export const SSE_HEADERS = {
+    "Content-Type": "text/event-stream; charset=utf-8",
+    "Cache-Control": "no-cache, no-transform",
+    Connection: "keep-alive",
+    // Disable nginx buffering so events flush immediately.
+    "X-Accel-Buffering": "no",
+};
+/** Wrap an SSE byte stream in a `Response` with the correct headers. */
+export function createArtifactResponse(stream, init) {
+    return new Response(stream, {
+        status: init?.status ?? 200,
+        headers: { ...SSE_HEADERS, ...init?.headers },
+    });
+}
+//# sourceMappingURL=createArtifactResponse.js.map

package/dist/core/createArtifactResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createArtifactResponse.js","sourceRoot":"","sources":["../../src/core/createArtifactResponse.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,MAAM,CAAC,MAAM,WAAW,GAA2B;IACjD,cAAc,EAAE,kCAAkC;IAClD,eAAe,EAAE,wBAAwB;IACzC,UAAU,EAAE,YAAY;IACxB,uDAAuD;IACvD,mBAAmB,EAAE,IAAI;CAC1B,CAAC;AAEF,wEAAwE;AACxE,MAAM,UAAU,sBAAsB,CACpC,MAAkC,EAClC,IAAmB;IAEnB,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE;QAC1B,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG;QAC3B,OAAO,EAAE,EAAE,GAAG,WAAW,EAAE,GAAI,IAAI,EAAE,OAAkC,EAAE;KAC1E,CAAC,CAAC;AACL,CAAC"}

package/dist/core/createArtifactStream.d.ts

@@ -0,0 +1,9 @@
+import type { ArtifactStreamProducer } from "./lifecycle.js";
+/**
+ * Turn an event-emitting producer into an SSE byte stream. The producer is
+ * responsible for emitting its own `done` event on success; this wrapper
+ * guarantees the stream is always closed and that an uncaught producer error
+ * becomes a terminal `error` + `done` pair rather than a hung connection.
+ */
+export declare function createArtifactStream(producer: ArtifactStreamProducer): ReadableStream<Uint8Array>;
+//# sourceMappingURL=createArtifactStream.d.ts.map

package/dist/core/createArtifactStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createArtifactStream.d.ts","sourceRoot":"","sources":["../../src/core/createArtifactStream.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAQ,MAAM,gBAAgB,CAAC;AAEnE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,sBAAsB,GAC/B,cAAc,CAAC,UAAU,CAAC,CAuB5B"}

package/dist/core/createArtifactStream.js

@@ -0,0 +1,34 @@
+import { encodeSseEventBytes } from "../stream/encoder.js";
+import { event } from "../stream/events.js";
+/**
+ * Turn an event-emitting producer into an SSE byte stream. The producer is
+ * responsible for emitting its own `done` event on success; this wrapper
+ * guarantees the stream is always closed and that an uncaught producer error
+ * becomes a terminal `error` + `done` pair rather than a hung connection.
+ */
+export function createArtifactStream(producer) {
+    const encoder = new TextEncoder();
+    return new ReadableStream({
+        async start(controller) {
+            let closed = false;
+            const emit = (e) => {
+                if (closed)
+                    return;
+                controller.enqueue(encodeSseEventBytes(e, encoder));
+            };
+            try {
+                await producer(emit);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                emit(event.error(message, false));
+                emit(event.done());
+            }
+            finally {
+                closed = true;
+                controller.close();
+            }
+        },
+    });
+}
+//# sourceMappingURL=createArtifactStream.js.map

package/dist/core/createArtifactStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createArtifactStream.js","sourceRoot":"","sources":["../../src/core/createArtifactStream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG5C;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAgC;IAEhC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAElC,OAAO,IAAI,cAAc,CAAa;QACpC,KAAK,CAAC,KAAK,CAAC,UAAU;YACpB,IAAI,MAAM,GAAG,KAAK,CAAC;YACnB,MAAM,IAAI,GAAS,CAAC,CAAC,EAAE,EAAE;gBACvB,IAAI,MAAM;oBAAE,OAAO;gBACnB,UAAU,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;YACtD,CAAC,CAAC;YAEF,IAAI,CAAC;gBACH,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;gBAClC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACrB,CAAC;oBAAS,CAAC;gBACT,MAAM,GAAG,IAAI,CAAC;gBACd,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/core/createIds.d.ts

@@ -0,0 +1,3 @@
+export declare function createMessageId(): string;
+export declare function createArtifactId(): string;
+//# sourceMappingURL=createIds.d.ts.map

package/dist/core/createIds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createIds.d.ts","sourceRoot":"","sources":["../../src/core/createIds.ts"],"names":[],"mappings":"AAMA,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/core/createIds.js

@@ -0,0 +1,13 @@
+function randomId() {
+    const g = globalThis;
+    if (g.crypto?.randomUUID)
+        return g.crypto.randomUUID();
+    return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+}
+export function createMessageId() {
+    return `msg_${randomId()}`;
+}
+export function createArtifactId() {
+    return `art_${randomId()}`;
+}
+//# sourceMappingURL=createIds.js.map

package/dist/core/createIds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createIds.js","sourceRoot":"","sources":["../../src/core/createIds.ts"],"names":[],"mappings":"AAAA,SAAS,QAAQ;IACf,MAAM,CAAC,GAAG,UAAwD,CAAC;IACnE,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU;QAAE,OAAO,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IACvD,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,QAAQ,EAAE,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,QAAQ,EAAE,EAAE,CAAC;AAC7B,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./createIds.js";
+export * from "./lifecycle.js";
+export * from "./createArtifactStream.js";
+export * from "./createArtifactResponse.js";
+export * from "./parseArtifactEnvelope.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,6 @@
+export * from "./createIds.js";
+export * from "./lifecycle.js";
+export * from "./createArtifactStream.js";
+export * from "./createArtifactResponse.js";
+export * from "./parseArtifactEnvelope.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC"}

package/dist/core/lifecycle.d.ts

@@ -0,0 +1,35 @@
+import type { ArtifactStreamEvent } from "../types/stream.js";
+/** A sink for protocol events. Implementations write to an SSE stream. */
+export type Emit = (event: ArtifactStreamEvent) => void;
+/** A function that drives a full response by emitting protocol events. */
+export type ArtifactStreamProducer = (emit: Emit) => Promise<void>;
+/**
+ * Helper that manages a single assistant message's lifecycle, accumulating
+ * content so `done` can carry the full text without the caller re-tracking it.
+ */
+export declare class MessageLifecycle {
+    private readonly emit;
+    readonly id: string;
+    private content;
+    private started;
+    private finished;
+    constructor(emit: Emit, id?: string);
+    start(): void;
+    delta(text: string): void;
+    /** Idempotent — emits `message_done` at most once. */
+    done(finalContent?: string): string;
+}
+/** Helper managing one artifact's lifecycle (start → deltas → snapshots → done). */
+export declare class ArtifactLifecycle {
+    private readonly emit;
+    readonly id: string;
+    private started;
+    private finished;
+    constructor(emit: Emit, id?: string);
+    start(title: string): void;
+    delta(html: string): void;
+    snapshot(html: string): void;
+    /** Idempotent — emits `artifact_done` at most once. */
+    done(html: string): void;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/core/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/core/lifecycle.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,0EAA0E;AAC1E,MAAM,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAExD,0EAA0E;AAC1E,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnE;;;GAGG;AACH,qBAAa,gBAAgB;IAOzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IANvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;gBAGN,IAAI,EAAE,IAAI,EAC3B,EAAE,GAAE,MAA0B;IAKhC,KAAK,IAAI,IAAI;IAMb,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOzB,sDAAsD;IACtD,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM;CAUpC;AAED,oFAAoF;AACpF,qBAAa,iBAAiB;IAM1B,OAAO,CAAC,QAAQ,CAAC,IAAI;IALvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;gBAGN,IAAI,EAAE,IAAI,EAC3B,EAAE,GAAE,MAA2B;IAKjC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM1B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK5B,uDAAuD;IACvD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAMzB"}

package/dist/core/lifecycle.js

@@ -0,0 +1,81 @@
+import { event } from "../stream/events.js";
+import { createArtifactId, createMessageId } from "./createIds.js";
+/**
+ * Helper that manages a single assistant message's lifecycle, accumulating
+ * content so `done` can carry the full text without the caller re-tracking it.
+ */
+export class MessageLifecycle {
+    emit;
+    id;
+    content = "";
+    started = false;
+    finished = false;
+    constructor(emit, id = createMessageId()) {
+        this.emit = emit;
+        this.id = id;
+    }
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        this.emit(event.messageStart(this.id));
+    }
+    delta(text) {
+        if (!text || this.finished)
+            return;
+        if (!this.started)
+            this.start();
+        this.content += text;
+        this.emit(event.messageDelta(this.id, text));
+    }
+    /** Idempotent — emits `message_done` at most once. */
+    done(finalContent) {
+        if (this.finished)
+            return this.content;
+        if (!this.started)
+            this.start();
+        if (finalContent !== undefined && this.content === "") {
+            this.content = finalContent;
+        }
+        this.finished = true;
+        this.emit(event.messageDone(this.id, this.content));
+        return this.content;
+    }
+}
+/** Helper managing one artifact's lifecycle (start → deltas → snapshots → done). */
+export class ArtifactLifecycle {
+    emit;
+    id;
+    started = false;
+    finished = false;
+    constructor(emit, id = createArtifactId()) {
+        this.emit = emit;
+        this.id = id;
+    }
+    start(title) {
+        if (this.started)
+            return;
+        this.started = true;
+        this.emit(event.artifactStart(this.id, title, "html"));
+    }
+    delta(html) {
+        if (!html || this.finished)
+            return;
+        this.emit(event.artifactDelta(this.id, html));
+    }
+    snapshot(html) {
+        if (this.finished)
+            return;
+        this.emit(event.artifactSnapshot(this.id, html));
+    }
+    /** Idempotent — emits `artifact_done` at most once. */
+    done(html) {
+        if (this.finished)
+            return;
+        if (!this.started)
+            this.start("Untitled artifact");
+        this.finished = true;
+        this.emit(event.artifactDone(this.id, html));
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/core/lifecycle.js.map

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

package/dist/core/parseArtifactEnvelope.d.ts

@@ -0,0 +1,2 @@
+export { parseArtifactEnvelope, StreamingEnvelopeParser, type EnvelopeStreamEvent, } from "../artifacts/artifactEnvelope.js";
+//# sourceMappingURL=parseArtifactEnvelope.d.ts.map

package/dist/core/parseArtifactEnvelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseArtifactEnvelope.d.ts","sourceRoot":"","sources":["../../src/core/parseArtifactEnvelope.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,mBAAmB,GACzB,MAAM,kCAAkC,CAAC"}

package/dist/core/parseArtifactEnvelope.js

@@ -0,0 +1,3 @@
+// Re-exported from the artifacts module so it's reachable from the core API too.
+export { parseArtifactEnvelope, StreamingEnvelopeParser, } from "../artifacts/artifactEnvelope.js";
+//# sourceMappingURL=parseArtifactEnvelope.js.map

package/dist/core/parseArtifactEnvelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseArtifactEnvelope.js","sourceRoot":"","sources":["../../src/core/parseArtifactEnvelope.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GAExB,MAAM,kCAAkC,CAAC"}

package/dist/errors/ArtifactParseError.d.ts

@@ -0,0 +1,10 @@
+import type { ArtifactErrorCode } from "../types/errors.js";
+/** Raised when the model envelope cannot be parsed. Always recoverable. */
+export declare class ArtifactParseError extends Error {
+    readonly code: ArtifactErrorCode;
+    readonly recoverable = true;
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=ArtifactParseError.d.ts.map

package/dist/errors/ArtifactParseError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactParseError.d.ts","sourceRoot":"","sources":["../../src/errors/ArtifactParseError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,2EAA2E;AAC3E,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAA0B;IAC1D,QAAQ,CAAC,WAAW,QAAQ;gBAEhB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D"}

package/dist/errors/ArtifactParseError.js

@@ -0,0 +1,10 @@
+/** Raised when the model envelope cannot be parsed. Always recoverable. */
+export class ArtifactParseError extends Error {
+    code = "ARTIFACT_PARSE_ERROR";
+    recoverable = true;
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ArtifactParseError";
+    }
+}
+//# sourceMappingURL=ArtifactParseError.js.map

package/dist/errors/ArtifactParseError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactParseError.js","sourceRoot":"","sources":["../../src/errors/ArtifactParseError.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,GAAsB,sBAAsB,CAAC;IACjD,WAAW,GAAG,IAAI,CAAC;IAE5B,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/dist/errors/ClassificationError.d.ts

@@ -0,0 +1,13 @@
+import type { ArtifactErrorCode } from "../types/errors.js";
+/**
+ * Raised when classification fails. Always recoverable — the server falls back
+ * to heuristic rules and ultimately to markdown.
+ */
+export declare class ClassificationError extends Error {
+    readonly code: ArtifactErrorCode;
+    readonly recoverable = true;
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=ClassificationError.d.ts.map

package/dist/errors/ClassificationError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClassificationError.d.ts","sourceRoot":"","sources":["../../src/errors/ClassificationError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAA0B;IAC1D,QAAQ,CAAC,WAAW,QAAQ;gBAEhB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D"}

package/dist/errors/ClassificationError.js

@@ -0,0 +1,13 @@
+/**
+ * Raised when classification fails. Always recoverable — the server falls back
+ * to heuristic rules and ultimately to markdown.
+ */
+export class ClassificationError extends Error {
+    code = "CLASSIFICATION_ERROR";
+    recoverable = true;
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ClassificationError";
+    }
+}
+//# sourceMappingURL=ClassificationError.js.map

package/dist/errors/ClassificationError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClassificationError.js","sourceRoot":"","sources":["../../src/errors/ClassificationError.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,GAAsB,sBAAsB,CAAC;IACjD,WAAW,GAAG,IAAI,CAAC;IAE5B,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/errors/StreamError.d.ts

@@ -0,0 +1,11 @@
+import type { ArtifactErrorCode } from "../types/errors.js";
+/** Raised on transport/streaming failures. May or may not be recoverable. */
+export declare class StreamError extends Error {
+    readonly code: ArtifactErrorCode;
+    readonly recoverable: boolean;
+    constructor(message: string, options?: {
+        cause?: unknown;
+        recoverable?: boolean;
+    });
+}
+//# sourceMappingURL=StreamError.d.ts.map

package/dist/errors/StreamError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamError.d.ts","sourceRoot":"","sources":["../../src/errors/StreamError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,6EAA6E;AAC7E,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAkB;IAClD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;gBAG5B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE;CAMvD"}

package/dist/errors/StreamError.js

@@ -0,0 +1,11 @@
+/** Raised on transport/streaming failures. May or may not be recoverable. */
+export class StreamError extends Error {
+    code = "STREAM_ERROR";
+    recoverable;
+    constructor(message, options) {
+        super(message, options);
+        this.name = "StreamError";
+        this.recoverable = options?.recoverable ?? false;
+    }
+}
+//# sourceMappingURL=StreamError.js.map

package/dist/errors/StreamError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamError.js","sourceRoot":"","sources":["../../src/errors/StreamError.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,GAAsB,cAAc,CAAC;IACzC,WAAW,CAAU;IAE9B,YACE,OAAe,EACf,OAAoD;QAEpD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,KAAK,CAAC;IACnD,CAAC;CACF"}

package/dist/errors/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./ArtifactParseError.js";
+export * from "./StreamError.js";
+export * from "./ClassificationError.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,4 @@
+export * from "./ArtifactParseError.js";
+export * from "./StreamError.js";
+export * from "./ClassificationError.js";
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC"}

package/dist/iframe/HtmlArtifactCard.d.ts

@@ -0,0 +1,9 @@
+import type { HtmlArtifactCardProps } from "../types/client.js";
+/**
+ * The seamless artifact card: a refined header (window dots, segmented
+ * preview/code tabs, pill copy/download/fullscreen actions), a sandboxed iframe
+ * preview that streams in layer-by-layer, and a premium ring + layered-shadow
+ * frame. No flat white box, no host-CSS dependency.
+ */
+export declare function HtmlArtifactCard(props: HtmlArtifactCardProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=HtmlArtifactCard.d.ts.map

package/dist/iframe/HtmlArtifactCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlArtifactCard.d.ts","sourceRoot":"","sources":["../../src/iframe/HtmlArtifactCard.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAGV,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAI5B;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,2CA4N5D"}

package/dist/iframe/HtmlArtifactCard.js

@@ -0,0 +1,117 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { HtmlArtifactToolbar } from "./HtmlArtifactToolbar.js";
+import { HtmlArtifactPreview } from "./HtmlArtifactPreview.js";
+import { HtmlArtifactCodeView } from "./HtmlArtifactCodeView.js";
+import { HtmlArtifactModal } from "./HtmlArtifactModal.js";
+import { buildSrcDoc } from "./iframeSrcDoc.js";
+import { useArtifactStyles } from "./styles.js";
+const RADIUS = { md: 14, xl: 18, "2xl": 22, "3xl": 28 };
+/**
+ * The seamless artifact card: a refined header (window dots, segmented
+ * preview/code tabs, pill copy/download/fullscreen actions), a sandboxed iframe
+ * preview that streams in layer-by-layer, and a premium ring + layered-shadow
+ * frame. No flat white box, no host-CSS dependency.
+ */
+export function HtmlArtifactCard(props) {
+    useArtifactStyles();
+    const { artifact, variant = "elevated", radius = "2xl", showToolbar = true, defaultTab = "preview", allowFullscreen = true, allowCopy = true, allowDownload = true, allowPdf = true, presentation = "card", theme, previewOptions, className, } = props;
+    const [tab, setTab] = React.useState(defaultTab);
+    const [copied, setCopied] = React.useState(false);
+    const [fullscreen, setFullscreen] = React.useState(false);
+    const streaming = artifact.status === "streaming";
+    const errored = artifact.status === "error";
+    // While streaming, feed the raw growing HTML to the preview's progressive
+    // balancer (it repairs each partial frame into a valid, renderable document).
+    // The accumulated raw stream beats the server's coarser snapshots here; we
+    // fall back to a snapshot only if no raw deltas have arrived (buffered model).
+    const previewHtml = streaming
+        ? artifact.html || artifact.snapshot
+        : artifact.html || artifact.snapshot;
+    const sourceHtml = artifact.html || artifact.snapshot;
+    const onCopy = React.useCallback(() => {
+        if (typeof navigator === "undefined" || !navigator.clipboard)
+            return;
+        navigator.clipboard.writeText(sourceHtml).then(() => {
+            setCopied(true);
+            setTimeout(() => setCopied(false), 1600);
+        }, () => { });
+    }, [sourceHtml]);
+    const onDownload = React.useCallback(() => {
+        if (typeof document === "undefined")
+            return;
+        const blob = new Blob([sourceHtml], { type: "text/html;charset=utf-8" });
+        const url = URL.createObjectURL(blob);
+        const a = document.createElement("a");
+        const safeName = artifact.title.replace(/[^a-z0-9-_]+/gi, "-").toLowerCase() || "artifact";
+        a.href = url;
+        a.download = `${safeName}.html`;
+        document.body.appendChild(a);
+        a.click();
+        a.remove();
+        URL.revokeObjectURL(url);
+    }, [sourceHtml, artifact.title]);
+    // Export to PDF via the browser's native print pipeline ("Save as PDF").
+    // Renders the sanitized artifact into a hidden, same-origin iframe and prints
+    // just that frame — no extra dependencies, no scripts in the printed output.
+    const onDownloadPdf = React.useCallback(() => {
+        if (typeof document === "undefined" || !sourceHtml)
+            return;
+        const printable = buildSrcDoc(sourceHtml, {
+            sanitize: true,
+            seamless: false,
+            sanitizeOptions: previewOptions,
+        });
+        const frame = document.createElement("iframe");
+        Object.assign(frame.style, {
+            position: "fixed",
+            right: "0",
+            bottom: "0",
+            width: "0",
+            height: "0",
+            border: "0",
+            opacity: "0",
+        });
+        frame.setAttribute("aria-hidden", "true");
+        frame.title = `${artifact.title} (PDF)`;
+        frame.srcdoc = printable;
+        const remove = () => {
+            if (document.body.contains(frame))
+                frame.remove();
+        };
+        frame.onload = () => {
+            const win = frame.contentWindow;
+            if (!win)
+                return remove();
+            win.addEventListener?.("afterprint", () => setTimeout(remove, 300));
+            try {
+                win.focus();
+                win.print();
+            }
+            catch {
+                remove();
+            }
+            // Safety net if afterprint never fires (some browsers).
+            setTimeout(remove, 60_000);
+        };
+        document.body.appendChild(frame);
+    }, [sourceHtml, artifact.title, previewOptions]);
+    // Seamless ("camouflage") presentation: a transparent, chromeless iframe that
+    // sits inline like native chat content — no card frame, no window, no border.
+    // A faint action row appears only on hover so the clean UI stays clean.
+    if (presentation === "seamless") {
+        return (_jsxs("div", { className: `aha-scope${className ? ` ${className}` : ""}`, children: [_jsxs("div", { className: "aha-seamless", children: [_jsx(HtmlArtifactPreview, { html: previewHtml, streaming: streaming, errored: errored, title: artifact.title, theme: theme, bare: true, options: { minHeight: 0, ...previewOptions } }), showToolbar && !streaming && (_jsxs("div", { className: "aha-seamless-actions", children: [allowCopy && (_jsx("button", { type: "button", className: "aha-iconbtn", onClick: onCopy, title: "Copy HTML", "aria-label": "Copy HTML", children: copied ? CHECK_ICON : COPY_ICON })), allowPdf && (_jsx("button", { type: "button", className: "aha-iconbtn", onClick: onDownloadPdf, title: "Download PDF", "aria-label": "Download PDF", children: PDF_ICON })), allowFullscreen && (_jsx("button", { type: "button", className: "aha-iconbtn", onClick: () => setFullscreen(true), title: "Fullscreen", "aria-label": "Fullscreen", children: EXPAND_ICON }))] }))] }), allowFullscreen && (_jsx(HtmlArtifactModal, { open: fullscreen, onClose: () => setFullscreen(false), title: artifact.title, children: _jsx(HtmlArtifactPreview, { html: previewHtml, streaming: streaming, errored: errored, title: artifact.title, theme: theme, options: { ...previewOptions, autoResize: false, minHeight: 640, maxHeight: 100000 } }) }))] }));
+    }
+    return (_jsxs("div", { className: `aha-scope${className ? ` ${className}` : ""}`, children: [_jsxs("div", { className: "aha-card", "data-variant": variant, style: { ["--aha-radius"]: `${RADIUS[radius]}px` }, children: [showToolbar && (_jsx(HtmlArtifactToolbar, { title: artifact.title, tab: tab, onTabChange: setTab, allowCopy: allowCopy, allowDownload: allowDownload, allowPdf: allowPdf, allowFullscreen: allowFullscreen, copied: copied, streaming: streaming, onCopy: onCopy, onDownload: onDownload, onDownloadPdf: onDownloadPdf, onFullscreen: () => setFullscreen(true) })), tab === "preview" ? (_jsx(HtmlArtifactPreview, { html: previewHtml, streaming: streaming, errored: errored, title: artifact.title, theme: theme, options: previewOptions })) : (_jsx(HtmlArtifactCodeView, { html: sourceHtml, maxHeight: previewOptions?.maxHeight ?? 900 }))] }), allowFullscreen && (_jsx(HtmlArtifactModal, { open: fullscreen, onClose: () => setFullscreen(false), title: artifact.title, children: _jsx(HtmlArtifactPreview, { html: previewHtml, streaming: streaming, errored: errored, title: artifact.title, theme: theme, options: {
+                        ...previewOptions,
+                        autoResize: false,
+                        minHeight: 640,
+                        maxHeight: 100000,
+                    } }) }))] }));
+}
+const COPY_ICON = (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": true, children: [_jsx("rect", { x: "9", y: "9", width: "13", height: "13", rx: "2.5" }), _jsx("path", { d: "M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" })] }));
+const CHECK_ICON = (_jsx("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.6", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": true, children: _jsx("polyline", { points: "20 6 9 17 4 12" }) }));
+const EXPAND_ICON = (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": true, children: [_jsx("polyline", { points: "15 3 21 3 21 9" }), _jsx("polyline", { points: "9 21 3 21 3 15" }), _jsx("line", { x1: "21", y1: "3", x2: "14", y2: "10" }), _jsx("line", { x1: "3", y1: "21", x2: "10", y2: "14" })] }));
+const PDF_ICON = (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": true, children: [_jsx("path", { d: "M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z" }), _jsx("polyline", { points: "14 2 14 8 20 8" }), _jsx("path", { d: "M9 15h1.2a1.3 1.3 0 0 0 0-2.6H9V18" }), _jsx("path", { d: "M15.5 12.4H14V18" }), _jsx("path", { d: "M14 15.4h1.3" })] }));
+//# sourceMappingURL=HtmlArtifactCard.js.map