@denarolabs/email-template 1.0.5

package/dist/components/ai-email-editor/view-html-modal.d.ts

@@ -0,0 +1,9 @@
+import type { AIEmailEditorErrorContext, AIEmailEditorSuccessContext } from "../../types";
+export declare function ViewHtmlModal({ open, onOpenChange, getHtml, downloadFileName, onError, onSuccess, }: {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    getHtml: () => string;
+    downloadFileName: string;
+    onError: (error: Error, context: AIEmailEditorErrorContext) => void;
+    onSuccess?: (context: AIEmailEditorSuccessContext) => void;
+}): import("react").JSX.Element;

package/dist/components/ai-email-editor/view-html-modal.js

@@ -0,0 +1,37 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Copy, Download } from "lucide-react";
+import { useEffect, useState } from "react";
+import { Button } from "../../ui/button";
+import { Dialog, DialogContent, DialogFooter, DialogTitle, } from "../../ui/dialog";
+import { Textarea } from "../../ui/textarea";
+export function ViewHtmlModal({ open, onOpenChange, getHtml, downloadFileName, onError, onSuccess, }) {
+    const [html, setHtml] = useState("");
+    useEffect(() => {
+        if (open)
+            setHtml(getHtml());
+    }, [open, getHtml]);
+    const handleCopy = async () => {
+        if (!html)
+            return;
+        try {
+            await navigator.clipboard.writeText(html);
+            onSuccess?.({ source: "html", message: "HTML copied to clipboard" });
+        }
+        catch {
+            onError(new Error("Failed to copy HTML"), { source: "html" });
+        }
+    };
+    const handleExport = () => {
+        if (!html)
+            return;
+        const url = URL.createObjectURL(new Blob([html], { type: "text/html" }));
+        const link = document.createElement("a");
+        link.href = url;
+        link.download = `${downloadFileName.replace(/\s+/g, "-").toLowerCase()}.html`;
+        link.click();
+        URL.revokeObjectURL(url);
+        onSuccess?.({ source: "html", message: "HTML exported" });
+    };
+    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogContent, { showCloseButton: true, onClose: () => onOpenChange(false), className: "flex h-[70vh] max-w-4xl flex-col gap-0 p-0", children: [_jsx(DialogTitle, { className: "sr-only", children: "Email HTML" }), _jsx("div", { className: "min-h-0 flex-1 p-4", children: _jsx(Textarea, { readOnly: true, value: html, className: "h-full min-h-[50vh] font-mono text-xs" }) }), _jsxs(DialogFooter, { className: "sm:justify-between", children: [_jsx(Button, { type: "button", variant: "outline", onClick: () => onOpenChange(false), children: "Close" }), _jsxs("div", { className: "flex gap-2", children: [_jsxs(Button, { type: "button", variant: "outline", onClick: () => void handleCopy(), disabled: !html, className: "gap-2", children: [_jsx(Copy, { className: "h-4 w-4" }), "Copy"] }), _jsxs(Button, { type: "button", onClick: handleExport, disabled: !html, className: "gap-2", children: [_jsx(Download, { className: "h-4 w-4" }), "Export"] })] })] })] }) }));
+}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { AIEmailEditor, default } from "./components/ai-email-editor/AIEmailEditor";
+export type { AIEmailEditorProps, AIEmailModelOption, StoredEmailRecord, AIEmailEditorMode, AIEmailEditorErrorSource, AIEmailEditorErrorContext, AIEmailEditorSuccessSource, AIEmailEditorSuccessContext, SendTestEmailInput, } from "./types";
+export { AiEmailResponseSchema, type AiEmailResponse, } from "./schemas/aiEmailResponse";
+export { AiEmailChatMessageSchema, AiEmailHtmlSnapshotSchema, AiEmailImageSchema, AiEmailSessionSchema, type AiEmailChatMessage, type AiEmailHtmlSnapshot, type AiEmailImage, type AiEmailSession, } from "./schemas/aiEmail";
+export { buildAiEmailStreamRequestSchema, buildResponseFormatDirective, } from "./lib/ai-stream-contract";
+export { getMergeTagError, extractMergeTags, applyMergeTags } from "./lib/merge-tag-validation";
+export { buildDefaultSystemPrompt } from "./lib/build-default-system-prompt";
+export { DEFAULT_EDIT_SUGGESTIONS, DEFAULT_NEW_TEMPLATE_SUGGESTIONS, resolveInitialSuggestions, detectPhase, extractStreamParts, formatPlan, parseStructuredStream, phaseLabel, } from "./components/ai-email-editor/stream";

package/dist/index.js

@@ -0,0 +1,7 @@
+export { AIEmailEditor, default } from "./components/ai-email-editor/AIEmailEditor";
+export { AiEmailResponseSchema, } from "./schemas/aiEmailResponse";
+export { AiEmailChatMessageSchema, AiEmailHtmlSnapshotSchema, AiEmailImageSchema, AiEmailSessionSchema, } from "./schemas/aiEmail";
+export { buildAiEmailStreamRequestSchema, buildResponseFormatDirective, } from "./lib/ai-stream-contract";
+export { getMergeTagError, extractMergeTags, applyMergeTags } from "./lib/merge-tag-validation";
+export { buildDefaultSystemPrompt } from "./lib/build-default-system-prompt";
+export { DEFAULT_EDIT_SUGGESTIONS, DEFAULT_NEW_TEMPLATE_SUGGESTIONS, resolveInitialSuggestions, detectPhase, extractStreamParts, formatPlan, parseStructuredStream, phaseLabel, } from "./components/ai-email-editor/stream";

package/dist/lib/ai-stream-contract.d.ts

@@ -0,0 +1,99 @@
+import { z } from "zod";
+export { AiEmailResponseSchema, type AiEmailResponse, } from "../schemas/aiEmailResponse";
+export declare function buildAiEmailStreamRequestSchema(): z.ZodObject<{
+    messages: z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<["user", "assistant"]>;
+        content: z.ZodString;
+        contextImages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            label: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+            label: string;
+        }, {
+            url: string;
+            label: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        role: "user" | "assistant";
+        content: string;
+        contextImages?: {
+            url: string;
+            label: string;
+        }[] | undefined;
+    }, {
+        role: "user" | "assistant";
+        content: string;
+        contextImages?: {
+            url: string;
+            label: string;
+        }[] | undefined;
+    }>, "many">;
+    systemPrompt: z.ZodString;
+    model: z.ZodString;
+    sessionContextImages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        label: string;
+    }, {
+        url: string;
+        label: string;
+    }>, "many">>;
+    previewScreenshot: z.ZodOptional<z.ZodString>;
+    currentHtml: z.ZodOptional<z.ZodString>;
+    selectedBlocks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        html: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        html: string;
+    }, {
+        id: string;
+        html: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    messages: {
+        role: "user" | "assistant";
+        content: string;
+        contextImages?: {
+            url: string;
+            label: string;
+        }[] | undefined;
+    }[];
+    systemPrompt: string;
+    sessionContextImages: {
+        url: string;
+        label: string;
+    }[];
+    model: string;
+    previewScreenshot?: string | undefined;
+    currentHtml?: string | undefined;
+    selectedBlocks?: {
+        id: string;
+        html: string;
+    }[] | undefined;
+}, {
+    messages: {
+        role: "user" | "assistant";
+        content: string;
+        contextImages?: {
+            url: string;
+            label: string;
+        }[] | undefined;
+    }[];
+    systemPrompt: string;
+    model: string;
+    sessionContextImages?: {
+        url: string;
+        label: string;
+    }[] | undefined;
+    previewScreenshot?: string | undefined;
+    currentHtml?: string | undefined;
+    selectedBlocks?: {
+        id: string;
+        html: string;
+    }[] | undefined;
+}>;
+export declare function buildResponseFormatDirective(): string;

package/dist/lib/ai-stream-contract.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+export { AiEmailResponseSchema, } from "../schemas/aiEmailResponse";
+const SelectedBlockSchema = z.object({
+    id: z.string(),
+    html: z.string(),
+});
+const ContextImageSchema = z.object({
+    url: z.string().url(),
+    label: z.string().min(1).max(120),
+});
+const ChatMessageSchema = z.object({
+    role: z.enum(["user", "assistant"]),
+    content: z.string(),
+    contextImages: z.array(ContextImageSchema).optional(),
+});
+export function buildAiEmailStreamRequestSchema() {
+    return z.object({
+        messages: z.array(ChatMessageSchema).min(1),
+        systemPrompt: z.string().min(1),
+        model: z.string().min(1),
+        sessionContextImages: z.array(ContextImageSchema).default([]),
+        previewScreenshot: z
+            .string()
+            .regex(/^data:image\/(jpeg|png|webp);base64,/, "Invalid preview screenshot")
+            .optional(),
+        currentHtml: z.string().optional(),
+        selectedBlocks: z.array(SelectedBlockSchema).optional(),
+    });
+}
+export function buildResponseFormatDirective() {
+    return `Return a structured response with:
+- plan: 2-4 first-person present-tense bullets describing each change you are making
+- suggestions: exactly 3 short follow-up prompts specific to this email (under 12 words each; do not repeat the plan)
+- html: the complete updated HTML document`;
+}

package/dist/lib/build-default-system-prompt.d.ts

@@ -0,0 +1,2 @@
+import type { AIEmailEditorMode } from "../types";
+export declare function buildDefaultSystemPrompt(mergeTags: string[], mode?: AIEmailEditorMode): string;

package/dist/lib/build-default-system-prompt.js

@@ -0,0 +1,37 @@
+function formatMergeTagList(mergeTags) {
+    const tags = [...new Set(mergeTags.map((t) => t.replace(/[{}]/g, "").trim()).filter(Boolean))];
+    return tags.length ? tags.map((t) => `{{${t}}}`).join(", ") : "(none available)";
+}
+function buildHtmlOutputRules() {
+    return `HTML output rules:
+- Return ONLY a single, complete HTML document. No markdown, no code fences, no commentary.
+- Use inline CSS (and a <style> block in <head>) for consistent rendering.`;
+}
+function buildMergeTagRules(tagList, mergeTags) {
+    const lines = [
+        "Merge tag rules (STRICT):",
+        `- The ONLY merge tags you may use are: ${tagList}.`,
+        "- Merge tags MUST be written EXACTLY as {{tagName}} — two opening braces, two closing braces, no spaces inside.",
+        "- NEVER invent new merge tags.",
+    ];
+    if (mergeTags.some((t) => t.replace(/[{}]/g, "").trim() === "unsubscribe_link")) {
+        lines.push("- Always include an unsubscribe link in the footer using {{unsubscribe_link}}.");
+    }
+    return lines.join("\n");
+}
+function buildEmailLayoutRules() {
+    return `Email layout rules:
+- Use table-based layout for maximum email-client compatibility, max width ~600px, centered.
+- Always include a clear call-to-action button.
+- Keep copy concise, friendly, and professional.
+- Do NOT include logo images, brand marks, or any placeholder/fake image URLs (e.g. example.com, placeholder services, or invented logo paths). Omit a logo/header image entirely unless the user explicitly provides a real image URL to use.
+- Button text color MUST always be set as an inline style directly on the <a> tag AND on a wrapping <span> inside it using !important.`;
+}
+export function buildDefaultSystemPrompt(mergeTags, mode = "email") {
+    const tagList = formatMergeTagList(mergeTags);
+    const parts = [buildHtmlOutputRules(), buildMergeTagRules(tagList, mergeTags)];
+    if (mode === "email") {
+        parts.push(buildEmailLayoutRules());
+    }
+    return parts.join("\n\n");
+}

package/dist/lib/capture-email-preview.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Renders clean email HTML off-screen and returns a JPEG data URL for the AI.
+ * Ephemeral — not uploaded or persisted.
+ */
+export declare function captureEmailPreviewScreenshot(cleanHtml: string): Promise<string | null>;

package/dist/lib/capture-email-preview.js

@@ -0,0 +1,73 @@
+import { toJpeg } from "html-to-image";
+const PREVIEW_WIDTH_PX = 640;
+const MAX_CAPTURE_HEIGHT_PX = 2400;
+const JPEG_QUALITY = 0.82;
+async function waitForImages(doc, timeoutMs = 4000) {
+    const images = [...doc.images];
+    if (images.length === 0)
+        return;
+    await Promise.race([
+        Promise.all(images.map((img) => new Promise((resolve) => {
+            if (img.complete) {
+                resolve();
+                return;
+            }
+            img.addEventListener("load", () => resolve(), { once: true });
+            img.addEventListener("error", () => resolve(), { once: true });
+        }))),
+        new Promise((resolve) => setTimeout(resolve, timeoutMs)),
+    ]);
+    // Allow layout to settle after images load.
+    await new Promise((resolve) => requestAnimationFrame(() => resolve()));
+}
+/**
+ * Renders clean email HTML off-screen and returns a JPEG data URL for the AI.
+ * Ephemeral — not uploaded or persisted.
+ */
+export async function captureEmailPreviewScreenshot(cleanHtml) {
+    if (typeof document === "undefined" || !cleanHtml.trim())
+        return null;
+    const iframe = document.createElement("iframe");
+    iframe.setAttribute("sandbox", "allow-same-origin");
+    iframe.setAttribute("aria-hidden", "true");
+    iframe.style.cssText = [
+        "position:fixed",
+        "left:-10000px",
+        "top:0",
+        `width:${PREVIEW_WIDTH_PX}px`,
+        "height:0",
+        "border:0",
+        "visibility:hidden",
+        "pointer-events:none",
+    ].join(";");
+    document.body.appendChild(iframe);
+    try {
+        const doc = iframe.contentDocument;
+        if (!doc)
+            return null;
+        doc.open();
+        doc.write(cleanHtml);
+        doc.close();
+        await waitForImages(doc);
+        const body = doc.body;
+        if (!body)
+            return null;
+        const height = Math.min(body.scrollHeight || body.offsetHeight, MAX_CAPTURE_HEIGHT_PX);
+        iframe.style.height = `${height}px`;
+        return await toJpeg(body, {
+            quality: JPEG_QUALITY,
+            width: PREVIEW_WIDTH_PX,
+            height,
+            pixelRatio: 1,
+            skipFonts: false,
+            cacheBust: true,
+        });
+    }
+    catch (error) {
+        console.warn("Failed to capture email preview screenshot:", error);
+        return null;
+    }
+    finally {
+        iframe.remove();
+    }
+}

package/dist/lib/cn.d.ts

@@ -0,0 +1,2 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/lib/cn.js

@@ -0,0 +1,5 @@
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}

package/dist/lib/merge-tag-validation.d.ts

@@ -0,0 +1,3 @@
+export declare function extractMergeTags(content: string): string[];
+export declare function applyMergeTags(html: string, values: Record<string, string>): string;
+export declare function getMergeTagError(content: string, allowedTags: Iterable<string>): string | null;

package/dist/lib/merge-tag-validation.js

@@ -0,0 +1,45 @@
+const MERGE_TAG_PATTERN = /\{\{([a-zA-Z0-9_]+)\}\}/g;
+export function extractMergeTags(content) {
+    const tags = [];
+    const seen = new Set();
+    let match;
+    const pattern = new RegExp(MERGE_TAG_PATTERN.source, "g");
+    while ((match = pattern.exec(content)) !== null) {
+        const tag = match[1];
+        if (!seen.has(tag)) {
+            seen.add(tag);
+            tags.push(tag);
+        }
+    }
+    return tags;
+}
+export function applyMergeTags(html, values) {
+    return html.replace(new RegExp(MERGE_TAG_PATTERN.source, "g"), (full, tag) => {
+        if (Object.prototype.hasOwnProperty.call(values, tag)) {
+            return values[tag];
+        }
+        return full;
+    });
+}
+export function getMergeTagError(content, allowedTags) {
+    const allowed = new Set();
+    for (const tag of allowedTags) {
+        const name = tag.replace(/[{}]/g, "").trim();
+        if (name)
+            allowed.add(name);
+    }
+    const unknown = new Set();
+    let match;
+    const tagPattern = new RegExp(MERGE_TAG_PATTERN.source, "g");
+    while ((match = tagPattern.exec(content)) !== null) {
+        if (!allowed.has(match[1])) {
+            unknown.add(match[1]);
+        }
+    }
+    if (unknown.size === 0)
+        return null;
+    const allowedList = [...allowed].map((t) => `{{${t}}}`).join(", ");
+    return (`Unknown merge tag${unknown.size > 1 ? "s" : ""}: ` +
+        `${[...unknown].map((t) => `{{${t}}}`).join(", ")}. ` +
+        `Allowed merge tags are: ${allowedList}.`);
+}

package/dist/lib/rasterize-image-client.d.ts

@@ -0,0 +1,4 @@
+/** MIME types Gemini accepts for vision input. */
+export declare const AI_SAFE_IMAGE_TYPES: Set<string>;
+/** Converts SVG/GIF/etc. to PNG before upload so AI vision can read them. */
+export declare function prepareImageFileForUpload(file: File): Promise<File>;

package/dist/lib/rasterize-image-client.js

@@ -0,0 +1,47 @@
+/** MIME types Gemini accepts for vision input. */
+export const AI_SAFE_IMAGE_TYPES = new Set([
+    "image/jpeg",
+    "image/png",
+    "image/webp",
+]);
+function loadImageElement(src) {
+    return new Promise((resolve, reject) => {
+        const img = new Image();
+        img.onload = () => resolve(img);
+        img.onerror = () => reject(new Error("Failed to decode image"));
+        img.src = src;
+    });
+}
+async function rasterizeToPngBlob(file) {
+    const objectUrl = URL.createObjectURL(file);
+    try {
+        const img = await loadImageElement(objectUrl);
+        const width = img.naturalWidth || img.width || 1200;
+        const height = img.naturalHeight || img.height || 800;
+        const canvas = document.createElement("canvas");
+        canvas.width = Math.max(1, width);
+        canvas.height = Math.max(1, height);
+        const ctx = canvas.getContext("2d");
+        if (!ctx)
+            throw new Error("Canvas unavailable");
+        ctx.drawImage(img, 0, 0, canvas.width, canvas.height);
+        const blob = await new Promise((resolve) => canvas.toBlob(resolve, "image/png"));
+        if (!blob)
+            throw new Error("Failed to rasterize image");
+        return blob;
+    }
+    finally {
+        URL.revokeObjectURL(objectUrl);
+    }
+}
+/** Converts SVG/GIF/etc. to PNG before upload so AI vision can read them. */
+export async function prepareImageFileForUpload(file) {
+    if (AI_SAFE_IMAGE_TYPES.has(file.type))
+        return file;
+    if (!file.type.startsWith("image/")) {
+        throw new Error("Only image files are supported.");
+    }
+    const blob = await rasterizeToPngBlob(file);
+    const baseName = (file.name || "image").replace(/\.[^.]+$/, "") || "image";
+    return new File([blob], `${baseName}.png`, { type: "image/png" });
+}

package/dist/lib/strip-html-code-fences.d.ts

@@ -0,0 +1 @@
+export declare function stripHtmlCodeFences(text: string): string;

package/dist/lib/strip-html-code-fences.js

@@ -0,0 +1,6 @@
+const HTML_FENCE = /^```(?:html)?\s*([\s\S]*?)\s*```$/i;
+export function stripHtmlCodeFences(text) {
+    const trimmed = text.trim();
+    const fenced = HTML_FENCE.exec(trimmed);
+    return (fenced ? fenced[1] : trimmed).trim();
+}

package/dist/schemas/aiEmail.d.ts

@@ -0,0 +1,224 @@
+import { z } from "zod";
+export declare const AiEmailImageSchema: z.ZodObject<{
+    id: z.ZodString;
+    url: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    url: string;
+    name?: string | undefined;
+}, {
+    id: string;
+    url: string;
+    name?: string | undefined;
+}>;
+export declare const AiEmailChatMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodEnum<["user", "assistant"]>;
+    content: z.ZodString;
+    contextImages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        url: string;
+        name?: string | undefined;
+    }, {
+        id: string;
+        url: string;
+        name?: string | undefined;
+    }>, "many">>;
+    appliedHtml: z.ZodOptional<z.ZodBoolean>;
+    snapshotId: z.ZodOptional<z.ZodString>;
+    selectedBlockIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    phase: z.ZodOptional<z.ZodEnum<["thinking", "planning", "applying"]>>;
+    timestamp: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    role: "user" | "assistant";
+    content: string;
+    timestamp: number;
+    contextImages?: {
+        id: string;
+        url: string;
+        name?: string | undefined;
+    }[] | undefined;
+    appliedHtml?: boolean | undefined;
+    snapshotId?: string | undefined;
+    selectedBlockIds?: string[] | undefined;
+    phase?: "thinking" | "planning" | "applying" | undefined;
+}, {
+    id: string;
+    role: "user" | "assistant";
+    content: string;
+    timestamp: number;
+    contextImages?: {
+        id: string;
+        url: string;
+        name?: string | undefined;
+    }[] | undefined;
+    appliedHtml?: boolean | undefined;
+    snapshotId?: string | undefined;
+    selectedBlockIds?: string[] | undefined;
+    phase?: "thinking" | "planning" | "applying" | undefined;
+}>;
+export declare const AiEmailHtmlSnapshotSchema: z.ZodObject<{
+    id: z.ZodString;
+    html: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    timestamp: number;
+    html: string;
+    label?: string | undefined;
+}, {
+    id: string;
+    timestamp: number;
+    html: string;
+    label?: string | undefined;
+}>;
+export declare const AiEmailSessionSchema: z.ZodObject<{
+    messages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        role: z.ZodEnum<["user", "assistant"]>;
+        content: z.ZodString;
+        contextImages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            url: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            url: string;
+            name?: string | undefined;
+        }, {
+            id: string;
+            url: string;
+            name?: string | undefined;
+        }>, "many">>;
+        appliedHtml: z.ZodOptional<z.ZodBoolean>;
+        snapshotId: z.ZodOptional<z.ZodString>;
+        selectedBlockIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        phase: z.ZodOptional<z.ZodEnum<["thinking", "planning", "applying"]>>;
+        timestamp: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        role: "user" | "assistant";
+        content: string;
+        timestamp: number;
+        contextImages?: {
+            id: string;
+            url: string;
+            name?: string | undefined;
+        }[] | undefined;
+        appliedHtml?: boolean | undefined;
+        snapshotId?: string | undefined;
+        selectedBlockIds?: string[] | undefined;
+        phase?: "thinking" | "planning" | "applying" | undefined;
+    }, {
+        id: string;
+        role: "user" | "assistant";
+        content: string;
+        timestamp: number;
+        contextImages?: {
+            id: string;
+            url: string;
+            name?: string | undefined;
+        }[] | undefined;
+        appliedHtml?: boolean | undefined;
+        snapshotId?: string | undefined;
+        selectedBlockIds?: string[] | undefined;
+        phase?: "thinking" | "planning" | "applying" | undefined;
+    }>, "many">>;
+    snapshots: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        html: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        timestamp: number;
+        html: string;
+        label?: string | undefined;
+    }, {
+        id: string;
+        timestamp: number;
+        html: string;
+        label?: string | undefined;
+    }>, "many">>;
+    snapshotIndex: z.ZodDefault<z.ZodNumber>;
+    contextImages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        url: string;
+        name?: string | undefined;
+    }, {
+        id: string;
+        url: string;
+        name?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    contextImages: {
+        id: string;
+        url: string;
+        name?: string | undefined;
+    }[];
+    messages: {
+        id: string;
+        role: "user" | "assistant";
+        content: string;
+        timestamp: number;
+        contextImages?: {
+            id: string;
+            url: string;
+            name?: string | undefined;
+        }[] | undefined;
+        appliedHtml?: boolean | undefined;
+        snapshotId?: string | undefined;
+        selectedBlockIds?: string[] | undefined;
+        phase?: "thinking" | "planning" | "applying" | undefined;
+    }[];
+    snapshots: {
+        id: string;
+        timestamp: number;
+        html: string;
+        label?: string | undefined;
+    }[];
+    snapshotIndex: number;
+}, {
+    contextImages?: {
+        id: string;
+        url: string;
+        name?: string | undefined;
+    }[] | undefined;
+    messages?: {
+        id: string;
+        role: "user" | "assistant";
+        content: string;
+        timestamp: number;
+        contextImages?: {
+            id: string;
+            url: string;
+            name?: string | undefined;
+        }[] | undefined;
+        appliedHtml?: boolean | undefined;
+        snapshotId?: string | undefined;
+        selectedBlockIds?: string[] | undefined;
+        phase?: "thinking" | "planning" | "applying" | undefined;
+    }[] | undefined;
+    snapshots?: {
+        id: string;
+        timestamp: number;
+        html: string;
+        label?: string | undefined;
+    }[] | undefined;
+    snapshotIndex?: number | undefined;
+}>;
+export type AiEmailImage = z.infer<typeof AiEmailImageSchema>;
+export type AiEmailChatMessage = z.infer<typeof AiEmailChatMessageSchema>;
+export type AiEmailHtmlSnapshot = z.infer<typeof AiEmailHtmlSnapshotSchema>;
+export type AiEmailSession = z.infer<typeof AiEmailSessionSchema>;