netra-artifacts 0.1.0-alpha.0

package/dist/artifacts/htmlArtifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"htmlArtifact.d.ts","sourceRoot":"","sources":["../../src/artifacts/htmlArtifact.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEzE,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB,GAAG,YAAY,CAYf;AAED,gEAAgE;AAChE,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC,GAC9D,YAAY,CAEd"}

package/dist/artifacts/htmlArtifact.js

@@ -0,0 +1,20 @@
+import { ARTIFACT_STATUS } from "./artifactStatus.js";
+/** Create a fresh artifact record in the `streaming` state. */
+export function createHtmlArtifact(params) {
+    const now = Date.now();
+    return {
+        id: params.id,
+        title: params.title ?? "Untitled artifact",
+        type: "html",
+        html: "",
+        snapshot: "",
+        status: params.status ?? ARTIFACT_STATUS.STREAMING,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+/** Immutably apply a partial update, refreshing `updatedAt`. */
+export function updateHtmlArtifact(artifact, patch) {
+    return { ...artifact, ...patch, updatedAt: Date.now() };
+}
+//# sourceMappingURL=htmlArtifact.js.map

package/dist/artifacts/htmlArtifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"htmlArtifact.js","sourceRoot":"","sources":["../../src/artifacts/htmlArtifact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,+DAA+D;AAC/D,MAAM,UAAU,kBAAkB,CAAC,MAIlC;IACC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,mBAAmB;QAC1C,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,EAAE;QACR,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,eAAe,CAAC,SAAS;QAClD,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;KACf,CAAC;AACJ,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,kBAAkB,CAChC,QAAsB,EACtB,KAA+D;IAE/D,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;AAC1D,CAAC"}

package/dist/artifacts/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./artifactEnvelope.js";
+export * from "./artifactStatus.js";
+export * from "./htmlArtifact.js";
+export * from "./artifactStore.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/artifacts/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}

package/dist/artifacts/index.js

@@ -0,0 +1,5 @@
+export * from "./artifactEnvelope.js";
+export * from "./artifactStatus.js";
+export * from "./htmlArtifact.js";
+export * from "./artifactStore.js";
+//# sourceMappingURL=index.js.map

package/dist/artifacts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/artifacts/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}

package/dist/circuit-breaker/circuitBreaker.d.ts

@@ -0,0 +1,35 @@
+import { type CircuitStore } from "./memoryCircuitStore.js";
+export type CircuitStatus = "closed" | "open" | "half-open";
+export interface CircuitBreakerOptions {
+    key?: string;
+    failureThreshold?: number;
+    windowMs?: number;
+    cooldownMs?: number;
+    store?: CircuitStore;
+    now?: () => number;
+}
+/**
+ * A deliberately small circuit breaker. After `failureThreshold` failures
+ * within `windowMs`, the circuit opens and `allowRequest()` returns false for
+ * `cooldownMs`. After cooldown it goes half-open and permits a single trial;
+ * a success closes it, a failure re-opens it.
+ *
+ * The server uses this to fall back to markdown when HTML generation keeps
+ * failing, instead of repeatedly hammering a broken path.
+ */
+export declare class CircuitBreaker {
+    private readonly key;
+    private readonly failureThreshold;
+    private readonly windowMs;
+    private readonly cooldownMs;
+    private readonly store;
+    private readonly now;
+    constructor(options?: CircuitBreakerOptions);
+    status(): CircuitStatus;
+    /** True if a request may proceed right now. */
+    allowRequest(): boolean;
+    recordSuccess(): void;
+    recordFailure(): void;
+    reset(): void;
+}
+//# sourceMappingURL=circuitBreaker.d.ts.map

package/dist/circuit-breaker/circuitBreaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuitBreaker.d.ts","sourceRoot":"","sources":["../../src/circuit-breaker/circuitBreaker.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEvB,OAAO,GAAE,qBAA0B;IAU/C,MAAM,IAAI,aAAa;IAOvB,+CAA+C;IAC/C,YAAY,IAAI,OAAO;IAIvB,aAAa,IAAI,IAAI;IAIrB,aAAa,IAAI,IAAI;IAkBrB,KAAK,IAAI,IAAI;CAGd"}

package/dist/circuit-breaker/circuitBreaker.js

@@ -0,0 +1,59 @@
+import { CIRCUIT_BREAKER_DEFAULTS } from "../constants/defaults.js";
+import { defaultCircuitStore, } from "./memoryCircuitStore.js";
+/**
+ * A deliberately small circuit breaker. After `failureThreshold` failures
+ * within `windowMs`, the circuit opens and `allowRequest()` returns false for
+ * `cooldownMs`. After cooldown it goes half-open and permits a single trial;
+ * a success closes it, a failure re-opens it.
+ *
+ * The server uses this to fall back to markdown when HTML generation keeps
+ * failing, instead of repeatedly hammering a broken path.
+ */
+export class CircuitBreaker {
+    key;
+    failureThreshold;
+    windowMs;
+    cooldownMs;
+    store;
+    now;
+    constructor(options = {}) {
+        this.key = options.key ?? "default";
+        this.failureThreshold =
+            options.failureThreshold ?? CIRCUIT_BREAKER_DEFAULTS.failureThreshold;
+        this.windowMs = options.windowMs ?? CIRCUIT_BREAKER_DEFAULTS.windowMs;
+        this.cooldownMs = options.cooldownMs ?? CIRCUIT_BREAKER_DEFAULTS.cooldownMs;
+        this.store = options.store ?? defaultCircuitStore;
+        this.now = options.now ?? Date.now;
+    }
+    status() {
+        const state = this.store.load(this.key);
+        if (state.openedAt === null)
+            return "closed";
+        if (this.now() - state.openedAt >= this.cooldownMs)
+            return "half-open";
+        return "open";
+    }
+    /** True if a request may proceed right now. */
+    allowRequest() {
+        return this.status() !== "open";
+    }
+    recordSuccess() {
+        this.store.save(this.key, { failures: [], openedAt: null });
+    }
+    recordFailure() {
+        const t = this.now();
+        const state = this.store.load(this.key);
+        // If we were half-open, a failure immediately re-opens.
+        if (state.openedAt !== null && t - state.openedAt >= this.cooldownMs) {
+            this.store.save(this.key, { failures: [t], openedAt: t });
+            return;
+        }
+        const failures = [...state.failures, t].filter((ts) => t - ts < this.windowMs);
+        const openedAt = failures.length >= this.failureThreshold ? t : state.openedAt;
+        this.store.save(this.key, { failures, openedAt });
+    }
+    reset() {
+        this.store.save(this.key, { failures: [], openedAt: null });
+    }
+}
+//# sourceMappingURL=circuitBreaker.js.map

package/dist/circuit-breaker/circuitBreaker.js.map

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

package/dist/circuit-breaker/index.d.ts

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

package/dist/circuit-breaker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/circuit-breaker/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC"}

package/dist/circuit-breaker/index.js

@@ -0,0 +1,3 @@
+export * from "./circuitBreaker.js";
+export * from "./memoryCircuitStore.js";
+//# sourceMappingURL=index.js.map

package/dist/circuit-breaker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/circuit-breaker/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC"}

package/dist/circuit-breaker/memoryCircuitStore.d.ts

@@ -0,0 +1,24 @@
+/** State shared between the breaker and its backing store. */
+export interface CircuitState {
+    /** Timestamps (ms) of recent failures within the rolling window. */
+    failures: number[];
+    /** When the circuit was opened (ms), or null if closed. */
+    openedAt: number | null;
+}
+/**
+ * Pluggable storage for circuit state. The default is process-memory, keyed by
+ * a string (e.g. per-route). Swap in a Redis-backed implementation for
+ * multi-instance deployments.
+ */
+export interface CircuitStore {
+    load(key: string): CircuitState;
+    save(key: string, state: CircuitState): void;
+}
+export declare class MemoryCircuitStore implements CircuitStore {
+    private states;
+    load(key: string): CircuitState;
+    save(key: string, state: CircuitState): void;
+}
+/** Shared default store instance. */
+export declare const defaultCircuitStore: MemoryCircuitStore;
+//# sourceMappingURL=memoryCircuitStore.d.ts.map

package/dist/circuit-breaker/memoryCircuitStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryCircuitStore.d.ts","sourceRoot":"","sources":["../../src/circuit-breaker/memoryCircuitStore.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC;IAChC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;CAC9C;AAED,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,MAAM,CAAmC;IAEjD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY;IAI/B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;CAG7C;AAED,qCAAqC;AACrC,eAAO,MAAM,mBAAmB,oBAA2B,CAAC"}

package/dist/circuit-breaker/memoryCircuitStore.js

@@ -0,0 +1,12 @@
+export class MemoryCircuitStore {
+    states = new Map();
+    load(key) {
+        return this.states.get(key) ?? { failures: [], openedAt: null };
+    }
+    save(key, state) {
+        this.states.set(key, state);
+    }
+}
+/** Shared default store instance. */
+export const defaultCircuitStore = new MemoryCircuitStore();
+//# sourceMappingURL=memoryCircuitStore.js.map

package/dist/circuit-breaker/memoryCircuitStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryCircuitStore.js","sourceRoot":"","sources":["../../src/circuit-breaker/memoryCircuitStore.ts"],"names":[],"mappings":"AAkBA,MAAM,OAAO,kBAAkB;IACrB,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEjD,IAAI,CAAC,GAAW;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAClE,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,KAAmB;QACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,qCAAqC;AACrC,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,kBAAkB,EAAE,CAAC"}

package/dist/classifier/classifierPrompt.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The classifier prompt. The model must return ONLY JSON of the shape
+ * `{ "mode": "markdown" | "artifact" | "generative_ui", "reason": "short reason" }`.
+ */
+export declare const CLASSIFIER_SYSTEM_PROMPT = "You are a routing classifier for an AI assistant that can answer in three ways:\n\n1. \"markdown\" \u2014 a normal text/markdown chat answer.\n2. \"artifact\" \u2014 a standalone, self-contained, STATIC HTML/CSS document rendered in a framed preview card (no JavaScript).\n3. \"generative_ui\" \u2014 a chromeless, transparent, STATIC HTML/CSS UI rendered inline so it blends with the host app (no JavaScript).\n\nDecide which mode best serves the user's most recent request.\n\nChoose \"markdown\" when text is enough:\n- explanations, Q&A, definitions, summaries\n- debugging help, error analysis, code review\n- writing code, functions, queries, scripts\n- system design, architecture, best practices, advice\n- comparisons that read fine as prose or a small table\n- general writing and conversation\n\nChoose \"artifact\" when a visual, standalone document/page adds real value:\n- standalone forms (sign-up, login, contact, survey)\n- landing pages, hero sections, pricing cards, product pages\n- dashboards, stat grids, report/stat visualizations\n- invoices, receipts, certificates, resumes/CVs\n- email/newsletter templates\n- profile/business cards, onboarding screens\n- comparison cards, timelines, funnels, galleries\n- CSS/SVG charts (bar, line, donut, progress) when the user wants a visual\n\nChoose \"generative_ui\" when the user specifically wants UI that should feel native/inline in the host app:\n- generative UI, inline UI, seamless/camouflaged/native UI\n- widgets, components, interface states, UI kits/systems, component variations\n- app/interface prototypes or explorations intended to sit inside the chat surface\n\nBe conservative: if the request is primarily about understanding, reasoning, or code, prefer \"markdown\". Do not pick an HTML mode just because a topic could be visualized \u2014 only when the user actually wants a rendered UI/document.\n\nReturn ONLY minified JSON, no prose, no code fences:\n{\"mode\":\"markdown\"|\"artifact\"|\"generative_ui\",\"reason\":\"short reason\"}";
+export declare function buildClassifierUserPrompt(query: string): string;
+//# sourceMappingURL=classifierPrompt.d.ts.map

package/dist/classifier/classifierPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifierPrompt.d.ts","sourceRoot":"","sources":["../../src/classifier/classifierPrompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,wBAAwB,2+DAkCkC,CAAC;AAExE,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D"}

package/dist/classifier/classifierPrompt.js

@@ -0,0 +1,43 @@
+/**
+ * The classifier prompt. The model must return ONLY JSON of the shape
+ * `{ "mode": "markdown" | "artifact" | "generative_ui", "reason": "short reason" }`.
+ */
+export const CLASSIFIER_SYSTEM_PROMPT = `You are a routing classifier for an AI assistant that can answer in three ways:
+
+1. "markdown" — a normal text/markdown chat answer.
+2. "artifact" — a standalone, self-contained, STATIC HTML/CSS document rendered in a framed preview card (no JavaScript).
+3. "generative_ui" — a chromeless, transparent, STATIC HTML/CSS UI rendered inline so it blends with the host app (no JavaScript).
+
+Decide which mode best serves the user's most recent request.
+
+Choose "markdown" when text is enough:
+- explanations, Q&A, definitions, summaries
+- debugging help, error analysis, code review
+- writing code, functions, queries, scripts
+- system design, architecture, best practices, advice
+- comparisons that read fine as prose or a small table
+- general writing and conversation
+
+Choose "artifact" when a visual, standalone document/page adds real value:
+- standalone forms (sign-up, login, contact, survey)
+- landing pages, hero sections, pricing cards, product pages
+- dashboards, stat grids, report/stat visualizations
+- invoices, receipts, certificates, resumes/CVs
+- email/newsletter templates
+- profile/business cards, onboarding screens
+- comparison cards, timelines, funnels, galleries
+- CSS/SVG charts (bar, line, donut, progress) when the user wants a visual
+
+Choose "generative_ui" when the user specifically wants UI that should feel native/inline in the host app:
+- generative UI, inline UI, seamless/camouflaged/native UI
+- widgets, components, interface states, UI kits/systems, component variations
+- app/interface prototypes or explorations intended to sit inside the chat surface
+
+Be conservative: if the request is primarily about understanding, reasoning, or code, prefer "markdown". Do not pick an HTML mode just because a topic could be visualized — only when the user actually wants a rendered UI/document.
+
+Return ONLY minified JSON, no prose, no code fences:
+{"mode":"markdown"|"artifact"|"generative_ui","reason":"short reason"}`;
+export function buildClassifierUserPrompt(query) {
+    return `Classify this request:\n\n"""${query}"""\n\nReturn only the JSON object.`;
+}
+//# sourceMappingURL=classifierPrompt.js.map

package/dist/classifier/classifierPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifierPrompt.js","sourceRoot":"","sources":["../../src/classifier/classifierPrompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uEAkC+B,CAAC;AAExE,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,OAAO,gCAAgC,KAAK,qCAAqC,CAAC;AACpF,CAAC"}

package/dist/classifier/classifyMode.d.ts

@@ -0,0 +1,21 @@
+import type { ArtifactMode } from "../types/stream.js";
+import type { GenerateText } from "../types/server.js";
+export interface ClassificationResult {
+    mode: ArtifactMode;
+    reason: string;
+    /** Whether the decision came from the model or the heuristic fallback. */
+    source: "model" | "rules";
+}
+export interface ClassifyModeParams {
+    query: string;
+    generateText?: GenerateText;
+    temperature?: number;
+    abortSignal?: AbortSignal;
+}
+/**
+ * Classify a request as `markdown`, `artifact`, or `generative_ui`. Tries the
+ * model first and fails open to deterministic rules on any error or malformed output.
+ * Never throws — routing must always resolve.
+ */
+export declare function classifyMode(params: ClassifyModeParams): Promise<ClassificationResult>;
+//# sourceMappingURL=classifyMode.d.ts.map

package/dist/classifier/classifyMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifyMode.d.ts","sourceRoot":"","sources":["../../src/classifier/classifyMode.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAmC/B"}

package/dist/classifier/classifyMode.js

@@ -0,0 +1,50 @@
+import { CLASSIFIER_SYSTEM_PROMPT, buildClassifierUserPrompt, } from "./classifierPrompt.js";
+import { classifyByRules } from "./rules.js";
+import { safeJsonParse } from "../utils/safeJsonParse.js";
+/**
+ * Classify a request as `markdown`, `artifact`, or `generative_ui`. Tries the
+ * model first and fails open to deterministic rules on any error or malformed output.
+ * Never throws — routing must always resolve.
+ */
+export async function classifyMode(params) {
+    const { generateText, query, temperature = 0, abortSignal } = params;
+    const fallback = classifyByRules(query);
+    if ((fallback.mode === "artifact" || fallback.mode === "generative_ui") &&
+        fallback.confidence >= 0.65) {
+        return { ...fallback, source: "rules" };
+    }
+    if (!generateText)
+        return { ...fallback, source: "rules" };
+    try {
+        const text = await generateText({
+            temperature,
+            system: CLASSIFIER_SYSTEM_PROMPT,
+            prompt: buildClassifierUserPrompt(query),
+            abortSignal,
+        });
+        const parsed = safeJsonParse(text, {});
+        const parsedMode = normalizeClassificationMode(parsed.mode);
+        if (parsedMode) {
+            return {
+                mode: parsedMode,
+                reason: parsed.reason?.slice(0, 200) ?? "model classification",
+                source: "model",
+            };
+        }
+        return { ...fallback, source: "rules" };
+    }
+    catch {
+        return { ...fallback, source: "rules" };
+    }
+}
+function normalizeClassificationMode(mode) {
+    if (mode === "markdown" ||
+        mode === "artifact" ||
+        mode === "generative_ui") {
+        return mode;
+    }
+    if (mode === "html_artifact")
+        return "artifact";
+    return null;
+}
+//# sourceMappingURL=classifyMode.js.map

package/dist/classifier/classifyMode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifyMode.js","sourceRoot":"","sources":["../../src/classifier/classifyMode.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAkB1D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAA0B;IAE1B,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,GAAG,CAAC,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IACrE,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAExC,IACE,CAAC,QAAQ,CAAC,IAAI,KAAK,UAAU,IAAI,QAAQ,CAAC,IAAI,KAAK,eAAe,CAAC;QACnE,QAAQ,CAAC,UAAU,IAAI,IAAI,EAC3B,CAAC;QACD,OAAO,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC1C,CAAC;IAED,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAE3D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC;YAC9B,WAAW;YACX,MAAM,EAAE,wBAAwB;YAChC,MAAM,EAAE,yBAAyB,CAAC,KAAK,CAAC;YACxC,WAAW;SACZ,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,aAAa,CAAqC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC3E,MAAM,UAAU,GAAG,2BAA2B,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5D,IAAI,UAAU,EAAE,CAAC;YACf,OAAO;gBACL,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,sBAAsB;gBAC9D,MAAM,EAAE,OAAO;aAChB,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,SAAS,2BAA2B,CAAC,IAAa;IAChD,IACE,IAAI,KAAK,UAAU;QACnB,IAAI,KAAK,UAAU;QACnB,IAAI,KAAK,eAAe,EACxB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAK,IAAwB,KAAK,eAAe;QAAE,OAAO,UAAU,CAAC;IACrE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/classifier/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./rules.js";
+export * from "./classifierPrompt.js";
+export * from "./classifyMode.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/classifier/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}

package/dist/classifier/index.js

@@ -0,0 +1,4 @@
+export * from "./rules.js";
+export * from "./classifierPrompt.js";
+export * from "./classifyMode.js";
+//# sourceMappingURL=index.js.map

package/dist/classifier/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/classifier/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}

package/dist/classifier/rules.d.ts

@@ -0,0 +1,13 @@
+import type { ArtifactMode } from "../types/stream.js";
+export interface RuleClassification {
+    mode: ArtifactMode;
+    reason: string;
+    /** 0..1 — how confident the heuristic is. */
+    confidence: number;
+}
+/**
+ * Cheap, deterministic classification used as a pre-check and as a fallback
+ * when model-based classification is unavailable or fails.
+ */
+export declare function classifyByRules(query: string): RuleClassification;
+//# sourceMappingURL=rules.d.ts.map

package/dist/classifier/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/classifier/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;CACpB;AA6ED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAwCjE"}

package/dist/classifier/rules.js

@@ -0,0 +1,118 @@
+/**
+ * Phrases that strongly suggest a visual, self-contained HTML/CSS preview adds
+ * real value over plain text.
+ */
+const VISUAL_SIGNALS = [
+    /\blanding\s*page\b/i,
+    /\bdashboard\b/i,
+    /\binvoice\b/i,
+    /\breceipt\b/i,
+    /\bresume\b|\bcv\b/i,
+    /\bemail\s*template\b/i,
+    /\bpricing\s*(card|table|page)\b/i,
+    /\bproduct\s*(page|card)\b/i,
+    /\bprofile\s*card\b/i,
+    /\bbusiness\s*card\b/i,
+    /\bonboarding\s*(screen|flow)\b/i,
+    /\b(ui|html)\s*(mockup|preview|layout|design)\b/i,
+    /\bcomparison\s*(table|view|cards?)\b/i,
+    /\bstat(s|istic)?\s*(card|view|grid)\b/i,
+    /\bportfolio\b/i,
+    /\bnewsletter\b/i,
+    /\bgenerative\s*ui\b/i,
+    /\b(interface|ui)\s*(kit|system|concept|exploration|variations?|combinations?)\b/i,
+    /\b(combinations?|variations?|states?)\b[\s\S]*\b(ui|interface|layout|screen|component)\b/i,
+    /\bbeautiful\b[\s\S]*\b(ui|interface|layout|screen|component|dashboard|page)\b/i,
+    /\bstatic\s*(app|interface|experience|prototype)\b/i,
+    /\bvisual\s*(prototype|concept|system|kit|exploration)\b/i,
+    /\bcertificate\b/i,
+    /\bmenu\b.*\b(restaurant|cafe|food)\b/i,
+    /\btimeline\b/i,
+    /\bgallery\b/i,
+    /\b(bar|line|pie|donut|doughnut)\s*chart\b/i,
+    /\b(report|stats?)\s*(visuali[sz]ation|view)\b/i,
+    /\bsign[\s-]?up\s*form\b|\blogin\s*form\b|\bcontact\s*form\b/i,
+    /\b(build|create|make|generate|design|render|show me|mock up|wireframe)\b[\s\S]*\b(page|form|card|table|layout|widget|view|screen|template|ui|website|webpage|section|hero|banner)\b/i,
+    /\b(build|create|make|generate|design|render|show me|mock up|wireframe)\b[\s\S]*\b(app|interface|component|prototype|artifact|visual)\b/i,
+];
+/**
+ * Requests that should blend into the host chat/application rather than render
+ * as a standalone document card.
+ */
+const GENERATIVE_UI_SIGNALS = [
+    /\bgenerative\s*ui\b/i,
+    /\bcamouflage\b/i,
+    /\btransparent\b/i,
+    /\bshowcase\b/i,
+    /\bblend(s|ing)?\s*(in|into|with)?\b[\s\S]*\b(chat|host|ui|app)\b/i,
+    /\bsit(s|ting)?\s*(on|in|inside)\b[\s\S]*\b(chat|host|app|page)\b/i,
+    /\binline\s*(ui|interface|component|artifact|preview)\b/i,
+    /\b(seamless|camouflage|native|chromeless)\s*(ui|interface|component|artifact|preview|gen|generation)?\b/i,
+    /\b(component|widget)\b/i,
+    /\b(app|interface)\s*(prototype|concept|exploration|variations?|states?)\b/i,
+    /\b(ui|interface)\s*(kit|system|concept|exploration|variations?|combinations?)\b/i,
+    /\b(combinations?|variations?|states?)\b[\s\S]*\b(ui|interface|screen|component)\b/i,
+    /\ball\s+(the\s+)?(combinations?|variations?|components?|states?)\b/i,
+    /\bstatic\s*(app|interface|experience|prototype)\b/i,
+    /\bvisual\s*(prototype|concept|system|kit|exploration)\b/i,
+];
+/** Phrases that strongly suggest a text answer is the right output. */
+const TEXTUAL_SIGNALS = [
+    /\bexplain\b|\bexplanation\b/i,
+    /\bwhy\b|\bhow\s+(do|does|can|should|would|to)\b/i,
+    /\bwhat\s+is\b|\bwhat\s+are\b|\bwhat'?s\b/i,
+    /\bdebug\b|\bfix\b|\berror\b|\bstack\s*trace\b|\bexception\b/i,
+    /\bdifference\s+between\b|\bcompare\b(?!.*\bcards?\b)/i,
+    /\barchitecture\b|\bsystem\s*design\b|\bdesign\s*pattern\b/i,
+    /\bbest\s*practice\b|\badvice\b|\brecommend\b|\bshould\s+i\b/i,
+    /\brefactor\b|\boptimi[sz]e\b|\bperformance\b/i,
+    /\bwrite\s+(a\s+)?(function|class|script|query|regex|algorithm|sql|test)\b/i,
+    /\bsummari[sz]e\b|\bdefine\b|\bmeaning\s+of\b/i,
+    /\bpros\s+and\s+cons\b|\btrade[\s-]?offs?\b/i,
+];
+/**
+ * Cheap, deterministic classification used as a pre-check and as a fallback
+ * when model-based classification is unavailable or fails.
+ */
+export function classifyByRules(query) {
+    const text = (query ?? "").trim();
+    if (!text) {
+        return { mode: "markdown", reason: "Empty query", confidence: 0.5 };
+    }
+    let visual = 0;
+    let generative = 0;
+    let textual = 0;
+    for (const re of VISUAL_SIGNALS)
+        if (re.test(text))
+            visual++;
+    for (const re of GENERATIVE_UI_SIGNALS)
+        if (re.test(text))
+            generative++;
+    for (const re of TEXTUAL_SIGNALS)
+        if (re.test(text))
+            textual++;
+    if (visual === 0 && generative === 0 && textual === 0) {
+        return {
+            mode: "markdown",
+            reason: "No strong visual signal; defaulting to text",
+            confidence: 0.4,
+        };
+    }
+    if (visual > textual || generative > textual) {
+        return {
+            mode: generative > 0 ? "generative_ui" : "artifact",
+            reason: generative > 0
+                ? `Matched ${generative} generative UI signal(s)`
+                : `Matched ${visual} visual signal(s)`,
+            confidence: Math.min(0.5 + 0.15 * Math.max(visual, generative - textual), 0.95),
+        };
+    }
+    return {
+        mode: "markdown",
+        reason: textual >= visual
+            ? `Matched ${textual} textual signal(s)`
+            : "Leaning textual",
+        confidence: Math.min(0.5 + 0.15 * (textual - visual), 0.95),
+    };
+}
+//# sourceMappingURL=rules.js.map

package/dist/classifier/rules.js.map

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

package/dist/client/ArtifactChat.d.ts

@@ -0,0 +1,15 @@
+import * as React from "react";
+import type { HtmlArtifactCardProps, UseArtifactStreamOptions } from "../types/client.js";
+export interface ArtifactChatProps extends UseArtifactStreamOptions {
+    placeholder?: string;
+    emptyState?: React.ReactNode;
+    cardProps?: Partial<Omit<HtmlArtifactCardProps, "artifact">>;
+    className?: string;
+}
+/**
+ * A batteries-included chat surface: message list, streaming status, and a
+ * composer. Drop it in with just an `endpoint` to get the full experience, or
+ * compose `useArtifactStream` + `ArtifactMessage` yourself for custom layouts.
+ */
+export declare function ArtifactChat(props: ArtifactChatProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ArtifactChat.d.ts.map

package/dist/client/ArtifactChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactChat.d.ts","sourceRoot":"","sources":["../../src/client/ArtifactChat.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE1F,MAAM,WAAW,iBAAkB,SAAQ,wBAAwB;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,UAAU,CAAC,CAAC,CAAC;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,2CAgGpD"}

package/dist/client/ArtifactChat.js

@@ -0,0 +1,62 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { useArtifactStream } from "./useArtifactStream.js";
+import { ArtifactMessage } from "./ArtifactMessage.js";
+/**
+ * A batteries-included chat surface: message list, streaming status, and a
+ * composer. Drop it in with just an `endpoint` to get the full experience, or
+ * compose `useArtifactStream` + `ArtifactMessage` yourself for custom layouts.
+ */
+export function ArtifactChat(props) {
+    const { placeholder = "Ask anything, or describe a UI to generate…", emptyState, cardProps, className, ...streamOptions } = props;
+    const { messages, artifacts, status, sendMessage, stop } = useArtifactStream(streamOptions);
+    const [input, setInput] = React.useState("");
+    const scrollRef = React.useRef(null);
+    const busy = status === "submitted" || status === "streaming";
+    React.useEffect(() => {
+        scrollRef.current?.scrollTo({ top: scrollRef.current.scrollHeight, behavior: "smooth" });
+    }, [messages, artifacts]);
+    const submit = (e) => {
+        e.preventDefault();
+        const text = input;
+        setInput("");
+        void sendMessage(text);
+    };
+    return (_jsxs("div", { className: className, style: {
+            display: "flex",
+            flexDirection: "column",
+            height: "100%",
+            minHeight: 0,
+            fontFamily: 'Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif',
+            color: "var(--aha-fg, #1f2430)",
+        }, children: [_jsxs("div", { ref: scrollRef, style: { flex: 1, minHeight: 0, overflowY: "auto", padding: "8px 4px" }, children: [messages.length === 0 &&
+                        (emptyState ?? (_jsx("div", { style: { textAlign: "center", color: "#9ca3af", padding: "48px 16px", fontSize: 14 }, children: "Start the conversation \u2014 try \u201Cexplain CSS grid\u201D or \u201Ca pricing page for a SaaS\u201D." }))), messages.map((message) => (_jsx(ArtifactMessage, { message: message, artifacts: artifacts, cardProps: cardProps }, message.id))), status === "submitted" && (_jsx("div", { style: { color: "#9ca3af", fontSize: 13, padding: "6px 2px" }, children: "Thinking\u2026" }))] }), _jsxs("form", { onSubmit: submit, style: {
+                    display: "flex",
+                    gap: 8,
+                    padding: 10,
+                    borderTop: "1px solid rgba(0,0,0,0.08)",
+                }, children: [_jsx("input", { value: input, onChange: (e) => setInput(e.target.value), placeholder: placeholder, "aria-label": "Message", style: {
+                            flex: 1,
+                            border: "1px solid rgba(0,0,0,0.14)",
+                            borderRadius: 12,
+                            padding: "11px 14px",
+                            fontSize: 14.5,
+                            outline: "none",
+                            background: "#fff",
+                        } }), busy ? (_jsx("button", { type: "button", onClick: stop, style: btn("#ef4444"), children: "Stop" })) : (_jsx("button", { type: "submit", disabled: !input.trim(), style: btn("#2563eb", !input.trim()), children: "Send" }))] })] }));
+}
+function btn(bg, disabled = false) {
+    return {
+        border: "none",
+        borderRadius: 12,
+        padding: "0 18px",
+        fontSize: 14.5,
+        fontWeight: 600,
+        color: "#fff",
+        background: bg,
+        cursor: disabled ? "not-allowed" : "pointer",
+        opacity: disabled ? 0.5 : 1,
+    };
+}
+//# sourceMappingURL=ArtifactChat.js.map

package/dist/client/ArtifactChat.js.map

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