ruflo 3.42.3 → 3.42.4

package/src/ruvocal/CLAUDE.md

@@ -1,126 +1,126 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Overview
-
-Chat UI is a SvelteKit application that provides a chat interface for LLMs. It powers HuggingChat (hf.co/chat). The app speaks exclusively to OpenAI-compatible APIs via `OPENAI_BASE_URL`.
-
-## Commands
-
-```bash
-npm run dev          # Start dev server on localhost:5173
-npm run build        # Production build
-npm run preview      # Preview production build
-npm run check        # TypeScript validation (svelte-kit sync + svelte-check)
-npm run lint         # Check formatting (Prettier) and linting (ESLint)
-npm run format       # Auto-format with Prettier
-npm run test         # Run all tests (Vitest)
-```
-
-### Running a Single Test
-
-```bash
-npx vitest run path/to/file.spec.ts        # Run specific test file
-npx vitest run -t "test name"              # Run test by name
-npx vitest --watch path/to/file.spec.ts    # Watch mode for single file
-```
-
-### Test Environments
-
-Tests are split into three workspaces (configured in vite.config.ts):
-
-- **Client tests** (`*.svelte.test.ts`): Browser environment with Playwright
-- **SSR tests** (`*.ssr.test.ts`): Node environment for server-side rendering
-- **Server tests** (`*.test.ts`, `*.spec.ts`): Node environment for utilities
-
-## Architecture
-
-### Stack
-
-- **SvelteKit 2** with Svelte 5 (uses runes: `$state`, `$effect`, `$bindable`)
-- **MongoDB** for persistence (auto-fallback to in-memory with MongoMemoryServer when `MONGODB_URL` not set)
-- **TailwindCSS** for styling
-
-### Key Directories
-
-```
-src/
-├── lib/
-│   ├── components/       # Svelte components (chat/, mcp/, voice/, icons/)
-│   ├── server/
-│   │   ├── api/utils/       # Shared API helpers (auth, superjson, model/conversation resolvers)
-│   │   ├── textGeneration/  # LLM streaming pipeline
-│   │   ├── mcp/          # Model Context Protocol integration
-│   │   ├── router/       # Smart model routing (Omni)
-│   │   ├── database.ts   # MongoDB collections
-│   │   ├── models.ts     # Model registry from OPENAI_BASE_URL/models
-│   │   └── auth.ts       # OpenID Connect authentication
-│   ├── types/            # TypeScript interfaces (Conversation, Message, User, Model, etc.)
-│   ├── stores/           # Svelte stores for reactive state
-│   └── utils/            # Helpers (tree/, marked.ts, auth.ts, etc.)
-├── routes/               # SvelteKit file-based routing
-│   ├── conversation/[id]/  # Chat page + streaming endpoint
-│   ├── settings/         # User settings pages
-│   ├── api/              # Legacy v1 API endpoints (mcp, transcribe, fetch-url)
-│   ├── api/v2/           # REST API endpoints (+server.ts)
-│   └── r/[id]/           # Shared conversation view
-```
-
-### Text Generation Flow
-
-1. User sends message via `POST /conversation/[id]`
-2. Server validates user, fetches conversation history
-3. Builds message tree structure (see `src/lib/utils/tree/`)
-4. Calls LLM endpoint via OpenAI client
-5. Streams response back, stores in MongoDB
-
-### Model Context Protocol (MCP)
-
-MCP servers are configured via `MCP_SERVERS` env var. When enabled, tools are exposed as OpenAI function calls. The router can auto-select tools-capable models when `LLM_ROUTER_ENABLE_TOOLS=true`.
-
-### LLM Router (Omni)
-
-Smart routing via Arch-Router model. Configured with:
-
-- `LLM_ROUTER_ROUTES_PATH`: JSON file defining routes
-- `LLM_ROUTER_ARCH_BASE_URL`: Router endpoint
-- Shortcuts: multimodal routes bypass router if `LLM_ROUTER_ENABLE_MULTIMODAL=true`
-
-### Database Collections
-
-- `conversations` - Chat sessions with nested messages
-- `users` - User accounts (OIDC-backed)
-- `sessions` - Session data
-- `sharedConversations` - Public share links
-- `settings` - User preferences
-
-## Environment Setup
-
-Copy `.env` to `.env.local` and configure:
-
-```env
-OPENAI_BASE_URL=https://router.huggingface.co/v1
-OPENAI_API_KEY=hf_***
-# MONGODB_URL is optional; omit for in-memory DB persisted to ./db
-```
-
-See `.env` for full list of variables including router config, MCP servers, auth, and feature flags.
-
-## Code Conventions
-
-- TypeScript strict mode enabled
-- ESLint: no `any`, no non-null assertions
-- Prettier: tabs, 100 char width, Tailwind class sorting
-- Server vs client separation via SvelteKit conventions (`+page.server.ts` vs `+page.ts`)
-
-## Feature Development Checklist
-
-When building new features, consider:
-
-1. **HuggingChat vs self-hosted**: Wrap HuggingChat-specific features with `publicConfig.isHuggingChat`
-2. **Settings persistence**: Add new fields to `src/lib/types/Settings.ts`, update API endpoint at `src/routes/api/v2/user/settings/+server.ts`
-3. **Rich dropdowns**: Use `bits-ui` (Select, DropdownMenu) instead of native elements when you need icons/images in options
-4. **Scrollbars**: Use `scrollbar-custom` class for styled scrollbars
-5. **Icons**: Custom icons in `$lib/components/icons/`, use Carbon (`~icons/carbon/*`) or Lucide (`~icons/lucide/*`) for standard icons
-6. **Provider avatars**: Use `PROVIDERS_HUB_ORGS` from `@huggingface/inference` for HF provider avatar URLs
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+Chat UI is a SvelteKit application that provides a chat interface for LLMs. It powers HuggingChat (hf.co/chat). The app speaks exclusively to OpenAI-compatible APIs via `OPENAI_BASE_URL`.
+
+## Commands
+
+```bash
+npm run dev          # Start dev server on localhost:5173
+npm run build        # Production build
+npm run preview      # Preview production build
+npm run check        # TypeScript validation (svelte-kit sync + svelte-check)
+npm run lint         # Check formatting (Prettier) and linting (ESLint)
+npm run format       # Auto-format with Prettier
+npm run test         # Run all tests (Vitest)
+```
+
+### Running a Single Test
+
+```bash
+npx vitest run path/to/file.spec.ts        # Run specific test file
+npx vitest run -t "test name"              # Run test by name
+npx vitest --watch path/to/file.spec.ts    # Watch mode for single file
+```
+
+### Test Environments
+
+Tests are split into three workspaces (configured in vite.config.ts):
+
+- **Client tests** (`*.svelte.test.ts`): Browser environment with Playwright
+- **SSR tests** (`*.ssr.test.ts`): Node environment for server-side rendering
+- **Server tests** (`*.test.ts`, `*.spec.ts`): Node environment for utilities
+
+## Architecture
+
+### Stack
+
+- **SvelteKit 2** with Svelte 5 (uses runes: `$state`, `$effect`, `$bindable`)
+- **MongoDB** for persistence (auto-fallback to in-memory with MongoMemoryServer when `MONGODB_URL` not set)
+- **TailwindCSS** for styling
+
+### Key Directories
+
+```
+src/
+├── lib/
+│   ├── components/       # Svelte components (chat/, mcp/, voice/, icons/)
+│   ├── server/
+│   │   ├── api/utils/       # Shared API helpers (auth, superjson, model/conversation resolvers)
+│   │   ├── textGeneration/  # LLM streaming pipeline
+│   │   ├── mcp/          # Model Context Protocol integration
+│   │   ├── router/       # Smart model routing (Omni)
+│   │   ├── database.ts   # MongoDB collections
+│   │   ├── models.ts     # Model registry from OPENAI_BASE_URL/models
+│   │   └── auth.ts       # OpenID Connect authentication
+│   ├── types/            # TypeScript interfaces (Conversation, Message, User, Model, etc.)
+│   ├── stores/           # Svelte stores for reactive state
+│   └── utils/            # Helpers (tree/, marked.ts, auth.ts, etc.)
+├── routes/               # SvelteKit file-based routing
+│   ├── conversation/[id]/  # Chat page + streaming endpoint
+│   ├── settings/         # User settings pages
+│   ├── api/              # Legacy v1 API endpoints (mcp, transcribe, fetch-url)
+│   ├── api/v2/           # REST API endpoints (+server.ts)
+│   └── r/[id]/           # Shared conversation view
+```
+
+### Text Generation Flow
+
+1. User sends message via `POST /conversation/[id]`
+2. Server validates user, fetches conversation history
+3. Builds message tree structure (see `src/lib/utils/tree/`)
+4. Calls LLM endpoint via OpenAI client
+5. Streams response back, stores in MongoDB
+
+### Model Context Protocol (MCP)
+
+MCP servers are configured via `MCP_SERVERS` env var. When enabled, tools are exposed as OpenAI function calls. The router can auto-select tools-capable models when `LLM_ROUTER_ENABLE_TOOLS=true`.
+
+### LLM Router (Omni)
+
+Smart routing via Arch-Router model. Configured with:
+
+- `LLM_ROUTER_ROUTES_PATH`: JSON file defining routes
+- `LLM_ROUTER_ARCH_BASE_URL`: Router endpoint
+- Shortcuts: multimodal routes bypass router if `LLM_ROUTER_ENABLE_MULTIMODAL=true`
+
+### Database Collections
+
+- `conversations` - Chat sessions with nested messages
+- `users` - User accounts (OIDC-backed)
+- `sessions` - Session data
+- `sharedConversations` - Public share links
+- `settings` - User preferences
+
+## Environment Setup
+
+Copy `.env` to `.env.local` and configure:
+
+```env
+OPENAI_BASE_URL=https://router.huggingface.co/v1
+OPENAI_API_KEY=hf_***
+# MONGODB_URL is optional; omit for in-memory DB persisted to ./db
+```
+
+See `.env` for full list of variables including router config, MCP servers, auth, and feature flags.
+
+## Code Conventions
+
+- TypeScript strict mode enabled
+- ESLint: no `any`, no non-null assertions
+- Prettier: tabs, 100 char width, Tailwind class sorting
+- Server vs client separation via SvelteKit conventions (`+page.server.ts` vs `+page.ts`)
+
+## Feature Development Checklist
+
+When building new features, consider:
+
+1. **HuggingChat vs self-hosted**: Wrap HuggingChat-specific features with `publicConfig.isHuggingChat`
+2. **Settings persistence**: Add new fields to `src/lib/types/Settings.ts`, update API endpoint at `src/routes/api/v2/user/settings/+server.ts`
+3. **Rich dropdowns**: Use `bits-ui` (Select, DropdownMenu) instead of native elements when you need icons/images in options
+4. **Scrollbars**: Use `scrollbar-custom` class for styled scrollbars
+5. **Icons**: Custom icons in `$lib/components/icons/`, use Carbon (`~icons/carbon/*`) or Lucide (`~icons/lucide/*`) for standard icons
+6. **Provider avatars**: Use `PROVIDERS_HUB_ORGS` from `@huggingface/inference` for HF provider avatar URLs

package/src/ruvocal/Dockerfile

@@ -1,96 +1,96 @@
-# syntax=docker/dockerfile:1
-ARG INCLUDE_DB=false
-
-FROM node:24-slim AS base
-
-# install dotenv-cli
-RUN npm install -g dotenv-cli
-
-# switch to a user that works for spaces
-RUN userdel -r node
-RUN useradd -m -u 1000 user
-USER user
-
-ENV HOME=/home/user \
-    PATH=/home/user/.local/bin:$PATH
-
-WORKDIR /app
-
-# add a .env.local if the user doesn't bind a volume to it
-RUN touch /app/.env.local
-
-USER root
-RUN apt-get update
-RUN apt-get install -y libgomp1 libcurl4 curl dnsutils nano
-
-# ensure npm cache dir exists before adjusting ownership
-RUN mkdir -p /home/user/.npm && chown -R 1000:1000 /home/user/.npm
-
-USER user
-
-
-COPY --chown=1000 .env /app/.env
-# Remove empty placeholder values that block .env.local overrides via dotenv-cli -c
-RUN sed -i 's/^MODELS=$/# MODELS=/' /app/.env && \
-    sed -i 's/^TASK_MODEL=$/# TASK_MODEL=/' /app/.env
-COPY --chown=1000 entrypoint.sh /app/entrypoint.sh
-COPY --chown=1000 package.json /app/package.json
-COPY --chown=1000 package-lock.json /app/package-lock.json
-
-RUN chmod +x /app/entrypoint.sh
-
-FROM node:24 AS builder
-
-WORKDIR /app
-
-COPY --link --chown=1000 package-lock.json package.json ./
-
-ARG APP_BASE=
-ARG PUBLIC_APP_COLOR=
-ENV BODY_SIZE_LIMIT=15728640
-
-RUN --mount=type=cache,target=/app/.npm \
-    npm set cache /app/.npm && \
-    npm ci
-
-COPY --link --chown=1000 . .
-
-RUN git config --global --add safe.directory /app && \
-    npm run build
-
-# mongo image
-FROM mongo:7 AS mongo
-
-# image to be used if INCLUDE_DB is false
-FROM base AS local_db_false
-
-# image to be used if INCLUDE_DB is true
-FROM base AS local_db_true
-
-# copy mongo from the other stage
-COPY --from=mongo /usr/bin/mongo* /usr/bin/
-
-ENV MONGODB_URL=mongodb://localhost:27017
-USER root
-RUN mkdir -p /data/db
-RUN chown -R 1000:1000 /data/db
-USER user
-# final image
-FROM local_db_${INCLUDE_DB} AS final
-
-# build arg to determine if the database should be included
-ARG INCLUDE_DB=false
-ENV INCLUDE_DB=${INCLUDE_DB}
-
-# svelte requires APP_BASE at build time so it must be passed as a build arg
-ARG APP_BASE=
-ARG PUBLIC_APP_COLOR=
-ARG PUBLIC_COMMIT_SHA=
-ENV PUBLIC_COMMIT_SHA=${PUBLIC_COMMIT_SHA}
-ENV BODY_SIZE_LIMIT=15728640
-
-#import the build & dependencies
-COPY --from=builder --chown=1000 /app/build /app/build
-COPY --from=builder --chown=1000 /app/node_modules /app/node_modules
-
-CMD ["/bin/bash", "-c", "/app/entrypoint.sh"]
+# syntax=docker/dockerfile:1
+ARG INCLUDE_DB=false
+
+FROM node:24-slim AS base
+
+# install dotenv-cli
+RUN npm install -g dotenv-cli
+
+# switch to a user that works for spaces
+RUN userdel -r node
+RUN useradd -m -u 1000 user
+USER user
+
+ENV HOME=/home/user \
+    PATH=/home/user/.local/bin:$PATH
+
+WORKDIR /app
+
+# add a .env.local if the user doesn't bind a volume to it
+RUN touch /app/.env.local
+
+USER root
+RUN apt-get update
+RUN apt-get install -y libgomp1 libcurl4 curl dnsutils nano
+
+# ensure npm cache dir exists before adjusting ownership
+RUN mkdir -p /home/user/.npm && chown -R 1000:1000 /home/user/.npm
+
+USER user
+
+
+COPY --chown=1000 .env /app/.env
+# Remove empty placeholder values that block .env.local overrides via dotenv-cli -c
+RUN sed -i 's/^MODELS=$/# MODELS=/' /app/.env && \
+    sed -i 's/^TASK_MODEL=$/# TASK_MODEL=/' /app/.env
+COPY --chown=1000 entrypoint.sh /app/entrypoint.sh
+COPY --chown=1000 package.json /app/package.json
+COPY --chown=1000 package-lock.json /app/package-lock.json
+
+RUN chmod +x /app/entrypoint.sh
+
+FROM node:24 AS builder
+
+WORKDIR /app
+
+COPY --link --chown=1000 package-lock.json package.json ./
+
+ARG APP_BASE=
+ARG PUBLIC_APP_COLOR=
+ENV BODY_SIZE_LIMIT=15728640
+
+RUN --mount=type=cache,target=/app/.npm \
+    npm set cache /app/.npm && \
+    npm ci
+
+COPY --link --chown=1000 . .
+
+RUN git config --global --add safe.directory /app && \
+    npm run build
+
+# mongo image
+FROM mongo:7 AS mongo
+
+# image to be used if INCLUDE_DB is false
+FROM base AS local_db_false
+
+# image to be used if INCLUDE_DB is true
+FROM base AS local_db_true
+
+# copy mongo from the other stage
+COPY --from=mongo /usr/bin/mongo* /usr/bin/
+
+ENV MONGODB_URL=mongodb://localhost:27017
+USER root
+RUN mkdir -p /data/db
+RUN chown -R 1000:1000 /data/db
+USER user
+# final image
+FROM local_db_${INCLUDE_DB} AS final
+
+# build arg to determine if the database should be included
+ARG INCLUDE_DB=false
+ENV INCLUDE_DB=${INCLUDE_DB}
+
+# svelte requires APP_BASE at build time so it must be passed as a build arg
+ARG APP_BASE=
+ARG PUBLIC_APP_COLOR=
+ARG PUBLIC_COMMIT_SHA=
+ENV PUBLIC_COMMIT_SHA=${PUBLIC_COMMIT_SHA}
+ENV BODY_SIZE_LIMIT=15728640
+
+#import the build & dependencies
+COPY --from=builder --chown=1000 /app/build /app/build
+COPY --from=builder --chown=1000 /app/node_modules /app/node_modules
+
+CMD ["/bin/bash", "-c", "/app/entrypoint.sh"]