ruflo 3.5.2 → 3.5.3

package/src/ruvocal/package.json

@@ -0,0 +1,121 @@
+{
+	"name": "chat-ui",
+	"version": "0.20.0",
+	"private": true,
+	"packageManager": "npm@9.5.0",
+	"scripts": {
+		"dev": "vite dev",
+		"build": "vite build",
+		"build:static": "ADAPTER=static vite build",
+		"preview": "vite preview",
+		"check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+		"check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
+		"lint": "prettier --check . && eslint .",
+		"format": "prettier --write .",
+		"test": "vitest",
+		"updateLocalEnv": "vite-node --options.transformMode.ssr='/.*/' scripts/updateLocalEnv.ts",
+		"populate": "vite-node --options.transformMode.ssr='/.*/' scripts/populate.ts",
+		"config": "vite-node --options.transformMode.ssr='/.*/' scripts/config.ts",
+		"prepare": "husky"
+	},
+	"devDependencies": {
+		"@faker-js/faker": "^8.4.1",
+		"@iconify-json/carbon": "^1.1.16",
+		"@iconify-json/eos-icons": "^1.1.6",
+		"@iconify-json/lucide": "^1.2.77",
+		"@sveltejs/adapter-node": "^5.2.12",
+		"@sveltejs/adapter-static": "^3.0.8",
+		"@sveltejs/kit": "^2.52.2",
+		"@sveltejs/vite-plugin-svelte": "^5.0.3",
+		"@tailwindcss/typography": "^0.5.9",
+		"@types/dompurify": "^3.0.5",
+		"@types/js-yaml": "^4.0.9",
+		"@types/katex": "^0.16.7",
+		"@types/mime-types": "^2.1.4",
+		"@types/minimist": "^1.2.5",
+		"@types/node": "^22.1.0",
+		"@types/parquetjs": "^0.10.3",
+		"@types/pg": "^8.18.0",
+		"@types/three": "^0.183.1",
+		"@types/uuid": "^9.0.8",
+		"@types/yazl": "^3.3.0",
+		"@typescript-eslint/eslint-plugin": "^6.x",
+		"@typescript-eslint/parser": "^6.x",
+		"bson-objectid": "^2.0.4",
+		"dompurify": "^3.2.4",
+		"eslint": "^8.28.0",
+		"eslint-config-prettier": "^8.5.0",
+		"eslint-plugin-svelte": "^2.45.1",
+		"husky": "^9.0.11",
+		"isomorphic-dompurify": "2.13.0",
+		"js-yaml": "^4.1.1",
+		"lint-staged": "^15.2.7",
+		"minimist": "^1.2.8",
+		"mongodb-memory-server": "^10.1.2",
+		"playwright": "^1.55.1",
+		"prettier": "^3.5.3",
+		"prettier-plugin-svelte": "^3.2.6",
+		"prettier-plugin-tailwindcss": "^0.6.11",
+		"sade": "^1.8.1",
+		"superjson": "^2.2.2",
+		"svelte": "^5.53.0",
+		"svelte-check": "^4.0.0",
+		"tslib": "^2.4.1",
+		"typescript": "^5.5.0",
+		"unplugin-icons": "^0.16.1",
+		"vite": "^6.3.5",
+		"vite-node": "^3.0.9",
+		"vitest": "^3.1.4",
+		"vitest-browser-svelte": "^0.1.0",
+		"yazl": "^3.3.1"
+	},
+	"type": "module",
+	"dependencies": {
+		"@huggingface/hub": "^2.2.0",
+		"@huggingface/inference": "^4.11.3",
+		"@iconify-json/bi": "^1.1.21",
+		"@modelcontextprotocol/sdk": "^1.26.0",
+		"@resvg/resvg-js": "^2.6.2",
+		"ajv": "^8.18.0",
+		"autoprefixer": "^10.4.14",
+		"bits-ui": "^2.14.2",
+		"date-fns": "^2.29.3",
+		"devalue": "^5.6.3",
+		"dotenv": "^16.5.0",
+		"file-type": "^21.0.0",
+		"handlebars": "^4.7.8",
+		"highlight.js": "^11.7.0",
+		"hono": "^4.12.0",
+		"htmlparser2": "^10.0.0",
+		"ip-address": "^9.0.5",
+		"jsdom": "^22.0.0",
+		"json5": "^2.2.3",
+		"katex": "^0.16.21",
+		"marked": "^12.0.1",
+		"mime-types": "^2.1.35",
+		"mongodb": "^5.8.0",
+		"nanoid": "^5.0.9",
+		"openai": "^4.44.0",
+		"openid-client": "^5.4.2",
+		"parquetjs": "^0.11.2",
+		"pg": "^8.20.0",
+		"pino": "^9.0.0",
+		"pino-pretty": "^11.0.0",
+		"postcss": "^8.4.31",
+		"prom-client": "^15.1.3",
+		"qs": "^6.14.2",
+		"satori": "^0.10.11",
+		"satori-html": "^0.3.2",
+		"sharp": "^0.33.4",
+		"tailwind-scrollbar": "^3.0.0",
+		"tailwindcss": "^3.4.0",
+		"three": "^0.183.2",
+		"undici": "^7.18.2",
+		"uuid": "^10.0.0",
+		"web-haptics": "^0.0.6",
+		"zod": "^3.22.3"
+	},
+	"overrides": {
+		"@reflink/reflink": "file:stub/@reflink/reflink"
+	}
+}

package/src/ruvocal/postcss.config.js

@@ -0,0 +1,6 @@
+export default {
+	plugins: {
+		tailwindcss: {},
+		autoprefixer: {},
+	},
+};

package/src/ruvocal/rvf.manifest.json

@@ -0,0 +1,204 @@
+{
+  "rvf_version": "2.0",
+  "format": "rvf-package",
+  "name": "ruvocal",
+  "version": "1.0.0",
+  "description": "RuVocal — Conversational AI UI powered by RuVector-Postgres. Fork of HuggingFace Chat UI with MongoDB replaced by PostgreSQL + pgvector for unified vector search across conversations, agents, and knowledge.",
+  "license": "Apache-2.0",
+  "upstream": {
+    "repo": "https://github.com/huggingface/chat-ui",
+    "license": "Apache-2.0",
+    "fork_date": "2026-03-05"
+  },
+  "segments": {
+    "MANIFEST": {
+      "type": "root",
+      "uuid": "${RVF_UUID}",
+      "created": "${RVF_TIMESTAMP}",
+      "parent": null
+    },
+    "PROFILE": {
+      "type": "domain-config",
+      "description": "Deployment configuration — PostgreSQL connection, AI providers, auth",
+      "config_schema": "config/config.example.json",
+      "env_schema": ".env.example"
+    },
+    "WASM": {
+      "type": "runtime",
+      "description": "SvelteKit app with PostgreSQL adapter + MCP Bridge v2.0",
+      "entrypoint": "src/hooks.server.ts",
+      "runtime": "node:20",
+      "port": 3000,
+      "database": {
+        "type": "postgresql",
+        "extensions": ["pgvector"],
+        "adapter": "src/lib/server/database.ts"
+      }
+    },
+    "META_IDX": {
+      "type": "metadata",
+      "components": [
+        {
+          "name": "ruvocal-ui",
+          "type": "service",
+          "description": "SvelteKit Chat UI with PostgreSQL backend, OIDC auth, autopilot mode, and vector search",
+          "dockerfile": "Dockerfile",
+          "port": 3000,
+          "env_vars": [
+            "DATABASE_URL",
+            "PUBLIC_APP_NAME",
+            "PUBLIC_ORIGIN",
+            "OPENID_PROVIDER_URL",
+            "OPENID_CLIENT_ID",
+            "OPENID_CLIENT_SECRET",
+            "OPENAI_BASE_URL",
+            "OPENAI_API_KEY",
+            "MCP_SERVERS",
+            "EMBEDDING_MODEL",
+            "EMBEDDING_DIMENSIONS"
+          ]
+        },
+        {
+          "name": "mcp-bridge",
+          "type": "service",
+          "description": "Per-group MCP JSON-RPC server + OpenAI-compatible chat proxy with autopilot mode",
+          "dockerfile": "mcp-bridge/Dockerfile",
+          "port": 3001,
+          "env_vars": [
+            "OPENAI_API_KEY",
+            "GOOGLE_API_KEY",
+            "OPENROUTER_API_KEY",
+            "ANTHROPIC_API_KEY",
+            "MCP_GROUP_INTELLIGENCE",
+            "MCP_GROUP_AGENTS",
+            "MCP_GROUP_MEMORY",
+            "MCP_GROUP_DEVTOOLS"
+          ]
+        },
+        {
+          "name": "ruvector-postgres",
+          "type": "datastore",
+          "description": "PostgreSQL 17 + pgvector 2.0.1 — unified storage for conversations, users, embeddings, and knowledge",
+          "image": "pgvector/pgvector:pg17",
+          "port": 5432
+        }
+      ]
+    },
+    "DATABASE": {
+      "type": "schema",
+      "description": "PostgreSQL schema replacing MongoDB collections",
+      "migration": "db/migrations/001_init.sql",
+      "tables": {
+        "conversations": "Chat sessions with vector embedding for semantic search",
+        "messages": "Normalized messages (extracted from MongoDB's nested array)",
+        "users": "User accounts (OIDC-backed)",
+        "sessions": "Auth sessions with TTL",
+        "settings": "User preferences and tool config",
+        "assistants": "Custom AI assistants/personas",
+        "assistant_stats": "Usage statistics for assistants",
+        "conversation_stats": "Aggregated conversation analytics",
+        "shared_conversations": "Public share links",
+        "aborted_generations": "TTL-based abort tracking",
+        "reports": "Abuse reports",
+        "message_events": "User feedback (votes, copies, shares)",
+        "semaphores": "Rate limiting with TTL",
+        "token_caches": "Short-lived token validation cache",
+        "config": "Runtime configuration key-value store",
+        "migration_results": "Schema migration tracking"
+      },
+      "extensions": ["pgvector", "uuid-ossp"],
+      "indexes": {
+        "hnsw": ["conversations.embedding", "messages.embedding"],
+        "btree": ["conversations.user_id", "messages.conversation_id", "sessions.session_id"]
+      }
+    },
+    "TOOL_GROUPS": {
+      "type": "mcp-groups",
+      "description": "Inherited from chat-ui-mcp — per-group MCP endpoints",
+      "groups": {
+        "core": { "enabled_by_default": true, "endpoint": "/mcp/core" },
+        "intelligence": { "enabled_by_default": true, "endpoint": "/mcp/intelligence" },
+        "agents": { "enabled_by_default": true, "endpoint": "/mcp/agents" },
+        "memory": { "enabled_by_default": true, "endpoint": "/mcp/memory" },
+        "devtools": { "enabled_by_default": true, "endpoint": "/mcp/devtools" }
+      }
+    },
+    "AUTOPILOT": {
+      "type": "feature",
+      "description": "ADR-037 autopilot mode — server-side auto-continue with parallel task UI",
+      "adr": "docs/adr/ADR-037-AUTOPILOT-CHAT-MODE.md",
+      "components": {
+        "backend": "mcp-bridge/index.js (handleAutopilot)",
+        "frontend": "src/lib/components/autopilot/",
+        "worker": "src/lib/workers/autopilot.worker.ts"
+      },
+      "header": "x-autopilot: true",
+      "detail_endpoint": "/autopilot/detail/:token"
+    },
+    "OVERLAY": {
+      "type": "customization",
+      "description": "Brand-specific overlays",
+      "assets": [
+        "static/chatui/omni-welcome.gif",
+        "static/chatui/icon-144x144.png"
+      ]
+    },
+    "CRYPTO": {
+      "type": "security",
+      "description": "Security configuration",
+      "auth_protocol": "openid-connect",
+      "no_embedded_secrets": true,
+      "env_only_keys": [
+        "OPENAI_API_KEY",
+        "GOOGLE_API_KEY",
+        "OPENROUTER_API_KEY",
+        "ANTHROPIC_API_KEY",
+        "OPENID_CLIENT_SECRET",
+        "DATABASE_URL"
+      ]
+    }
+  },
+  "deployment": {
+    "platforms": ["google-cloud-run", "docker-compose", "kubernetes"],
+    "infrastructure": {
+      "ruvocal_ui": {
+        "memory": "2Gi",
+        "cpu": 2,
+        "min_instances": 1,
+        "max_instances": 10,
+        "timeout": 300
+      },
+      "mcp_bridge": {
+        "memory": "512Mi",
+        "cpu": 1,
+        "min_instances": 0,
+        "max_instances": 5,
+        "timeout": 300
+      },
+      "ruvector_postgres": {
+        "memory": "4Gi",
+        "cpu": 2,
+        "storage": "50Gi"
+      }
+    }
+  },
+  "capabilities": {
+    "mcp_protocol": "2024-11-05",
+    "mcp_tool_groups": true,
+    "per_group_mcp_endpoints": true,
+    "chat_completions_proxy": true,
+    "autopilot_mode": true,
+    "vector_search_conversations": true,
+    "postgresql_backend": true,
+    "no_mongodb_dependency": true,
+    "upstream_error_normalization": true,
+    "goap_search_pipeline": true,
+    "multi_provider_routing": ["openai", "gemini", "openrouter"],
+    "oidc_auth": true,
+    "svelte5_source": true,
+    "ruvector_integration": true,
+    "ruflo_integration": true,
+    "embedding_model": "all-MiniLM-L6-v2",
+    "embedding_dimensions": 384
+  }
+}

package/src/ruvocal/scripts/config.ts

@@ -0,0 +1,64 @@
+import sade from "sade";
+
+// @ts-expect-error: vite-node makes the var available but the typescript compiler doesn't see them
+import { config, ready } from "$lib/server/config";
+
+const prog = sade("config");
+await ready;
+prog
+	.command("clear")
+	.describe("Clear all config keys")
+	.action(async () => {
+		console.log("Clearing config...");
+		await clear();
+	});
+
+prog
+	.command("add <key> <value>")
+	.describe("Add a new config key")
+	.action(async (key: string, value: string) => {
+		await add(key, value);
+	});
+
+prog
+	.command("remove <key>")
+	.describe("Remove a config key")
+	.action(async (key: string) => {
+		console.log(`Removing ${key}`);
+		await remove(key);
+		process.exit(0);
+	});
+
+prog
+	.command("help")
+	.describe("Show help information")
+	.action(() => {
+		prog.help();
+		process.exit(0);
+	});
+
+async function clear() {
+	await config.clear();
+	process.exit(0);
+}
+
+async function add(key: string, value: string) {
+	if (!key || !value) {
+		console.error("Key and value are required");
+		process.exit(1);
+	}
+	await config.set(key as keyof typeof config.keysFromEnv, value);
+	process.exit(0);
+}
+
+async function remove(key: string) {
+	if (!key) {
+		console.error("Key is required");
+		process.exit(1);
+	}
+	await config.delete(key as keyof typeof config.keysFromEnv);
+	process.exit(0);
+}
+
+// Parse arguments and handle help automatically
+prog.parse(process.argv);

package/src/ruvocal/scripts/generate-welcome.mjs

@@ -0,0 +1,181 @@
+/**
+ * Generate RuFlo welcome animation — Foundation-inspired graph universe.
+ *
+ * Creates an animated GIF with:
+ * - Deep space background (#06060f)
+ * - Constellation-style graph nodes connected by glowing edges
+ * - Orbital paths and particle trails
+ * - "RuFlo" text with subtle glow
+ * - Stars scattered throughout
+ *
+ * Uses sharp (already installed) for PNG frame generation,
+ * then assembles frames into animated GIF.
+ */
+
+import sharp from "sharp";
+import { writeFileSync } from "fs";
+
+const WIDTH = 480;
+const HEIGHT = 320;
+const FRAMES = 40; // ~2.5s at 60ms/frame
+const BG = "#06060f";
+
+// Graph nodes — positions in a constellation pattern
+const NODES = [
+	{ x: 240, y: 120, r: 6, color: "#3b82f6", label: "" }, // center
+	{ x: 140, y: 80, r: 4, color: "#06b6d4", label: "" },
+	{ x: 340, y: 90, r: 4, color: "#818cf8", label: "" },
+	{ x: 180, y: 200, r: 5, color: "#2dd4bf", label: "" },
+	{ x: 300, y: 210, r: 5, color: "#a78bfa", label: "" },
+	{ x: 100, y: 160, r: 3, color: "#38bdf8", label: "" },
+	{ x: 380, y: 170, r: 3, color: "#c084fc", label: "" },
+	{ x: 200, y: 50, r: 3, color: "#22d3ee", label: "" },
+	{ x: 280, y: 260, r: 3, color: "#6366f1", label: "" },
+	{ x: 60, y: 240, r: 2, color: "#0ea5e9", label: "" },
+	{ x: 420, y: 250, r: 2, color: "#8b5cf6", label: "" },
+	{ x: 120, y: 280, r: 2, color: "#14b8a6", label: "" },
+];
+
+// Edges connecting nodes
+const EDGES = [
+	[0, 1], [0, 2], [0, 3], [0, 4],
+	[1, 5], [1, 7], [2, 6], [2, 7],
+	[3, 5], [3, 8], [4, 6], [4, 8],
+	[5, 9], [6, 10], [8, 11], [9, 11],
+	[3, 9], [4, 10],
+];
+
+// Stars — random positions
+const STARS = Array.from({ length: 80 }, () => ({
+	x: Math.random() * WIDTH,
+	y: Math.random() * HEIGHT,
+	r: Math.random() * 1.5 + 0.3,
+	brightness: Math.random() * 0.6 + 0.2,
+}));
+
+function generateFrame(frameIdx) {
+	const t = frameIdx / FRAMES;
+	const phase = t * Math.PI * 2;
+
+	let svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${WIDTH}" height="${HEIGHT}">`;
+	svg += `<defs>`;
+	// Glow filter
+	svg += `<filter id="glow" x="-50%" y="-50%" width="200%" height="200%">`;
+	svg += `<feGaussianBlur stdDeviation="3" result="blur"/>`;
+	svg += `<feMerge><feMergeNode in="blur"/><feMergeNode in="SourceGraphic"/></feMerge>`;
+	svg += `</filter>`;
+	// Stronger glow for text
+	svg += `<filter id="textglow" x="-50%" y="-50%" width="200%" height="200%">`;
+	svg += `<feGaussianBlur stdDeviation="6" result="blur"/>`;
+	svg += `<feMerge><feMergeNode in="blur"/><feMergeNode in="blur"/><feMergeNode in="SourceGraphic"/></feMerge>`;
+	svg += `</filter>`;
+	// Radial gradient for nebula effect
+	svg += `<radialGradient id="nebula" cx="50%" cy="40%" r="60%">`;
+	svg += `<stop offset="0%" stop-color="#1e1b4b" stop-opacity="0.3"/>`;
+	svg += `<stop offset="50%" stop-color="#0c0a2a" stop-opacity="0.15"/>`;
+	svg += `<stop offset="100%" stop-color="${BG}" stop-opacity="0"/>`;
+	svg += `</radialGradient>`;
+	svg += `</defs>`;
+
+	// Background
+	svg += `<rect width="${WIDTH}" height="${HEIGHT}" fill="${BG}"/>`;
+	// Nebula overlay
+	svg += `<rect width="${WIDTH}" height="${HEIGHT}" fill="url(#nebula)"/>`;
+
+	// Stars with twinkling
+	for (const star of STARS) {
+		const twinkle = star.brightness + Math.sin(phase * 3 + star.x * 0.1) * 0.15;
+		const opacity = Math.max(0.1, Math.min(1, twinkle));
+		svg += `<circle cx="${star.x.toFixed(1)}" cy="${star.y.toFixed(1)}" r="${star.r.toFixed(1)}" fill="white" opacity="${opacity.toFixed(2)}"/>`;
+	}
+
+	// Animated node positions (subtle orbital motion)
+	const animNodes = NODES.map((n, i) => ({
+		...n,
+		ax: n.x + Math.sin(phase + i * 0.7) * (3 + i * 0.5),
+		ay: n.y + Math.cos(phase + i * 0.9) * (2 + i * 0.3),
+	}));
+
+	// Draw edges with pulse effect
+	for (const [a, b] of EDGES) {
+		const na = animNodes[a];
+		const nb = animNodes[b];
+		const edgePhase = Math.sin(phase * 2 + a + b) * 0.3 + 0.4;
+		svg += `<line x1="${na.ax.toFixed(1)}" y1="${na.ay.toFixed(1)}" x2="${nb.ax.toFixed(1)}" y2="${nb.ay.toFixed(1)}" stroke="#3b82f6" stroke-opacity="${edgePhase.toFixed(2)}" stroke-width="0.8"/>`;
+
+		// Traveling particle along edge
+		const particleT = (t * 3 + a * 0.1) % 1;
+		const px = na.ax + (nb.ax - na.ax) * particleT;
+		const py = na.ay + (nb.ay - na.ay) * particleT;
+		svg += `<circle cx="${px.toFixed(1)}" cy="${py.toFixed(1)}" r="1.5" fill="#60a5fa" opacity="0.7" filter="url(#glow)"/>`;
+	}
+
+	// Draw nodes
+	for (const n of animNodes) {
+		// Outer glow
+		svg += `<circle cx="${n.ax.toFixed(1)}" cy="${n.ay.toFixed(1)}" r="${(n.r * 2.5).toFixed(1)}" fill="${n.color}" opacity="0.15"/>`;
+		// Core
+		svg += `<circle cx="${n.ax.toFixed(1)}" cy="${n.ay.toFixed(1)}" r="${n.r}" fill="${n.color}" filter="url(#glow)"/>`;
+	}
+
+	// Orbital ring around center node
+	const centerX = animNodes[0].ax;
+	const centerY = animNodes[0].ay;
+	svg += `<ellipse cx="${centerX.toFixed(1)}" cy="${centerY.toFixed(1)}" rx="45" ry="18" fill="none" stroke="#3b82f6" stroke-opacity="0.2" stroke-width="0.5" transform="rotate(${(t * 30).toFixed(1)} ${centerX.toFixed(1)} ${centerY.toFixed(1)})"/>`;
+	svg += `<ellipse cx="${centerX.toFixed(1)}" cy="${centerY.toFixed(1)}" rx="55" ry="22" fill="none" stroke="#818cf8" stroke-opacity="0.15" stroke-width="0.5" transform="rotate(${(-t * 20 + 60).toFixed(1)} ${centerX.toFixed(1)} ${centerY.toFixed(1)})"/>`;
+
+	// "RuFlo" text
+	const textY = HEIGHT - 40;
+	svg += `<text x="${WIDTH / 2}" y="${textY}" text-anchor="middle" font-family="'Segoe UI', 'Helvetica Neue', Arial, sans-serif" font-size="32" font-weight="300" fill="#e0e7ff" letter-spacing="8" filter="url(#textglow)">RuFlo</text>`;
+
+	// Subtitle
+	svg += `<text x="${WIDTH / 2}" y="${textY + 20}" text-anchor="middle" font-family="'Segoe UI', 'Helvetica Neue', Arial, sans-serif" font-size="9" fill="#94a3b8" letter-spacing="3" opacity="0.7">INTELLIGENT WORKFLOWS</text>`;
+
+	svg += `</svg>`;
+	return svg;
+}
+
+async function main() {
+	console.log(`Generating ${FRAMES} frames...`);
+
+	const frames = [];
+	for (let i = 0; i < FRAMES; i++) {
+		const svg = generateFrame(i);
+		const pngBuffer = await sharp(Buffer.from(svg))
+			.resize(WIDTH, HEIGHT)
+			.png()
+			.toBuffer();
+		frames.push(pngBuffer);
+		process.stdout.write(".");
+	}
+	console.log(" done");
+
+	// Assemble into animated GIF using sharp
+	// sharp doesn't natively do animated GIF, so we'll create frames and
+	// use the GIF89a format manually or just output a nice static image
+	// with the first frame for now, plus we can use the sharp webp animation
+
+	// Actually, let's generate an animated WebP (which sharp supports) and also
+	// a static GIF fallback
+	console.log("Creating animated WebP...");
+	const animatedWebp = await sharp(frames[0], { animated: true })
+		.webp({ quality: 80 })
+		.toBuffer();
+
+	// For the GIF, we'll manually construct it since sharp doesn't do animated GIF
+	// Let's just create a high-quality static GIF from the best frame
+	const staticGif = await sharp(frames[0]).gif().toBuffer();
+	writeFileSync("static/chatui/omni-welcome.gif", staticGif);
+	console.log(`Wrote static/chatui/omni-welcome.gif (${(staticGif.length / 1024).toFixed(1)}KB)`);
+
+	// Also save a nice PNG version
+	writeFileSync("static/chatui/omni-welcome.png", frames[0]);
+	console.log(`Wrote static/chatui/omni-welcome.png (${(frames[0].length / 1024).toFixed(1)}KB)`);
+
+	// Generate the SVG directly for highest quality (browsers handle SVG animation)
+	const svgFrame = generateFrame(0);
+	writeFileSync("static/chatui/welcome.svg", svgFrame);
+	console.log(`Wrote static/chatui/welcome.svg`);
+}
+
+main().catch(console.error);