ruflo 3.5.2 → 3.5.4

package/src/ruvocal/docs/source/configuration/overview.md

@@ -0,0 +1,89 @@
+# Configuration Overview
+
+Chat UI is configured through environment variables. Default values are in `.env`; override them in `.env.local` or via your environment.
+
+## Required Configuration
+
+Chat UI connects to any OpenAI-compatible API endpoint:
+
+```ini
+OPENAI_BASE_URL=https://router.huggingface.co/v1
+OPENAI_API_KEY=hf_************************
+```
+
+Models are automatically discovered from `${OPENAI_BASE_URL}/models`. No manual model configuration is required.
+
+## Database
+
+```ini
+MONGODB_URL=mongodb://localhost:27017
+MONGODB_DB_NAME=chat-ui
+```
+
+For development, `MONGODB_URL` is optional - Chat UI falls back to an embedded MongoDB that persists to `./db`.
+
+## Model Overrides
+
+To customize model behavior, use the `MODELS` environment variable (JSON5 format):
+
+```ini
+MODELS=`[
+  {
+    "id": "meta-llama/Llama-3.3-70B-Instruct",
+    "name": "Llama 3.3 70B",
+    "multimodal": false,
+    "supportsTools": true
+  }
+]`
+```
+
+Override properties:
+
+- `id` - Model identifier (must match an ID from the `/models` endpoint)
+- `name` - Display name in the UI
+- `multimodal` - Enable image uploads
+- `supportsTools` - Enable MCP tool calling for models that don’t advertise tool support
+- `parameters` - Override default parameters (temperature, max_tokens, etc.)
+
+## Task Model
+
+Set a specific model for internal tasks (title generation, etc.):
+
+```ini
+TASK_MODEL=meta-llama/Llama-3.1-8B-Instruct
+```
+
+If not set, the current conversation model is used.
+
+## Voice Transcription
+
+Enable voice input with Whisper:
+
+```ini
+TRANSCRIPTION_MODEL=openai/whisper-large-v3-turbo
+TRANSCRIPTION_BASE_URL=https://router.huggingface.co/hf-inference/models
+```
+
+## Feature Flags
+
+```ini
+LLM_SUMMARIZATION=true          # Enable automatic conversation title generation
+ENABLE_DATA_EXPORT=true         # Allow users to export their data
+ALLOW_IFRAME=false              # Disallow embedding in iframes (set to true to allow)
+```
+
+## User Authentication
+
+Use OpenID Connect for authentication:
+
+```ini
+OPENID_CLIENT_ID=your_client_id
+OPENID_CLIENT_SECRET=your_client_secret
+OPENID_SCOPES="openid profile"
+```
+
+See [OpenID configuration](./open-id) for details.
+
+## Environment Variable Reference
+
+See the [`.env` file](https://github.com/huggingface/chat-ui/blob/main/.env) for the complete list of available options.

package/src/ruvocal/docs/source/configuration/theming.md

@@ -0,0 +1,20 @@
+# Theming
+
+Customize the look and feel of Chat UI with these environment variables:
+
+```ini
+PUBLIC_APP_NAME=ChatUI
+PUBLIC_APP_ASSETS=chatui
+PUBLIC_APP_DESCRIPTION="Making the community's best AI chat models available to everyone."
+```
+
+- `PUBLIC_APP_NAME` - The name used as a title throughout the app
+- `PUBLIC_APP_ASSETS` - Directory for logos & favicons in `static/$PUBLIC_APP_ASSETS`. Options: `chatui`, `huggingchat`
+- `PUBLIC_APP_DESCRIPTION` - Description shown in meta tags and about sections
+
+## Additional Options
+
+```ini
+PUBLIC_APP_DATA_SHARING=1    # Show data sharing opt-in toggle in settings
+PUBLIC_ORIGIN=https://chat.example.com  # Your public URL (required for sharing)
+```

package/src/ruvocal/docs/source/developing/architecture.md

@@ -0,0 +1,48 @@
+# Architecture
+
+This document provides a high-level overview of the Chat UI codebase. If you're looking to contribute or understand how the codebase works, this is the place for you!
+
+## Overview
+
+Chat UI provides a simple interface connecting LLMs to external tools via MCP. The project uses [MongoDB](https://www.mongodb.com/) and [SvelteKit](https://kit.svelte.dev/) with [Tailwind](https://tailwindcss.com/).
+
+Key architectural decisions:
+
+- **OpenAI-compatible only**: All model interactions use the OpenAI API format
+- **MCP for tools**: Tool calling is handled via Model Context Protocol servers
+- **Auto-discovery**: Models are discovered from the `/models` endpoint
+
+## Code Map
+
+### `routes`
+
+All routes rendered with SSR via SvelteKit. The majority of backend and frontend logic lives here, with shared modules in `lib` (client) and `lib/server` (server).
+
+### `textGeneration`
+
+Provides a standard interface for chat features including model output, tool calls, and streaming. Outputs `MessageUpdate`s for fine-grained status updates (new tokens, tool results, etc.).
+
+### `endpoints`
+
+Provides the streaming interface for OpenAI-compatible endpoints. Models are fetched and cached from `${OPENAI_BASE_URL}/models`.
+
+### `mcp`
+
+Implements MCP client functionality for tool discovery and execution. See [MCP Tools](../configuration/mcp-tools) for configuration.
+
+### `llmRouter`
+
+Intelligent routing logic that selects the best model for each request. Uses the Arch router model for classification. See [LLM Router](../configuration/llm-router) for details.
+
+### `migrations`
+
+MongoDB migrations for maintaining backwards compatibility across schema changes. Any schema changes must include a migration.
+
+## Development
+
+```bash
+npm install
+npm run dev
+```
+
+The dev server runs at `http://localhost:5173` with hot reloading.

package/src/ruvocal/docs/source/index.md

@@ -0,0 +1,53 @@
+# Chat UI
+
+Open source chat interface with support for tools, multimodal inputs, and intelligent routing across models. The app uses MongoDB and SvelteKit behind the scenes. Try the live version called [HuggingChat on hf.co/chat](https://huggingface.co/chat) or [setup your own instance](./installation/local).
+
+Chat UI connects to any OpenAI-compatible API endpoint, making it work with:
+
+- [Hugging Face Inference Providers](https://huggingface.co/docs/inference-providers)
+- [Ollama](https://ollama.ai)
+- [llama.cpp](https://github.com/ggerganov/llama.cpp)
+- [OpenRouter](https://openrouter.ai)
+- Any other OpenAI-compatible service
+
+**[MCP Tools](./configuration/mcp-tools)**: Function calling via Model Context Protocol (MCP) servers
+
+**[LLM Router](./configuration/llm-router)**: Intelligent routing to select the best model for each request
+
+**[Multimodal](./configuration/overview)**: Image uploads on models that support vision
+
+**[OpenID](./configuration/open-id)**: Optional user authentication via OpenID Connect
+
+## Quickstart
+
+**Step 1 - Create `.env.local`:**
+
+```ini
+OPENAI_BASE_URL=https://router.huggingface.co/v1
+OPENAI_API_KEY=hf_************************
+```
+
+You can use any OpenAI-compatible endpoint:
+
+| Provider     | `OPENAI_BASE_URL`                  | `OPENAI_API_KEY` |
+| ------------ | ---------------------------------- | ---------------- |
+| Hugging Face | `https://router.huggingface.co/v1` | `hf_xxx`         |
+| Ollama       | `http://127.0.0.1:11434/v1`        | `ollama`         |
+| llama.cpp    | `http://127.0.0.1:8080/v1`         | `sk-local`       |
+| OpenRouter   | `https://openrouter.ai/api/v1`     | `sk-or-v1-xxx`   |
+
+**Step 2 - Install and run:**
+
+```bash
+git clone https://github.com/huggingface/chat-ui
+cd chat-ui
+npm install
+npm run dev -- --open
+```
+
+That's it! Chat UI will automatically discover available models from your endpoint.
+
+> [!TIP]
+> MongoDB is optional for development. When `MONGODB_URL` is not set, Chat UI uses an embedded database that persists to `./db`.
+
+For production deployments, see the [installation guides](./installation/local).

package/src/ruvocal/docs/source/installation/docker.md

@@ -0,0 +1,43 @@
+# Running on Docker
+
+Pre-built Docker images are available:
+
+- **`ghcr.io/huggingface/chat-ui-db`** - Includes MongoDB (recommended for quick setup)
+- **`ghcr.io/huggingface/chat-ui`** - Requires external MongoDB
+
+## Quick Start (with bundled MongoDB)
+
+```bash
+docker run -p 3000:3000 \
+  -e OPENAI_BASE_URL=https://router.huggingface.co/v1 \
+  -e OPENAI_API_KEY=hf_*** \
+  -v chat-ui-data:/data \
+  ghcr.io/huggingface/chat-ui-db
+```
+
+## With External MongoDB
+
+If you have an existing MongoDB instance:
+
+```bash
+docker run -p 3000:3000 \
+  -e OPENAI_BASE_URL=https://router.huggingface.co/v1 \
+  -e OPENAI_API_KEY=hf_*** \
+  -e MONGODB_URL=mongodb://host.docker.internal:27017 \
+  ghcr.io/huggingface/chat-ui
+```
+
+Use `host.docker.internal` to reach MongoDB running on your host machine, or provide your MongoDB Atlas connection string.
+
+## Using an Environment File
+
+For more configuration options, use `--env-file` to avoid leaking secrets in shell history:
+
+```bash
+docker run -p 3000:3000 \
+  --env-file .env.local \
+  -v chat-ui-data:/data \
+  ghcr.io/huggingface/chat-ui-db
+```
+
+See the [configuration overview](../configuration/overview) for all available environment variables.

package/src/ruvocal/docs/source/installation/helm.md

@@ -0,0 +1,43 @@
+# Helm
+
+<Tip warning={true}>
+
+The Helm chart is a work in progress and should be considered unstable. Breaking changes may be pushed without migration guides. Contributions welcome!
+
+</Tip>
+
+For Kubernetes deployment, use the Helm chart in `/chart`. No chart repository is published, so clone the repository and install by path.
+
+## Installation
+
+```bash
+git clone https://github.com/huggingface/chat-ui
+cd chat-ui
+helm install chat-ui ./chart -f values.yaml
+```
+
+## Example values.yaml
+
+```yaml
+replicas: 1
+
+domain: example.com
+
+service:
+  type: ClusterIP
+
+resources:
+  requests:
+    cpu: 100m
+    memory: 2Gi
+  limits:
+    cpu: "4"
+    memory: 6Gi
+
+envVars:
+  OPENAI_BASE_URL: https://router.huggingface.co/v1
+  OPENAI_API_KEY: hf_***
+  MONGODB_URL: mongodb://chat-ui-mongo:27017
+```
+
+See the [configuration overview](../configuration/overview) for all available environment variables.

package/src/ruvocal/docs/source/installation/local.md

@@ -0,0 +1,62 @@
+# Running Locally
+
+## Quick Start
+
+1. Create a `.env.local` file with your API credentials:
+
+```ini
+OPENAI_BASE_URL=https://router.huggingface.co/v1
+OPENAI_API_KEY=hf_************************
+```
+
+2. Install and run:
+
+```bash
+npm install
+npm run dev -- --open
+```
+
+That's it! Chat UI will discover available models automatically from your endpoint.
+
+## Configuration
+
+Chat UI connects to any OpenAI-compatible API. Set `OPENAI_BASE_URL` to your provider:
+
+| Provider     | `OPENAI_BASE_URL`                  |
+| ------------ | ---------------------------------- |
+| Hugging Face | `https://router.huggingface.co/v1` |
+| Ollama       | `http://127.0.0.1:11434/v1`        |
+| llama.cpp    | `http://127.0.0.1:8080/v1`         |
+| OpenRouter   | `https://openrouter.ai/api/v1`     |
+
+See the [configuration overview](../configuration/overview) for all available options.
+
+## Database
+
+For **development**, MongoDB is optional. When `MONGODB_URL` is not set, Chat UI uses an embedded MongoDB server that persists data to the `./db` folder.
+
+For **production**, you should use a dedicated MongoDB instance:
+
+### Option 1: Local MongoDB (Docker)
+
+```bash
+docker run -d -p 27017:27017 -v mongo-chat-ui:/data --name mongo-chat-ui mongo:latest
+```
+
+Then set `MONGODB_URL=mongodb://localhost:27017` in `.env.local`.
+
+### Option 2: MongoDB Atlas (Managed)
+
+Use [MongoDB Atlas free tier](https://www.mongodb.com/pricing) for a managed database. Copy the connection string to `MONGODB_URL`.
+
+## Running in Production
+
+For production deployments:
+
+```bash
+npm install
+npm run build
+npm run preview
+```
+
+The server listens on `http://localhost:4173` by default.

package/src/ruvocal/entrypoint.sh

@@ -0,0 +1,19 @@
+ENV_LOCAL_PATH=/app/.env.local
+
+if test -z "${DOTENV_LOCAL}" ; then
+    if ! test -f "${ENV_LOCAL_PATH}" ; then
+        echo "DOTENV_LOCAL was not found in the ENV variables and .env.local is not set using a bind volume. Make sure to set environment variables properly. "
+    fi;
+else
+    echo "DOTENV_LOCAL was found in the ENV variables. Creating .env.local file."
+    cat <<< "$DOTENV_LOCAL" > ${ENV_LOCAL_PATH}
+fi;
+
+if [ "$INCLUDE_DB" = "true" ] ; then
+    echo "Starting local MongoDB instance"
+    nohup mongod &
+fi;
+
+export PUBLIC_VERSION=$(node -p "require('./package.json').version")
+
+dotenv -e /app/.env -c -- node --dns-result-order=ipv4first /app/build/index.js -- --host 0.0.0.0 --port 3000

package/src/ruvocal/mcp-bridge/.claude-flow/agents/store.json

@@ -0,0 +1,27 @@
+{
+  "agents": {
+    "dev-tools-analyst": {
+      "agentId": "dev-tools-analyst",
+      "agentType": "specialist",
+      "status": "idle",
+      "health": 1,
+      "taskCount": 0,
+      "config": {},
+      "createdAt": "2026-03-05T14:28:08.095Z",
+      "domain": "devtools",
+      "model": "sonnet",
+      "modelRoutedBy": "router"
+    },
+    "agent-1772720891056-ej1e1o": {
+      "agentId": "agent-1772720891056-ej1e1o",
+      "status": "idle",
+      "health": 1,
+      "taskCount": 0,
+      "config": {},
+      "createdAt": "2026-03-05T14:28:11.056Z",
+      "model": "sonnet",
+      "modelRoutedBy": "default"
+    }
+  },
+  "version": "3.0.0"
+}

package/src/ruvocal/mcp-bridge/.claude-flow/daemon-state.json

@@ -0,0 +1,130 @@
+{
+  "running": true,
+  "startedAt": "2026-03-05T05:43:14.456Z",
+  "workers": {
+    "map": {
+      "runCount": 0,
+      "successCount": 0,
+      "failureCount": 0,
+      "averageDurationMs": 0,
+      "isRunning": false,
+      "nextRun": "2026-03-05T05:43:14.456Z"
+    },
+    "audit": {
+      "runCount": 0,
+      "successCount": 0,
+      "failureCount": 0,
+      "averageDurationMs": 0,
+      "isRunning": false,
+      "nextRun": "2026-03-05T05:45:14.456Z"
+    },
+    "optimize": {
+      "runCount": 0,
+      "successCount": 0,
+      "failureCount": 0,
+      "averageDurationMs": 0,
+      "isRunning": false,
+      "nextRun": "2026-03-05T05:47:14.456Z"
+    },
+    "consolidate": {
+      "runCount": 0,
+      "successCount": 0,
+      "failureCount": 0,
+      "averageDurationMs": 0,
+      "isRunning": false,
+      "nextRun": "2026-03-05T05:49:14.456Z"
+    },
+    "testgaps": {
+      "runCount": 0,
+      "successCount": 0,
+      "failureCount": 0,
+      "averageDurationMs": 0,
+      "isRunning": false,
+      "nextRun": "2026-03-05T05:51:14.456Z"
+    },
+    "predict": {
+      "runCount": 0,
+      "successCount": 0,
+      "failureCount": 0,
+      "averageDurationMs": 0,
+      "isRunning": false
+    },
+    "document": {
+      "runCount": 0,
+      "successCount": 0,
+      "failureCount": 0,
+      "averageDurationMs": 0,
+      "isRunning": false
+    }
+  },
+  "config": {
+    "autoStart": false,
+    "logDir": "/workspaces/dev/packages/ruvocal/mcp-bridge/.claude-flow/logs",
+    "stateFile": "/workspaces/dev/packages/ruvocal/mcp-bridge/.claude-flow/daemon-state.json",
+    "maxConcurrent": 2,
+    "workerTimeoutMs": 300000,
+    "resourceThresholds": {
+      "maxCpuLoad": 2,
+      "minFreeMemoryPercent": 20
+    },
+    "workers": [
+      {
+        "type": "map",
+        "intervalMs": 900000,
+        "offsetMs": 0,
+        "priority": "normal",
+        "description": "Codebase mapping",
+        "enabled": true
+      },
+      {
+        "type": "audit",
+        "intervalMs": 600000,
+        "offsetMs": 120000,
+        "priority": "critical",
+        "description": "Security analysis",
+        "enabled": true
+      },
+      {
+        "type": "optimize",
+        "intervalMs": 900000,
+        "offsetMs": 240000,
+        "priority": "high",
+        "description": "Performance optimization",
+        "enabled": true
+      },
+      {
+        "type": "consolidate",
+        "intervalMs": 1800000,
+        "offsetMs": 360000,
+        "priority": "low",
+        "description": "Memory consolidation",
+        "enabled": true
+      },
+      {
+        "type": "testgaps",
+        "intervalMs": 1200000,
+        "offsetMs": 480000,
+        "priority": "normal",
+        "description": "Test coverage analysis",
+        "enabled": true
+      },
+      {
+        "type": "predict",
+        "intervalMs": 600000,
+        "offsetMs": 0,
+        "priority": "low",
+        "description": "Predictive preloading",
+        "enabled": false
+      },
+      {
+        "type": "document",
+        "intervalMs": 3600000,
+        "offsetMs": 0,
+        "priority": "low",
+        "description": "Auto-documentation",
+        "enabled": false
+      }
+    ]
+  },
+  "savedAt": "2026-03-05T05:43:14.456Z"
+}

package/src/ruvocal/mcp-bridge/.claude-flow/daemon.pid

@@ -0,0 +1 @@
+1653416

package/src/ruvocal/mcp-bridge/.claude-flow/tasks/store.json

@@ -0,0 +1,21 @@
+{
+  "tasks": {
+    "task-1772720955201-4zlm4r": {
+      "taskId": "task-1772720955201-4zlm4r",
+      "type": "feature",
+      "description": "Parent Task: Set up the foundational infrastructure and environment for the new feature development.",
+      "priority": "high",
+      "status": "pending",
+      "progress": 0,
+      "assignedTo": [],
+      "tags": [
+        "project-plan",
+        "phase-1"
+      ],
+      "createdAt": "2026-03-05T14:29:15.201Z",
+      "startedAt": null,
+      "completedAt": null
+    }
+  },
+  "version": "3.0.0"
+}

package/src/ruvocal/mcp-bridge/.swarm/hnsw.metadata.json

@@ -0,0 +1 @@
+[["entry_1772689071771_axjl3o",{"id":"entry_1772689071771_axjl3o","key":"test-key","namespace":"test","content":"hello from MCP test"}]]

package/src/ruvocal/mcp-bridge/.swarm/model-router-state.json

@@ -0,0 +1,14 @@
+{
+  "totalDecisions": 1,
+  "modelDistribution": {
+    "haiku": 0,
+    "sonnet": 0,
+    "opus": 1,
+    "inherit": 0
+  },
+  "avgComplexity": 0.3007142857142857,
+  "avgConfidence": 0.5660504201680672,
+  "circuitBreakerTrips": 0,
+  "lastUpdated": "2026-03-05T14:28:08.095Z",
+  "learningHistory": []
+}