ruflo 3.7.0-alpha.11 → 3.7.0-alpha.13

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

@@ -1,62 +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.
+# 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

@@ -1,19 +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")
-
+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/Dockerfile

@@ -1,45 +1,45 @@
-FROM node:20-slim
-
-WORKDIR /app
-
-COPY package.json ./
-RUN npm install --production
-
-# Pre-install MCP backends for faster startup (avoids npx download on first call)
-# Each installed separately so one failure doesn't block others
-RUN npm install -g ruvector || true
-RUN npm install -g ruflo || true
-RUN npm install -g agentic-flow@alpha || true
-RUN npm install -g gemini-mcp-server || true
-RUN npm install -g @openai/codex || true
-
-COPY index.js ./
-COPY mcp-stdio-kernel.js ./
-
-# Create writable directories for MCP backends (ruflo, ruvector, agentic-flow)
-# These tools write state/tasks/memory to the working directory at runtime
-RUN mkdir -p /app/.claude-flow/tasks /app/.claude-flow/memory /app/.claude-flow/sessions \
-    /app/.claude-flow/agents /app/.claude-flow/config /app/.claude-flow/data \
-    /app/.claude-flow/logs /app/.claude-flow/swarm \
-    && chown -R node:node /app/.claude-flow
-
-USER node
-
-EXPOSE 3001
-
-ENV PORT=3001
-# Default-on tool groups
-ENV MCP_GROUP_INTELLIGENCE=true
-ENV MCP_GROUP_AGENTS=true
-ENV MCP_GROUP_MEMORY=true
-ENV MCP_GROUP_DEVTOOLS=true
-# Opt-in tool groups
-ENV MCP_GROUP_SECURITY=false
-ENV MCP_GROUP_BROWSER=false
-ENV MCP_GROUP_NEURAL=false
-ENV MCP_GROUP_AGENTIC_FLOW=false
-ENV MCP_GROUP_CLAUDE_CODE=false
-ENV MCP_GROUP_GEMINI=false
-ENV MCP_GROUP_CODEX=false
-
-CMD ["node", "index.js"]
+FROM node:20-slim
+
+WORKDIR /app
+
+COPY package.json ./
+RUN npm install --production
+
+# Pre-install MCP backends for faster startup (avoids npx download on first call)
+# Each installed separately so one failure doesn't block others
+RUN npm install -g ruvector || true
+RUN npm install -g ruflo || true
+RUN npm install -g agentic-flow@alpha || true
+RUN npm install -g gemini-mcp-server || true
+RUN npm install -g @openai/codex || true
+
+COPY index.js ./
+COPY mcp-stdio-kernel.js ./
+
+# Create writable directories for MCP backends (ruflo, ruvector, agentic-flow)
+# These tools write state/tasks/memory to the working directory at runtime
+RUN mkdir -p /app/.claude-flow/tasks /app/.claude-flow/memory /app/.claude-flow/sessions \
+    /app/.claude-flow/agents /app/.claude-flow/config /app/.claude-flow/data \
+    /app/.claude-flow/logs /app/.claude-flow/swarm \
+    && chown -R node:node /app/.claude-flow
+
+USER node
+
+EXPOSE 3001
+
+ENV PORT=3001
+# Default-on tool groups
+ENV MCP_GROUP_INTELLIGENCE=true
+ENV MCP_GROUP_AGENTS=true
+ENV MCP_GROUP_MEMORY=true
+ENV MCP_GROUP_DEVTOOLS=true
+# Opt-in tool groups
+ENV MCP_GROUP_SECURITY=false
+ENV MCP_GROUP_BROWSER=false
+ENV MCP_GROUP_NEURAL=false
+ENV MCP_GROUP_AGENTIC_FLOW=false
+ENV MCP_GROUP_CLAUDE_CODE=false
+ENV MCP_GROUP_GEMINI=false
+ENV MCP_GROUP_CODEX=false
+
+CMD ["node", "index.js"]

package/src/ruvocal/mcp-bridge/cloudbuild.yaml

@@ -1,49 +1,49 @@
-steps:
-  # Build Docker image
-  - name: 'gcr.io/cloud-builders/docker'
-    args: [
-      'build',
-      '-t', 'gcr.io/${PROJECT_ID}/mcp-bridge:${_VERSION}',
-      '-f', 'mcp-bridge/Dockerfile',
-      'mcp-bridge'
-    ]
-
-  # Push versioned tag
-  - name: 'gcr.io/cloud-builders/docker'
-    args: ['push', 'gcr.io/${PROJECT_ID}/mcp-bridge:${_VERSION}']
-
-  # Tag and push latest
-  - name: 'gcr.io/cloud-builders/docker'
-    args: [
-      'tag',
-      'gcr.io/${PROJECT_ID}/mcp-bridge:${_VERSION}',
-      'gcr.io/${PROJECT_ID}/mcp-bridge:latest'
-    ]
-  - name: 'gcr.io/cloud-builders/docker'
-    args: ['push', 'gcr.io/${PROJECT_ID}/mcp-bridge:latest']
-
-  # Deploy to Cloud Run
-  - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
-    entrypoint: gcloud
-    args: [
-      'run', 'deploy', 'mcp-bridge',
-      '--image', 'gcr.io/${PROJECT_ID}/mcp-bridge:${_VERSION}',
-      '--platform', 'managed',
-      '--region', 'us-central1',
-      '--port', '3001',
-      '--memory', '512Mi',
-      '--cpu', '1',
-      '--min-instances', '0',
-      '--max-instances', '5',
-      '--timeout', '300',
-      '--allow-unauthenticated',
-      '--set-env-vars', 'NODE_ENV=production',
-      '--set-secrets', 'OPENAI_API_KEY=openai-api-key:latest,GOOGLE_API_KEY=google-api-key:latest,OPENROUTER_API_KEY=openrouter-api-key:latest'
-    ]
-
-substitutions:
-  _VERSION: 'v1'
-
-options:
-  logging: CLOUD_LOGGING_ONLY
-timeout: 600s
+steps:
+  # Build Docker image
+  - name: 'gcr.io/cloud-builders/docker'
+    args: [
+      'build',
+      '-t', 'gcr.io/${PROJECT_ID}/mcp-bridge:${_VERSION}',
+      '-f', 'mcp-bridge/Dockerfile',
+      'mcp-bridge'
+    ]
+
+  # Push versioned tag
+  - name: 'gcr.io/cloud-builders/docker'
+    args: ['push', 'gcr.io/${PROJECT_ID}/mcp-bridge:${_VERSION}']
+
+  # Tag and push latest
+  - name: 'gcr.io/cloud-builders/docker'
+    args: [
+      'tag',
+      'gcr.io/${PROJECT_ID}/mcp-bridge:${_VERSION}',
+      'gcr.io/${PROJECT_ID}/mcp-bridge:latest'
+    ]
+  - name: 'gcr.io/cloud-builders/docker'
+    args: ['push', 'gcr.io/${PROJECT_ID}/mcp-bridge:latest']
+
+  # Deploy to Cloud Run
+  - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
+    entrypoint: gcloud
+    args: [
+      'run', 'deploy', 'mcp-bridge',
+      '--image', 'gcr.io/${PROJECT_ID}/mcp-bridge:${_VERSION}',
+      '--platform', 'managed',
+      '--region', 'us-central1',
+      '--port', '3001',
+      '--memory', '512Mi',
+      '--cpu', '1',
+      '--min-instances', '0',
+      '--max-instances', '5',
+      '--timeout', '300',
+      '--allow-unauthenticated',
+      '--set-env-vars', 'NODE_ENV=production',
+      '--set-secrets', 'OPENAI_API_KEY=openai-api-key:latest,GOOGLE_API_KEY=google-api-key:latest,OPENROUTER_API_KEY=openrouter-api-key:latest'
+    ]
+
+substitutions:
+  _VERSION: 'v1'
+
+options:
+  logging: CLOUD_LOGGING_ONLY
+timeout: 600s