@aigentic/ruflo 3.7.0-alpha.69

package/src/nginx/nginx.conf

@@ -0,0 +1,67 @@
+worker_processes auto;
+
+events {
+    worker_connections 1024;
+}
+
+http {
+    include       /etc/nginx/mime.types;
+    default_type  application/octet-stream;
+
+    sendfile    on;
+    keepalive_timeout 65;
+    gzip off;  # required for sub_filter to work
+
+    server {
+        listen 3000;
+        server_name _;
+
+        # --- CORS headers on all responses ---
+        add_header Access-Control-Allow-Origin  "*" always;
+        add_header Access-Control-Allow-Methods "GET, POST, OPTIONS" always;
+        add_header Access-Control-Allow-Headers "Content-Type, Authorization" always;
+
+        # Preflight
+        if ($request_method = OPTIONS) {
+            return 204;
+        }
+
+        # --- RuFlo brand assets (logo, favicons, manifest) ---
+        location /chatui/ {
+            alias /etc/nginx/static/;
+            expires 1h;
+            add_header Cache-Control "public";
+            add_header Access-Control-Allow-Origin "*" always;
+        }
+
+        # --- RuFlo static JS/CSS ---
+        location /ruflo/ {
+            alias /etc/nginx/static/;
+            expires 1h;
+            add_header Cache-Control "public";
+            add_header Access-Control-Allow-Origin "*" always;
+        }
+
+        # --- Proxy to Chat UI with script injection + URL rewriting ---
+        location / {
+            proxy_pass http://chat-ui:3000;
+            proxy_http_version 1.1;
+            proxy_set_header Host              $host;
+            proxy_set_header X-Real-IP         $remote_addr;
+            proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
+            proxy_set_header X-Forwarded-Proto $scheme;
+            proxy_set_header Upgrade           $http_upgrade;
+            proxy_set_header Connection        "upgrade";
+
+            # Disable gzip from upstream so sub_filter works
+            proxy_set_header Accept-Encoding "";
+
+            # Rewrite absolute PUBLIC_ORIGIN URLs to relative paths
+            # (fixes CORS when accessed via codespace port-forward)
+            sub_filter 'http://localhost:3000' '';
+            sub_filter '</head>' '<script src="/ruflo/welcome.js" defer></script></head>';
+            sub_filter_once off;
+            sub_filter_types text/html application/json;
+        }
+    }
+}

package/src/nginx/static/favicon-dark.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" fill="none">
+  <path d="M16 2L30 10v12L16 30 2 22V10z" stroke="#00d4ff" stroke-width="2" fill="#0a0a1a"/>
+  <circle cx="16" cy="16" r="5" fill="#7c3aed"/>
+</svg>

package/src/nginx/static/favicon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" fill="none">
+  <path d="M16 2L30 10v12L16 30 2 22V10z" stroke="#7c3aed" stroke-width="2" fill="#ffffff"/>
+  <circle cx="16" cy="16" r="5" fill="#00d4ff"/>
+</svg>

package/src/nginx/static/icon.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
+  <rect width="64" height="64" rx="12" fill="#0a0a1a"/>
+  <path d="M32 8L56 22v20L32 56 8 42V22z" stroke="#00d4ff" stroke-width="2.5" fill="none"/>
+  <circle cx="32" cy="32" r="8" fill="#7c3aed"/>
+</svg>

package/src/nginx/static/logo.svg

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 48" fill="none">
+  <!-- Hexagon icon -->
+  <path d="M20 4L36 13v18L20 40 4 31V13z" stroke="#00d4ff" stroke-width="2" fill="none"/>
+  <circle cx="20" cy="22" r="4" fill="#7c3aed"/>
+  <!-- "Ru" in cyan -->
+  <text x="48" y="34" font-family="system-ui, -apple-system, sans-serif" font-weight="700" font-size="28" fill="#00d4ff">Ru</text>
+  <!-- "Flo" in violet -->
+  <text x="88" y="34" font-family="system-ui, -apple-system, sans-serif" font-weight="700" font-size="28" fill="#7c3aed">Flo</text>
+</svg>

package/src/nginx/static/manifest.json

@@ -0,0 +1,22 @@
+{
+  "name": "RuFlo",
+  "short_name": "RuFlo",
+  "description": "Enterprise AI Agent Orchestration Platform",
+  "start_url": "/",
+  "display": "standalone",
+  "theme_color": "#00d4ff",
+  "background_color": "#0a0a1a",
+  "icons": [
+    {
+      "src": "/chatui/icon.svg",
+      "sizes": "any",
+      "type": "image/svg+xml"
+    },
+    {
+      "src": "/chatui/favicon-dark.svg",
+      "sizes": "any",
+      "type": "image/svg+xml",
+      "purpose": "monochrome"
+    }
+  ]
+}

package/src/nginx/static/welcome.js

@@ -0,0 +1,184 @@
+(function () {
+  "use strict";
+
+  const THREE_CDN = "https://cdn.jsdelivr.net/npm/three@0.169.0/build/three.module.js";
+  const BG_COLOR = 0x0a0a1a;
+  const CYAN = 0x00d4ff;
+  const VIOLET = 0x7c3aed;
+  const AMBER = 0xf59e0b;
+  const PARTICLE_COUNT = 200;
+
+  let scene, camera, renderer, frameId;
+  let icosahedron, octahedron, torus, particles;
+  let textSprite;
+
+  function createTextTexture(text, w, h) {
+    const canvas = document.createElement("canvas");
+    canvas.width = w;
+    canvas.height = h;
+    const ctx = canvas.getContext("2d");
+    const grad = ctx.createLinearGradient(0, 0, w, 0);
+    grad.addColorStop(0, "#00d4ff");
+    grad.addColorStop(1, "#7c3aed");
+    ctx.fillStyle = grad;
+    ctx.font = "bold 72px system-ui, -apple-system, sans-serif";
+    ctx.textAlign = "center";
+    ctx.textBaseline = "middle";
+    ctx.fillText(text, w / 2, h / 2);
+    return canvas;
+  }
+
+  async function initScene(container) {
+    const THREE = await import(THREE_CDN);
+
+    const rect = container.getBoundingClientRect();
+    const width = rect.width || 400;
+    const height = rect.height || 300;
+
+    scene = new THREE.Scene();
+    scene.background = new THREE.Color(BG_COLOR);
+
+    camera = new THREE.PerspectiveCamera(50, width / height, 0.1, 100);
+    camera.position.z = 5;
+
+    renderer = new THREE.WebGLRenderer({ antialias: true, alpha: false });
+    renderer.setSize(width, height);
+    renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
+
+    const canvas = renderer.domElement;
+    canvas.style.width = "100%";
+    canvas.style.height = "100%";
+    canvas.style.display = "block";
+    canvas.style.borderRadius = "12px";
+    container.appendChild(canvas);
+
+    // Wireframe icosahedron (cyan, slow rotation)
+    const icoGeo = new THREE.IcosahedronGeometry(1.4, 1);
+    const icoMat = new THREE.MeshBasicMaterial({ color: CYAN, wireframe: true, transparent: true, opacity: 0.6 });
+    icosahedron = new THREE.Mesh(icoGeo, icoMat);
+    scene.add(icosahedron);
+
+    // Wireframe octahedron (violet, counter-rotation)
+    const octGeo = new THREE.OctahedronGeometry(1.0, 0);
+    const octMat = new THREE.MeshBasicMaterial({ color: VIOLET, wireframe: true, transparent: true, opacity: 0.7 });
+    octahedron = new THREE.Mesh(octGeo, octMat);
+    scene.add(octahedron);
+
+    // Pulse torus ring (cyan, breathing)
+    const torGeo = new THREE.TorusGeometry(2.0, 0.02, 8, 64);
+    const torMat = new THREE.MeshBasicMaterial({ color: CYAN, transparent: true, opacity: 0.4 });
+    torus = new THREE.Mesh(torGeo, torMat);
+    torus.rotation.x = Math.PI / 2;
+    scene.add(torus);
+
+    // Particle field (~200 amber dots in a sphere)
+    const pGeo = new THREE.BufferGeometry();
+    const positions = new Float32Array(PARTICLE_COUNT * 3);
+    for (let i = 0; i < PARTICLE_COUNT; i++) {
+      const r = 1.2 + Math.random() * 1.0;
+      const theta = Math.random() * Math.PI * 2;
+      const phi = Math.acos(2 * Math.random() - 1);
+      positions[i * 3] = r * Math.sin(phi) * Math.cos(theta);
+      positions[i * 3 + 1] = r * Math.sin(phi) * Math.sin(theta);
+      positions[i * 3 + 2] = r * Math.cos(phi);
+    }
+    pGeo.setAttribute("position", new THREE.BufferAttribute(positions, 3));
+    const pMat = new THREE.PointsMaterial({ color: AMBER, size: 0.04, sizeAttenuation: true });
+    particles = new THREE.Points(pGeo, pMat);
+    scene.add(particles);
+
+    // "RuFlo" text sprite
+    const textCanvas = createTextTexture("RuFlo", 512, 128);
+    const tex = new THREE.CanvasTexture(textCanvas);
+    const spriteMat = new THREE.SpriteMaterial({ map: tex, transparent: true, opacity: 0.9 });
+    textSprite = new THREE.Sprite(spriteMat);
+    textSprite.scale.set(2.5, 0.625, 1);
+    textSprite.position.y = -2.2;
+    scene.add(textSprite);
+
+    // Responsive resize
+    const ro = new ResizeObserver(function () {
+      const r2 = container.getBoundingClientRect();
+      const w = r2.width || 400;
+      const h = r2.height || 300;
+      camera.aspect = w / h;
+      camera.updateProjectionMatrix();
+      renderer.setSize(w, h);
+    });
+    ro.observe(container);
+
+    // Animate
+    function animate() {
+      frameId = requestAnimationFrame(animate);
+      const t = performance.now() * 0.001;
+
+      icosahedron.rotation.y = t * 0.3;
+      icosahedron.rotation.x = t * 0.15;
+
+      octahedron.rotation.y = -t * 0.4;
+      octahedron.rotation.z = t * 0.2;
+
+      // Breathing torus
+      const s = 1 + 0.15 * Math.sin(t * 1.5);
+      torus.scale.set(s, s, s);
+
+      // Slow particle rotation
+      particles.rotation.y = t * 0.05;
+      particles.rotation.x = t * 0.02;
+
+      renderer.render(scene, camera);
+    }
+    animate();
+
+    return { ro: ro };
+  }
+
+  function cleanup(refs) {
+    if (frameId) cancelAnimationFrame(frameId);
+    if (refs && refs.ro) refs.ro.disconnect();
+    if (renderer) {
+      renderer.dispose();
+      renderer.forceContextLoss();
+    }
+    scene = camera = renderer = frameId = null;
+  }
+
+  // Watch for the welcome modal's image and replace it
+  let refs = null;
+  const observer = new MutationObserver(function (mutations) {
+    for (const m of mutations) {
+      for (const node of m.addedNodes) {
+        if (!(node instanceof HTMLElement)) continue;
+        const img = node.querySelector
+          ? node.querySelector('img[src*="omni-welcome"], img[src*="huggingchat"]')
+          : null;
+        if (img) {
+          const container = document.createElement("div");
+          container.style.width = "100%";
+          container.style.height = "320px";
+          container.style.position = "relative";
+          container.style.overflow = "hidden";
+          container.style.borderRadius = "12px";
+          img.parentNode.replaceChild(container, img);
+          initScene(container).then(function (r) { refs = r; });
+        }
+      }
+      // Detect modal removal → cleanup
+      for (const node of m.removedNodes) {
+        if (!(node instanceof HTMLElement)) continue;
+        if (node.querySelector && node.querySelector("canvas")) {
+          cleanup(refs);
+          refs = null;
+        }
+      }
+    }
+  });
+
+  if (document.body) {
+    observer.observe(document.body, { childList: true, subtree: true });
+  } else {
+    document.addEventListener("DOMContentLoaded", function () {
+      observer.observe(document.body, { childList: true, subtree: true });
+    });
+  }
+})();

package/src/ruvocal/.claude/skills/add-model-descriptions/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: add-model-descriptions
+description: Add descriptions for new models from the HuggingFace router to chat-ui configuration. Use when new models are released on the router and need descriptions added to prod.yaml and dev.yaml. Triggers on requests like "add new model descriptions", "update models from router", "sync models", or when explicitly invoking /add-model-descriptions.
+---
+
+# Add Model Descriptions
+
+Add descriptions for new models available in the HuggingFace router to chat-ui's prod.yaml and dev.yaml.
+
+## Workflow
+
+1. **Fetch models from router**
+
+   ```
+   WebFetch https://router.huggingface.co/v1/models
+   ```
+
+   Extract all model IDs from the response.
+
+2. **Read current configuration**
+
+   - Read `chart/env/prod.yaml`
+   - Extract model IDs from the `MODELS` JSON array in `envVars`
+
+3. **Identify missing models**
+   Compare router models with prod.yaml. Missing = in router but not in prod.yaml.
+
+4. **Research each missing model**
+   For each missing model, search the web for its specifications:
+
+   - Model architecture (dense, MoE, parameters)
+   - Key capabilities (coding, reasoning, vision, multilingual, etc.)
+   - Target use cases
+
+5. **Write descriptions**
+   Match existing style:
+
+   - 8-12 words
+   - Sentence fragments (no period needed)
+   - No articles ("a", "the") unless necessary
+   - Focus on: architecture, specialization, key capability
+
+   Examples:
+
+   - `"Flagship GLM MoE for coding, reasoning, and agentic tool use."`
+   - `"MoE agent model with multilingual coding and fast outputs."`
+   - `"Vision-language Qwen for documents, GUI agents, and visual reasoning."`
+   - `"Mobile agent for multilingual Android device automation."`
+
+6. **Update both files**
+   Add new models at the TOP of the MODELS array in:
+
+   - `chart/env/prod.yaml`
+   - `chart/env/dev.yaml`
+
+   Format:
+
+   ```json
+   { "id": "org/model-name", "description": "Description here." }
+   ```
+
+7. **Commit changes**
+   ```
+   git add chart/env/prod.yaml chart/env/dev.yaml
+   git commit -m "feat: add descriptions for N new models from router"
+   ```
+
+## Notes
+
+- FP8 variants: describe as "FP8 [base model] for efficient inference with [key capability]"
+- Vision models: mention "vision-language" and key visual tasks
+- Agent models: mention "agent" and automation capabilities
+- Regional models: mention language focus (e.g., "European multilingual", "Southeast Asian")

package/src/ruvocal/.devcontainer/Dockerfile

@@ -0,0 +1,9 @@
+FROM mcr.microsoft.com/devcontainers/typescript-node:1-22-bookworm
+
+# Install MongoDB tools (mongosh, mongorestore, mongodump) directly from MongoDB repository
+RUN curl -fsSL https://www.mongodb.org/static/pgp/server-8.0.asc | gpg --dearmor -o /usr/share/keyrings/mongodb-server-8.0.gpg && \
+    echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] http://repo.mongodb.org/apt/debian bookworm/mongodb-org/8.0 main" | tee /etc/apt/sources.list.d/mongodb-org-8.0.list && \
+    apt-get update && \
+    apt-get install -y mongodb-mongosh mongodb-database-tools vim && \
+    apt-get autoremove -y && \
+    rm -rf /var/lib/apt/lists/*

package/src/ruvocal/.devcontainer/devcontainer.json

@@ -0,0 +1,36 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/typescript-node
+{
+	"name": "Node.js & TypeScript",
+	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+	"build": {
+		"dockerfile": "Dockerfile"
+	},
+
+	"customizations": {
+		"vscode": {
+			"extensions": ["esbenp.prettier-vscode", "dbaeumer.vscode-eslint", "svelte.svelte-vscode"]
+		}
+	},
+
+	"features": {
+		// Install docker in container
+		"ghcr.io/devcontainers/features/docker-in-docker:2": {
+			// Use proprietary docker engine. I get a timeout error when using the default moby engine and loading
+			// microsoft's PGP keys
+			"moby": false
+		}
+	}
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	// "forwardPorts": [],
+
+	// Use 'postCreateCommand' to run commands after the container is created.
+	// "postCreateCommand": "yarn install",
+
+	// Configure tool-specific properties.
+	// "customizations": {},
+
+	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+	// "remoteUser": "root"
+}

package/src/ruvocal/.dockerignore

@@ -0,0 +1,17 @@
+Dockerfile
+.vscode/
+.idea
+.gitignore
+LICENSE
+README.md
+node_modules/
+.svelte-kit/
+.env*
+!.env
+.env.local
+db
+# NOTE: previously had `models/**` here to ignore a top-level placeholder
+# directory. Even when anchored (`/models/**`), Docker's pattern matcher
+# was eliding nested src/routes/api/v2/models/ and src/routes/models/
+# from the build context, producing prod images missing those routes.
+# The placeholder dir is small (single .txt) — letting it through is fine.

package/src/ruvocal/.eslintignore

@@ -0,0 +1,13 @@
+.DS_Store
+node_modules
+/build
+/.svelte-kit
+/package
+.env
+.env.*
+!.env.example
+
+# Ignore files for PNPM, NPM and YARN
+pnpm-lock.yaml
+package-lock.json
+yarn.lock

package/src/ruvocal/.eslintrc.cjs

@@ -0,0 +1,45 @@
+module.exports = {
+	root: true,
+	parser: "@typescript-eslint/parser",
+	extends: [
+		"eslint:recommended",
+		"plugin:@typescript-eslint/recommended",
+		"plugin:svelte/recommended",
+		"prettier",
+	],
+	plugins: ["@typescript-eslint"],
+	ignorePatterns: ["*.cjs"],
+	overrides: [
+		{
+			files: ["*.svelte"],
+			parser: "svelte-eslint-parser",
+			parserOptions: {
+				parser: "@typescript-eslint/parser",
+			},
+		},
+	],
+	parserOptions: {
+		sourceType: "module",
+		ecmaVersion: 2020,
+		extraFileExtensions: [".svelte"],
+	},
+	rules: {
+		"no-empty": "off",
+		"require-yield": "off",
+		"@typescript-eslint/no-explicit-any": "error",
+		"@typescript-eslint/no-non-null-assertion": "error",
+		"@typescript-eslint/no-unused-vars": [
+			// prevent variables with a _ prefix from being marked as unused
+			"error",
+			{
+				argsIgnorePattern: "^_",
+			},
+		],
+		"object-shorthand": ["error", "always"],
+	},
+	env: {
+		browser: true,
+		es2017: true,
+		node: true,
+	},
+};

package/src/ruvocal/.gcloudignore

@@ -0,0 +1,18 @@
+# gcloud builds submit upload filter.
+# Without this file, gcloud falls back to .gitignore, which has
+# `models/*` (line 16) — that excludes src/routes/api/v2/models/*
+# and src/routes/models/* from the build context, producing
+# production images missing those SvelteKit routes (root cause
+# of /api/v2/models 404 → /favicon 500 → / 500 in Cloud Run).
+
+.git/
+.gitignore
+.dockerignore
+.gcloudignore
+node_modules/
+.svelte-kit/
+build/
+.env.local
+.vscode/
+.idea/
+*.log

package/src/ruvocal/.github/ISSUE_TEMPLATE/bug-report--chat-ui-.md

@@ -0,0 +1,43 @@
+---
+name: Bug Report (chat-ui)
+about: Use this for confirmed issues with chat-ui
+title: ""
+labels: bug
+assignees: ""
+---
+
+## Bug description
+
+<!-- A clear and concise description of what the bug is. -->
+
+## Steps to reproduce
+
+<!-- Steps to reproduce the issue -->
+
+## Screenshots
+
+<!-- If applicable, add screenshots to help explain your problem. -->
+
+## Context
+
+### Logs
+
+<!-- Add any logs that are relevant to your issue. Could be browser or server logs. Wrap in code blocks. -->
+
+```
+// logs here if relevant
+```
+
+### Specs
+
+- **OS**:
+- **Browser**:
+- **chat-ui commit**:
+
+### Config
+
+<!-- Add the environment variables you've used to setup chat-ui, making sure to redact any secrets. -->
+
+## Notes
+
+<!-- Anything else relevant to help the issue get solved -->

package/src/ruvocal/.github/ISSUE_TEMPLATE/config-support.md

@@ -0,0 +1,9 @@
+---
+name: Config Support
+about: Help with setting up chat-ui locally
+title: ""
+labels: support
+assignees: ""
+---
+
+**Please use the discussions on GitHub** for getting help with setting things up instead of opening an issue: https://github.com/huggingface/chat-ui/discussions

package/src/ruvocal/.github/ISSUE_TEMPLATE/feature-request--chat-ui-.md

@@ -0,0 +1,17 @@
+---
+name: Feature Request (chat-ui)
+about: Suggest new features to be added to chat-ui
+title: ""
+labels: enhancement
+assignees: ""
+---
+
+## Describe your feature request
+
+<!-- Short description of what this is about -->
+
+## Screenshots (if relevant)
+
+## Implementation idea
+
+<!-- If you know how this should be implemented in the codebase, share your thoughts. Let us know if you feel like implementing it yourself as well! -->

package/src/ruvocal/.github/ISSUE_TEMPLATE/huggingchat.md

@@ -0,0 +1,11 @@
+---
+name: HuggingChat
+about: Requests & reporting outages on HuggingChat, the hosted version of chat-ui.
+title: ""
+labels: huggingchat
+assignees: ""
+---
+
+**Do not use GitHub issues** for requesting models on HuggingChat or reporting issues with HuggingChat being down/overloaded.
+
+**Use the discussions page on the hub instead:** https://huggingface.co/spaces/huggingchat/chat-ui/discussions

package/src/ruvocal/.github/release.yml

@@ -0,0 +1,16 @@
+changelog:
+  exclude:
+    labels:
+      - huggingchat
+      - CI/CD
+      - documentation
+  categories:
+    - title: Features
+      labels:
+        - enhancement
+    - title: Bugfixes
+      labels:
+        - bug
+    - title: Other changes
+      labels:
+        - "*"

package/src/ruvocal/.github/workflows/build-docs.yml

@@ -0,0 +1,18 @@
+name: Build documentation
+
+on:
+  push:
+    branches:
+      - main
+      - v*-release
+
+jobs:
+  build:
+    uses: huggingface/doc-builder/.github/workflows/build_main_documentation.yml@main
+    with:
+      commit_sha: ${{ github.sha }}
+      package: chat-ui
+      additional_args: --not_python_module
+    secrets:
+      token: ${{ secrets.HUGGINGFACE_PUSH }}
+      hf_token: ${{ secrets.HF_DOC_BUILD_PUSH }}