feat: initial Reachy Mini Vibe Coder space

- Hono backend (Vercel AI SDK + OpenRouter) with HF OAuth middleware
- React frontend with Monaco editor, virtual FS, sandboxed preview iframe
- Embedded build-reachy-voice-app skill loaded at runtime for the agent
- /api/publish route streams createRepo + uploadFiles to a new HF Space
- Docker runtime with envsubst injection of OAuth vars at container start

Made-with: Cursor

.dockerignore

@@ -0,0 +1,7 @@
+**/node_modules
+**/dist
+**/.env
+**/.env.local
+.git
+.gitignore
+.DS_Store

.gitignore

@@ -0,0 +1,11 @@
+node_modules/
+dist/
+.env
+.env.local
+*.log
+*.tsbuildinfo
+.DS_Store
+backend/dist/
+frontend/dist/
+.vscode/
+.idea/

Dockerfile

@@ -0,0 +1,67 @@
+# syntax=docker/dockerfile:1.7
+# ────────────────────────────────────────────────────────────────────────────
+# Stage 1 · build the React frontend
+# ────────────────────────────────────────────────────────────────────────────
+FROM node:20-slim AS frontend-builder
+
+WORKDIR /build/frontend
+
+COPY frontend/package.json frontend/package-lock.json* ./
+RUN npm ci || npm install
+
+COPY frontend/tsconfig*.json frontend/vite.config.ts frontend/index.html ./
+COPY frontend/src ./src
+
+RUN npm run build
+
+# ────────────────────────────────────────────────────────────────────────────
+# Stage 2 · build the Hono backend
+# ────────────────────────────────────────────────────────────────────────────
+FROM node:20-slim AS backend-builder
+
+WORKDIR /build/backend
+
+COPY backend/package.json backend/package-lock.json* ./
+RUN npm ci || npm install
+
+COPY backend/tsconfig.json ./
+COPY backend/src ./src
+
+RUN npm run build && npm prune --omit=dev
+
+# ────────────────────────────────────────────────────────────────────────────
+# Stage 3 · runtime (node + built assets only)
+# ────────────────────────────────────────────────────────────────────────────
+FROM node:20-slim AS runtime
+
+# `gettext-base` gives us `envsubst` for the OAuth vars entrypoint.
+RUN apt-get update \
+ && apt-get install -y --no-install-recommends gettext-base tini \
+ && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+# Backend runtime (compiled JS + production node_modules)
+COPY --from=backend-builder /build/backend/dist           /app/backend/dist
+COPY --from=backend-builder /build/backend/node_modules   /app/backend/node_modules
+COPY --from=backend-builder /build/backend/package.json   /app/backend/package.json
+
+# Skills are loaded from source markdown at runtime (skill-loader.ts reads
+# them from disk). Ship them alongside the compiled JS.
+COPY backend/src/agent/skills /app/backend/dist/agent/skills
+
+# Frontend static build - server.ts detects this folder automatically.
+COPY --from=frontend-builder /build/frontend/dist /app/frontend/dist
+
+# HF OAuth variables entrypoint
+COPY docker-entrypoint.d /app/docker-entrypoint.d
+RUN chmod +x /app/docker-entrypoint.d/*.sh
+
+ENV NODE_ENV=production \
+    PORT=7860 \
+    REQUIRE_HF_AUTH=1
+
+EXPOSE 7860
+
+ENTRYPOINT ["/usr/bin/tini", "--", "/app/docker-entrypoint.d/entrypoint.sh"]
+CMD ["node", "/app/backend/dist/server.js"]

README.md

@@ -0,0 +1,133 @@
+---
+title: Reachy Mini Vibe Coder
+emoji: 🤖
+colorFrom: indigo
+colorTo: pink
+sdk: docker
+app_port: 7860
+pinned: false
+hf_oauth: true
+hf_oauth_scopes:
+  - openid
+  - profile
+  - write-repos
+  - manage-repos
+short_description: Vibe-code Reachy Mini voice apps and publish them to HF Spaces.
+tags:
+  - reachy_mini
+  - agent
+  - vibe-coding
+---
+
+# Reachy Mini · Vibe Coder
+
+A conversational agent that helps you vibe-code browser-based voice apps for
+Reachy Mini robots, then publishes them as Hugging Face Spaces in one click.
+
+The agent is grounded in the `build-reachy-voice-app` skill, which documents
+the full architecture (WebRTC 2-hop audio bridge, OpenAI Realtime event
+lifecycle, motion agents, HF OAuth injection, Docker + Nginx deploy). Ask for
+an app, the agent produces the `index.html`, `main.ts`, `style.css`, `Dockerfile`
+and `README.md` that you need, lets you preview them live in a sandboxed
+iframe, and publishes the result to a new HF Space under your account.
+
+## Architecture
+
+```
+frontend/                    Vite + React + @ai-sdk/react
+  src/
+    components/
+      TopBar.tsx             HF user avatar, model picker, Publish button
+      ChatPanel.tsx          Agent conversation
+      CodeEditor.tsx         Monaco, one tab per virtual-FS file
+      PreviewFrame.tsx       Sandboxed iframe running the generated app
+    hooks/
+      useAgentChat.ts        useChat + client-side tool execution
+      useVirtualFS.ts        In-memory file tree
+      useHfAuth.ts           HF OAuth (hfSpacesOauthLogin)
+
+backend/                     Hono + Vercel AI SDK (ai + openrouter)
+  src/
+    server.ts                Hono app, mounts /api + serves static frontend
+    auth.ts                  Verifies HF access tokens on /api/*
+    agent/
+      chat.ts                streamText() with editor tools + skill tools
+      tools.ts               writeFile, editFile, deleteFile, readFile, readSkillDoc
+      system-prompt.ts       Base prompt + injected SKILL.md
+      skill-loader.ts        Reads skills/ at runtime
+      skills/
+        build-reachy-voice-app/
+          SKILL.md           (copied from reachy-mini-project-folder/.cursor/skills/)
+          architecture.md
+          deployment.md
+          motion-agents.md
+          protocols.md
+          webrtc-tuning.md
+    routes/
+      publish.ts             @huggingface/hub createRepo + uploadFiles
+
+docker-entrypoint.d/
+  10-inject-hf-vars.sh       envsubst OAUTH_CLIENT_ID / SPACE_* into dist/index.html
+```
+
+## Local development
+
+### Prerequisites
+
+- Node.js 20+
+- An [OpenRouter API key](https://openrouter.ai/keys) (backend)
+- A Hugging Face OAuth app for local dev (see below)
+
+### HF OAuth for localhost
+
+On a Space the OAuth client ID is injected automatically. For local dev:
+
+1. Register an OAuth app at <https://huggingface.co/settings/applications/new>
+2. Fill in:
+   - **Homepage URL**: `http://localhost:5173`
+   - **Scopes**: `openid`, `profile`, `write-repos`, `manage-repos`
+   - **Redirect URIs**: `http://localhost:5173`
+3. Copy the client ID into `frontend/.env.local`:
+   ```
+   VITE_HF_OAUTH_CLIENT_ID=xxxx-xxxx-xxxx
+   ```
+
+### Run
+
+```bash
+# Terminal 1 - backend
+cd backend
+cp .env.example .env  # fill OPENROUTER_API_KEY
+npm install
+npm run dev
+
+# Terminal 2 - frontend
+cd frontend
+npm install
+npm run dev
+```
+
+Open <http://localhost:5173>.
+
+## Deploy to HF Spaces
+
+Push this repo to a Space with `sdk: docker`. The `docker-entrypoint.d`
+script injects the OAuth credentials from the Space runtime into the built
+`index.html` at container start.
+
+```bash
+git remote add space https://huggingface.co/spaces/<your-username>/reachy-mini-vibe-coder
+git push space main
+```
+
+## Environment variables (Space secrets)
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `OPENROUTER_API_KEY` | yes | Powers the agent |
+| `OPENROUTER_MODEL`   | no  | Default `anthropic/claude-sonnet-4-5` |
+
+## License
+
+MIT. The embedded skill files are derived from the `reachy-mini-project-folder`
+internal docs; the underlying SDKs keep their own licenses.

backend/.env.example

@@ -0,0 +1,12 @@
+# OpenRouter API key used by the agent
+OPENROUTER_API_KEY=
+
+# Default model (can be overridden per-request from the frontend)
+OPENROUTER_MODEL=anthropic/claude-sonnet-4-5
+
+# Port Hono listens on (HF Spaces expects 7860)
+PORT=7860
+
+# When set, /api/* endpoints require a valid HF access token in the
+# Authorization header. Leave unset during early local dev.
+REQUIRE_HF_AUTH=1

backend/package-lock.json

@@ -0,0 +1,1032 @@
+{
+  "name": "reachy-mini-vibe-coder-backend",
+  "version": "0.1.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "reachy-mini-vibe-coder-backend",
+      "version": "0.1.0",
+      "dependencies": {
+        "@ai-sdk/react": "^2.0.104",
+        "@hono/node-server": "^1.19.6",
+        "@huggingface/hub": "^2.11.0",
+        "@openrouter/ai-sdk-provider": "^2.5.1",
+        "ai": "^6.0.158",
+        "dotenv": "^17.4.1",
+        "hono": "^4.10.5",
+        "zod": "^4.3.6"
+      },
+      "devDependencies": {
+        "@types/node": "^22.0.0",
+        "tsx": "^4.19.0",
+        "typescript": "^5.6.0"
+      }
+    },
+    "node_modules/@ai-sdk/gateway": {
+      "version": "3.0.104",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/gateway/-/gateway-3.0.104.tgz",
+      "integrity": "sha512-ZKX5n74io8VIRlhIMSLWVlvT3sXC8Z7cZ9GHuWBWZDVi96+62AIsWuLGvMfcBA1STYuSoDrp6rIziZmvrTq0TA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "3.0.8",
+        "@ai-sdk/provider-utils": "4.0.23",
+        "@vercel/oidc": "3.2.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
+    "node_modules/@ai-sdk/gateway/node_modules/@ai-sdk/provider": {
+      "version": "3.0.8",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider/-/provider-3.0.8.tgz",
+      "integrity": "sha512-oGMAgGoQdBXbZqNG0Ze56CHjDZ1IDYOwGYxYjO5KLSlz5HiNQ9udIXsPZ61VWaHGZ5XW/jyjmr6t2xz2jGVwbQ==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "json-schema": "^0.4.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@ai-sdk/gateway/node_modules/@ai-sdk/provider-utils": {
+      "version": "4.0.23",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider-utils/-/provider-utils-4.0.23.tgz",
+      "integrity": "sha512-z8GlDaCmRSDlqkMF2f4/RFgWxdarvIbyuk+m6WXT1LYgsnGiXRJGTD2Z1+SDl3LqtFuRtGX1aghYvQLoHL/9pg==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "3.0.8",
+        "@standard-schema/spec": "^1.1.0",
+        "eventsource-parser": "^3.0.6"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
+    "node_modules/@ai-sdk/provider": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider/-/provider-2.0.1.tgz",
+      "integrity": "sha512-KCUwswvsC5VsW2PWFqF8eJgSCu5Ysj7m1TxiHTVA6g7k360bk0RNQENT8KTMAYEs+8fWPD3Uu4dEmzGHc+jGng==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "json-schema": "^0.4.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@ai-sdk/provider-utils": {
+      "version": "3.0.23",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider-utils/-/provider-utils-3.0.23.tgz",
+      "integrity": "sha512-60GYsRj5wIJQRcq5YwYJq4KhwLeStceXEJiZdecP1miiH+6FMmrnc7lZDOJoQ6m9lrudEb+uI4LEwddLz5+rPQ==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "2.0.1",
+        "@standard-schema/spec": "^1.0.0",
+        "eventsource-parser": "^3.0.6"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
+    "node_modules/@ai-sdk/react": {
+      "version": "2.0.181",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/react/-/react-2.0.181.tgz",
+      "integrity": "sha512-Jay7zyuy8+RHHIZdrM1M4KLi8wAbFzyBAb37HfVSLeIE6HiU43qFN5bI+Xyi9p946AmBNZ7tokuxjXhsUS+V4w==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider-utils": "3.0.23",
+        "ai": "5.0.179",
+        "swr": "^2.2.5",
+        "throttleit": "2.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "react": "^18 || ~19.0.1 || ~19.1.2 || ^19.2.1",
+        "zod": "^3.25.76 || ^4.1.8"
+      },
+      "peerDependenciesMeta": {
+        "zod": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@ai-sdk/react/node_modules/@ai-sdk/gateway": {
+      "version": "2.0.82",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/gateway/-/gateway-2.0.82.tgz",
+      "integrity": "sha512-vtoCSEBGPcxzChI3eqe9C9AJSlc/WUZp92tzpOqVd4B6Tnu4583S+qR7TknB0tPta15TEoOIkK0ENW6D/DgRJQ==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "2.0.1",
+        "@ai-sdk/provider-utils": "3.0.23",
+        "@vercel/oidc": "3.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
+    "node_modules/@ai-sdk/react/node_modules/@vercel/oidc": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/@vercel/oidc/-/oidc-3.1.0.tgz",
+      "integrity": "sha512-Fw28YZpRnA3cAHHDlkt7xQHiJ0fcL+NRcIqsocZQUSmbzeIKRpwttJjik5ZGanXP+vlA4SbTg+AbA3bP363l+w==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">= 20"
+      }
+    },
+    "node_modules/@ai-sdk/react/node_modules/ai": {
+      "version": "5.0.179",
+      "resolved": "https://registry.npmjs.org/ai/-/ai-5.0.179.tgz",
+      "integrity": "sha512-tuq/r2FH/pBuY3jo0yHF3UglDV73WONGLhW80DuwgO6w0ftPIqRsAm5p9cE3Bu4LfEuCkMXpiUG/pQRzqKRRaA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/gateway": "2.0.82",
+        "@ai-sdk/provider": "2.0.1",
+        "@ai-sdk/provider-utils": "3.0.23",
+        "@opentelemetry/api": "1.9.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
+    "node_modules/@esbuild/aix-ppc64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.27.7.tgz",
+      "integrity": "sha512-EKX3Qwmhz1eMdEJokhALr0YiD0lhQNwDqkPYyPhiSwKrh7/4KRjQc04sZ8db+5DVVnZ1LmbNDI1uAMPEUBnQPg==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.27.7.tgz",
+      "integrity": "sha512-jbPXvB4Yj2yBV7HUfE2KHe4GJX51QplCN1pGbYjvsyCZbQmies29EoJbkEc+vYuU5o45AfQn37vZlyXy4YJ8RQ==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.27.7.tgz",
+      "integrity": "sha512-62dPZHpIXzvChfvfLJow3q5dDtiNMkwiRzPylSCfriLvZeq0a1bWChrGx/BbUbPwOrsWKMn8idSllklzBy+dgQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-x64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.27.7.tgz",
+      "integrity": "sha512-x5VpMODneVDb70PYV2VQOmIUUiBtY3D3mPBG8NxVk5CogneYhkR7MmM3yR/uMdITLrC1ml/NV1rj4bMJuy9MCg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-arm64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.27.7.tgz",
+      "integrity": "sha512-5lckdqeuBPlKUwvoCXIgI2D9/ABmPq3Rdp7IfL70393YgaASt7tbju3Ac+ePVi3KDH6N2RqePfHnXkaDtY9fkw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-x64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.27.7.tgz",
+      "integrity": "sha512-rYnXrKcXuT7Z+WL5K980jVFdvVKhCHhUwid+dDYQpH+qu+TefcomiMAJpIiC2EM3Rjtq0sO3StMV/+3w3MyyqQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.27.7.tgz",
+      "integrity": "sha512-B48PqeCsEgOtzME2GbNM2roU29AMTuOIN91dsMO30t+Ydis3z/3Ngoj5hhnsOSSwNzS+6JppqWsuhTp6E82l2w==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-x64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.27.7.tgz",
+      "integrity": "sha512-jOBDK5XEjA4m5IJK3bpAQF9/Lelu/Z9ZcdhTRLf4cajlB+8VEhFFRjWgfy3M1O4rO2GQ/b2dLwCUGpiF/eATNQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.27.7.tgz",
+      "integrity": "sha512-RkT/YXYBTSULo3+af8Ib0ykH8u2MBh57o7q/DAs3lTJlyVQkgQvlrPTnjIzzRPQyavxtPtfg0EopvDyIt0j1rA==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.27.7.tgz",
+      "integrity": "sha512-RZPHBoxXuNnPQO9rvjh5jdkRmVizktkT7TCDkDmQ0W2SwHInKCAV95GRuvdSvA7w4VMwfCjUiPwDi0ZO6Nfe9A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ia32": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.27.7.tgz",
+      "integrity": "sha512-GA48aKNkyQDbd3KtkplYWT102C5sn/EZTY4XROkxONgruHPU72l+gW+FfF8tf2cFjeHaRbWpOYa/uRBz/Xq1Pg==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-loong64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.27.7.tgz",
+      "integrity": "sha512-a4POruNM2oWsD4WKvBSEKGIiWQF8fZOAsycHOt6JBpZ+JN2n2JH9WAv56SOyu9X5IqAjqSIPTaJkqN8F7XOQ5Q==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-mips64el": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.27.7.tgz",
+      "integrity": "sha512-KabT5I6StirGfIz0FMgl1I+R1H73Gp0ofL9A3nG3i/cYFJzKHhouBV5VWK1CSgKvVaG4q1RNpCTR2LuTVB3fIw==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ppc64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.27.7.tgz",
+      "integrity": "sha512-gRsL4x6wsGHGRqhtI+ifpN/vpOFTQtnbsupUF5R5YTAg+y/lKelYR1hXbnBdzDjGbMYjVJLJTd2OFmMewAgwlQ==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-riscv64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.27.7.tgz",
+      "integrity": "sha512-hL25LbxO1QOngGzu2U5xeXtxXcW+/GvMN3ejANqXkxZ/opySAZMrc+9LY/WyjAan41unrR3YrmtTsUpwT66InQ==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-s390x": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.27.7.tgz",
+      "integrity": "sha512-2k8go8Ycu1Kb46vEelhu1vqEP+UeRVj2zY1pSuPdgvbd5ykAw82Lrro28vXUrRmzEsUV0NzCf54yARIK8r0fdw==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-x64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.27.7.tgz",
+      "integrity": "sha512-hzznmADPt+OmsYzw1EE33ccA+HPdIqiCRq7cQeL1Jlq2gb1+OyWBkMCrYGBJ+sxVzve2ZJEVeePbLM2iEIZSxA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.27.7.tgz",
+      "integrity": "sha512-b6pqtrQdigZBwZxAn1UpazEisvwaIDvdbMbmrly7cDTMFnw/+3lVxxCTGOrkPVnsYIosJJXAsILG9XcQS+Yu6w==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-x64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.27.7.tgz",
+      "integrity": "sha512-OfatkLojr6U+WN5EDYuoQhtM+1xco+/6FSzJJnuWiUw5eVcicbyK3dq5EeV/QHT1uy6GoDhGbFpprUiHUYggrw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.27.7.tgz",
+      "integrity": "sha512-AFuojMQTxAz75Fo8idVcqoQWEHIXFRbOc1TrVcFSgCZtQfSdc1RXgB3tjOn/krRHENUB4j00bfGjyl2mJrU37A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-x64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.27.7.tgz",
+      "integrity": "sha512-+A1NJmfM8WNDv5CLVQYJ5PshuRm/4cI6WMZRg1by1GwPIQPCTs1GLEUHwiiQGT5zDdyLiRM/l1G0Pv54gvtKIg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openharmony-arm64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.27.7.tgz",
+      "integrity": "sha512-+KrvYb/C8zA9CU/g0sR6w2RBw7IGc5J2BPnc3dYc5VJxHCSF1yNMxTV5LQ7GuKteQXZtspjFbiuW5/dOj7H4Yw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/sunos-x64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.27.7.tgz",
+      "integrity": "sha512-ikktIhFBzQNt/QDyOL580ti9+5mL/YZeUPKU2ivGtGjdTYoqz6jObj6nOMfhASpS4GU4Q/Clh1QtxWAvcYKamA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-arm64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.27.7.tgz",
+      "integrity": "sha512-7yRhbHvPqSpRUV7Q20VuDwbjW5kIMwTHpptuUzV+AA46kiPze5Z7qgt6CLCK3pWFrHeNfDd1VKgyP4O+ng17CA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-ia32": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.27.7.tgz",
+      "integrity": "sha512-SmwKXe6VHIyZYbBLJrhOoCJRB/Z1tckzmgTLfFYOfpMAx63BJEaL9ExI8x7v0oAO3Zh6D/Oi1gVxEYr5oUCFhw==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-x64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.27.7.tgz",
+      "integrity": "sha512-56hiAJPhwQ1R4i+21FVF7V8kSD5zZTdHcVuRFMW0hn753vVfQN8xlx4uOPT4xoGH0Z/oVATuR82AiqSTDIpaHg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@hono/node-server": {
+      "version": "1.19.14",
+      "resolved": "https://registry.npmjs.org/@hono/node-server/-/node-server-1.19.14.tgz",
+      "integrity": "sha512-GwtvgtXxnWsucXvbQXkRgqksiH2Qed37H9xHZocE5sA3N8O8O8/8FA3uclQXxXVzc9XBZuEOMK7+r02FmSpHtw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18.14.1"
+      },
+      "peerDependencies": {
+        "hono": "^4"
+      }
+    },
+    "node_modules/@huggingface/hub": {
+      "version": "2.11.0",
+      "resolved": "https://registry.npmjs.org/@huggingface/hub/-/hub-2.11.0.tgz",
+      "integrity": "sha512-WS6QGaXYeBVFlaB4SOn6z4LGUpLB5kRZNL08uUni4izX353KxiwwZMK5+/AWX86MJh8SMZNa/JFcvFCcQsbszQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@huggingface/tasks": "^0.19.90"
+      },
+      "bin": {
+        "hfjs": "dist/cli.js"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "cli-progress": "^3.12.0"
+      }
+    },
+    "node_modules/@huggingface/tasks": {
+      "version": "0.19.90",
+      "resolved": "https://registry.npmjs.org/@huggingface/tasks/-/tasks-0.19.90.tgz",
+      "integrity": "sha512-nfV9luJbvwGQ/5oKXkKhCV9h4X7mwh1YaGG3ORd6UMLDSwr1OFSSatcBX0O9OtBtmNK19aGSjbLFqqgcIR6+IA==",
+      "license": "MIT"
+    },
+    "node_modules/@openrouter/ai-sdk-provider": {
+      "version": "2.8.0",
+      "resolved": "https://registry.npmjs.org/@openrouter/ai-sdk-provider/-/ai-sdk-provider-2.8.0.tgz",
+      "integrity": "sha512-oDDW/0KMqz4suHVloB9sNv0YyKLGNYf1FTevXH6adDkid5dsmbbcYuiEsbIhpZSZtHa6o5AVjK1jEAfePOLxww==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "ai": "^6.0.0",
+        "zod": "^3.25.0 || ^4.0.0"
+      }
+    },
+    "node_modules/@opentelemetry/api": {
+      "version": "1.9.0",
+      "resolved": "https://registry.npmjs.org/@opentelemetry/api/-/api-1.9.0.tgz",
+      "integrity": "sha512-3giAOQvZiH5F9bMlMiv8+GSPMeqg0dbaeo58/0SlA9sxSqZhnUtxzX9/2FzyhS9sWQf5S0GJE0AKBrFqjpeYcg==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
+    "node_modules/@standard-schema/spec": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@standard-schema/spec/-/spec-1.1.0.tgz",
+      "integrity": "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==",
+      "license": "MIT"
+    },
+    "node_modules/@types/node": {
+      "version": "22.19.17",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.19.17.tgz",
+      "integrity": "sha512-wGdMcf+vPYM6jikpS/qhg6WiqSV/OhG+jeeHT/KlVqxYfD40iYJf9/AE1uQxVWFvU7MipKRkRv8NSHiCGgPr8Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": "~6.21.0"
+      }
+    },
+    "node_modules/@vercel/oidc": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/@vercel/oidc/-/oidc-3.2.0.tgz",
+      "integrity": "sha512-UycprH3T6n3jH0k44NHMa7pnFHGu/N05MjojYr+Mc6I7obkoLIJujSWwin1pCvdy/eOxrI/l3uDLQsmcrOb4ug==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">= 20"
+      }
+    },
+    "node_modules/ai": {
+      "version": "6.0.168",
+      "resolved": "https://registry.npmjs.org/ai/-/ai-6.0.168.tgz",
+      "integrity": "sha512-2HqCJuO+1V2aV7vfYs5LFEUfxbkGX+5oa54q/gCCTL7KLTdbxcCu5D7TdLA5kwsrs3Szgjah9q6D9tpjHM3hUQ==",
+      "license": "Apache-2.0",
+      "peer": true,
+      "dependencies": {
+        "@ai-sdk/gateway": "3.0.104",
+        "@ai-sdk/provider": "3.0.8",
+        "@ai-sdk/provider-utils": "4.0.23",
+        "@opentelemetry/api": "1.9.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
+    "node_modules/ai/node_modules/@ai-sdk/provider": {
+      "version": "3.0.8",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider/-/provider-3.0.8.tgz",
+      "integrity": "sha512-oGMAgGoQdBXbZqNG0Ze56CHjDZ1IDYOwGYxYjO5KLSlz5HiNQ9udIXsPZ61VWaHGZ5XW/jyjmr6t2xz2jGVwbQ==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "json-schema": "^0.4.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/ai/node_modules/@ai-sdk/provider-utils": {
+      "version": "4.0.23",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider-utils/-/provider-utils-4.0.23.tgz",
+      "integrity": "sha512-z8GlDaCmRSDlqkMF2f4/RFgWxdarvIbyuk+m6WXT1LYgsnGiXRJGTD2Z1+SDl3LqtFuRtGX1aghYvQLoHL/9pg==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "3.0.8",
+        "@standard-schema/spec": "^1.1.0",
+        "eventsource-parser": "^3.0.6"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
+    "node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/cli-progress": {
+      "version": "3.12.0",
+      "resolved": "https://registry.npmjs.org/cli-progress/-/cli-progress-3.12.0.tgz",
+      "integrity": "sha512-tRkV3HJ1ASwm19THiiLIXLO7Im7wlTuKnvkYaTkyoAPefqjNg7W7DHKUlGRxy9vxDvbyCYQkQozvptuMkGCg8A==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "string-width": "^4.2.3"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/dequal": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/dequal/-/dequal-2.0.3.tgz",
+      "integrity": "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/dotenv": {
+      "version": "17.4.2",
+      "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-17.4.2.tgz",
+      "integrity": "sha512-nI4U3TottKAcAD9LLud4Cb7b2QztQMUEfHbvhTH09bqXTxnSie8WnjPALV/WMCrJZ6UV/qHJ6L03OqO3LcdYZw==",
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://dotenvx.com"
+      }
+    },
+    "node_modules/emoji-regex": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/esbuild": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.7.tgz",
+      "integrity": "sha512-IxpibTjyVnmrIQo5aqNpCgoACA/dTKLTlhMHihVHhdkxKyPO1uBBthumT0rdHmcsk9uMonIWS0m4FljWzILh3w==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.27.7",
+        "@esbuild/android-arm": "0.27.7",
+        "@esbuild/android-arm64": "0.27.7",
+        "@esbuild/android-x64": "0.27.7",
+        "@esbuild/darwin-arm64": "0.27.7",
+        "@esbuild/darwin-x64": "0.27.7",
+        "@esbuild/freebsd-arm64": "0.27.7",
+        "@esbuild/freebsd-x64": "0.27.7",
+        "@esbuild/linux-arm": "0.27.7",
+        "@esbuild/linux-arm64": "0.27.7",
+        "@esbuild/linux-ia32": "0.27.7",
+        "@esbuild/linux-loong64": "0.27.7",
+        "@esbuild/linux-mips64el": "0.27.7",
+        "@esbuild/linux-ppc64": "0.27.7",
+        "@esbuild/linux-riscv64": "0.27.7",
+        "@esbuild/linux-s390x": "0.27.7",
+        "@esbuild/linux-x64": "0.27.7",
+        "@esbuild/netbsd-arm64": "0.27.7",
+        "@esbuild/netbsd-x64": "0.27.7",
+        "@esbuild/openbsd-arm64": "0.27.7",
+        "@esbuild/openbsd-x64": "0.27.7",
+        "@esbuild/openharmony-arm64": "0.27.7",
+        "@esbuild/sunos-x64": "0.27.7",
+        "@esbuild/win32-arm64": "0.27.7",
+        "@esbuild/win32-ia32": "0.27.7",
+        "@esbuild/win32-x64": "0.27.7"
+      }
+    },
+    "node_modules/eventsource-parser": {
+      "version": "3.0.8",
+      "resolved": "https://registry.npmjs.org/eventsource-parser/-/eventsource-parser-3.0.8.tgz",
+      "integrity": "sha512-70QWGkr4snxr0OXLRWsFLeRBIRPuQOvt4s8QYjmUlmlkyTZkRqS7EDVRZtzU3TiyDbXSzaOeF0XUKy8PchzukQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
+    "node_modules/get-tsconfig": {
+      "version": "4.14.0",
+      "resolved": "https://registry.npmjs.org/get-tsconfig/-/get-tsconfig-4.14.0.tgz",
+      "integrity": "sha512-yTb+8DXzDREzgvYmh6s9vHsSVCHeC0G3PI5bEXNBHtmshPnO+S5O7qgLEOn0I5QvMy6kpZN8K1NKGyilLb93wA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "resolve-pkg-maps": "^1.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/privatenumber/get-tsconfig?sponsor=1"
+      }
+    },
+    "node_modules/hono": {
+      "version": "4.12.14",
+      "resolved": "https://registry.npmjs.org/hono/-/hono-4.12.14.tgz",
+      "integrity": "sha512-am5zfg3yu6sqn5yjKBNqhnTX7Cv+m00ox+7jbaKkrLMRJ4rAdldd1xPd/JzbBWspqaQv6RSTrgFN95EsfhC+7w==",
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=16.9.0"
+      }
+    },
+    "node_modules/is-fullwidth-code-point": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
+      "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/json-schema": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/json-schema/-/json-schema-0.4.0.tgz",
+      "integrity": "sha512-es94M3nTIfsEPisRafak+HDLfHXnKBhV3vU5eqPcS3flIWqcxJWgXHXiey3YrpaNsanY5ei1VoYEbOzijuq9BA==",
+      "license": "(AFL-2.1 OR BSD-3-Clause)"
+    },
+    "node_modules/react": {
+      "version": "19.2.5",
+      "resolved": "https://registry.npmjs.org/react/-/react-19.2.5.tgz",
+      "integrity": "sha512-llUJLzz1zTUBrskt2pwZgLq59AemifIftw4aB7JxOqf1HY2FDaGDxgwpAPVzHU1kdWabH7FauP4i1oEeer2WCA==",
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/resolve-pkg-maps": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/resolve-pkg-maps/-/resolve-pkg-maps-1.0.0.tgz",
+      "integrity": "sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/privatenumber/resolve-pkg-maps?sponsor=1"
+      }
+    },
+    "node_modules/string-width": {
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "emoji-regex": "^8.0.0",
+        "is-fullwidth-code-point": "^3.0.0",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-ansi": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/swr": {
+      "version": "2.4.1",
+      "resolved": "https://registry.npmjs.org/swr/-/swr-2.4.1.tgz",
+      "integrity": "sha512-2CC6CiKQtEwaEeNiqWTAw9PGykW8SR5zZX8MZk6TeAvEAnVS7Visz8WzphqgtQ8v2xz/4Q5K+j+SeMaKXeeQIA==",
+      "license": "MIT",
+      "dependencies": {
+        "dequal": "^2.0.3",
+        "use-sync-external-store": "^1.6.0"
+      },
+      "peerDependencies": {
+        "react": "^16.11.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+      }
+    },
+    "node_modules/throttleit": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/throttleit/-/throttleit-2.1.0.tgz",
+      "integrity": "sha512-nt6AMGKW1p/70DF/hGBdJB57B8Tspmbp5gfJ8ilhLnt7kkr2ye7hzD6NVG8GGErk2HWF34igrL2CXmNIkzKqKw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/tsx": {
+      "version": "4.21.0",
+      "resolved": "https://registry.npmjs.org/tsx/-/tsx-4.21.0.tgz",
+      "integrity": "sha512-5C1sg4USs1lfG0GFb2RLXsdpXqBSEhAaA/0kPL01wxzpMqLILNxIxIOKiILz+cdg/pLnOUxFYOR5yhHU666wbw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "esbuild": "~0.27.0",
+        "get-tsconfig": "^4.7.5"
+      },
+      "bin": {
+        "tsx": "dist/cli.mjs"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      }
+    },
+    "node_modules/typescript": {
+      "version": "5.9.3",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
+      "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "bin": {
+        "tsc": "bin/tsc",
+        "tsserver": "bin/tsserver"
+      },
+      "engines": {
+        "node": ">=14.17"
+      }
+    },
+    "node_modules/undici-types": {
+      "version": "6.21.0",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
+      "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/use-sync-external-store": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/use-sync-external-store/-/use-sync-external-store-1.6.0.tgz",
+      "integrity": "sha512-Pp6GSwGP/NrPIrxVFAIkOQeyw8lFenOHijQWkUTrDvrF4ALqylP2C/KCkeS9dpUM3KvYRQhna5vt7IL95+ZQ9w==",
+      "license": "MIT",
+      "peerDependencies": {
+        "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+      }
+    },
+    "node_modules/zod": {
+      "version": "4.3.6",
+      "resolved": "https://registry.npmjs.org/zod/-/zod-4.3.6.tgz",
+      "integrity": "sha512-rftlrkhHZOcjDwkGlnUtZZkvaPHCsDATp4pGpuOOMDaTdDDXF91wuVDJoWoPsKX/3YPQ5fHuF3STjcYyKr+Qhg==",
+      "license": "MIT",
+      "peer": true,
+      "funding": {
+        "url": "https://github.com/sponsors/colinhacks"
+      }
+    }
+  }
+}

backend/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "reachy-mini-vibe-coder-backend",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch src/server.ts",
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.19.6",
+    "@huggingface/hub": "^2.11.0",
+    "@openrouter/ai-sdk-provider": "^2.5.1",
+    "ai": "^6.0.158",
+    "dotenv": "^17.4.1",
+    "hono": "^4.10.5",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  }
+}

backend/src/agent/skill-loader.ts

@@ -0,0 +1,91 @@
+import { readFileSync, readdirSync, existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+/**
+ * Skills are markdown files grouped per topic under `agent/skills/<id>/`.
+ * Each folder must contain a `SKILL.md` (the hub) and optionally other
+ * `.md` support files (referenced by relative links from SKILL.md).
+ *
+ * Loaded at runtime: tweak the .md files and restart the server, no rebuild.
+ */
+
+const SKILLS_DIR = path.resolve(__dirname, "./skills");
+
+export interface SkillDoc {
+  filename: string;
+  title: string;
+  content: string;
+}
+
+export interface Skill {
+  id: string;
+  hub: SkillDoc;
+  docs: SkillDoc[];
+}
+
+function extractTitle(markdown: string, fallback: string): string {
+  const match = markdown.match(/^#\s+(.+)$/m);
+  return match ? match[1].trim() : fallback;
+}
+
+export function loadSkill(id: string): Skill | null {
+  const dir = path.join(SKILLS_DIR, id);
+  if (!existsSync(dir)) return null;
+
+  const files = readdirSync(dir).filter((f) => f.endsWith(".md"));
+  if (files.length === 0) return null;
+
+  const hubFile = files.find((f) => f.toLowerCase() === "skill.md");
+  if (!hubFile) return null;
+
+  const toDoc = (filename: string): SkillDoc => {
+    const content = readFileSync(path.join(dir, filename), "utf-8");
+    return {
+      filename,
+      title: extractTitle(content, filename.replace(/\.md$/, "")),
+      content,
+    };
+  };
+
+  return {
+    id,
+    hub: toDoc(hubFile),
+    docs: files.filter((f) => f !== hubFile).map(toDoc),
+  };
+}
+
+export const PRIMARY_SKILL_ID = "build-reachy-voice-app";
+
+let cached: Skill | null | undefined;
+export function getPrimarySkill(): Skill | null {
+  if (cached === undefined) {
+    cached = loadSkill(PRIMARY_SKILL_ID);
+    if (cached) {
+      const docNames = cached.docs.map((d) => d.filename).join(", ");
+      console.log(
+        `[skill-loader] Loaded skill "${cached.id}" (hub: ${cached.hub.filename}, docs: ${docNames || "none"})`,
+      );
+    } else {
+      console.warn(
+        `[skill-loader] Skill "${PRIMARY_SKILL_ID}" not found under ${SKILLS_DIR}`,
+      );
+    }
+  }
+  return cached;
+}
+
+export function listSkillDocs(skill: Skill): string[] {
+  return skill.docs.map((d) => d.filename.replace(/\.md$/, ""));
+}
+
+export function getSkillDoc(skill: Skill, topic: string): SkillDoc | null {
+  const normalized = topic.toLowerCase().replace(/\.md$/, "");
+  return (
+    skill.docs.find(
+      (d) => d.filename.toLowerCase().replace(/\.md$/, "") === normalized,
+    ) ?? null
+  );
+}

backend/src/agent/skills/build-reachy-voice-app/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: build-reachy-voice-app
+description: Build a browser-based voice conversation app that connects a Reachy Mini robot to a real-time speech model (OpenAI Realtime API) via WebRTC. Use when the user wants to create, clone, port, or extend a web app that relays audio between Reachy Mini and a voice LLM, manages motion agents (head wobble, antenna oscillation, dances), exposes tool calls from the model, and deploys to Hugging Face Spaces.
+---
+
+# Build a Reachy Mini voice conversation web app
+
+Reference implementation: [`reachy_mini_minimal_conversation/`](../../../reachy_mini_minimal_conversation/).
+Python reference (runs on the robot, use as source of truth for behavior): [`reachy_mini_conversation_app/`](../../../reachy_mini_conversation_app/).
+
+## Architecture: the browser is an audio hub
+
+The browser holds **two independent `RTCPeerConnection`s** and bridges their audio tracks:
+
+```
+  Robot mic ──WebRTC──▶ Browser ──WebRTC──▶ OpenAI Realtime
+                                                   │
+  Robot speaker ◀──WebRTC── Browser ◀──WebRTC──────┘
+                                                   │
+                               data channel  ◀─────┘
+                               (tool calls)
+```
+
+- **PC1 (Robot)**: ReachyMini JS SDK, signaling through a HF-hosted server + HF OAuth. Exposes audio tracks + a data channel for JSON commands (`set_full_target`, `play_sound`, ...).
+- **PC2 (OpenAI)**: Direct WebRTC to `api.openai.com/v1/realtime`. One POST with SDP, no renegotiation, data channel for events/tools/transcripts.
+- **Audio relay**: the robot mic track becomes the OpenAI sender input; the OpenAI output track is pushed back to the robot speaker sender via `replaceTrack()` (the robot sender already exists, you do not add a new one).
+
+This is fundamentally different from the Python app (which runs ON the robot and talks to the daemon via local Python APIs). Most Python features must be **reimplemented client-side**, not "proxied".
+
+## Stack
+
+- Vite + TypeScript, vanilla DOM (no framework).
+- ReachyMini JS SDK loaded from `jsdelivr` as an ES module in `index.html`, exposed as `window.ReachyMini`. Not an npm dep.
+- Deploy target: **Hugging Face Spaces with Docker SDK** (not Static). Nginx serves `dist/` and proxies `/openai/*` -> `api.openai.com` to bypass CORS.
+
+## Critical gotchas (read first, save hours)
+
+1. **OpenAI has no CORS**. Direct `fetch('https://api.openai.com/v1/realtime', ...)` from a browser always fails. Use a same-origin proxy: Vite dev server proxy + Nginx `/openai/` location in prod. See [deployment.md](deployment.md).
+2. **HF OAuth behaves differently local vs Space**:
+   - Local: the user must create an OAuth app manually and paste the `clientId` in your Settings UI. `localhost` requires an explicit clientId.
+   - On a Space with `hf_oauth: true` in `README.md` frontmatter: the clientId is available as env vars **server-side only** (`OAUTH_CLIENT_ID`, `SPACE_HOST`, ...). The JS runtime does NOT receive them through `window.huggingface.variables` unless you inject them. Solution: a `docker-entrypoint.d` script that `envsubst`-s placeholders like `__OAUTH_CLIENT_ID__` into `index.html` at container start. See [deployment.md](deployment.md).
+3. **Robot mic track is not exposed by the SDK**. You must reach into `robot._pc.getReceivers()` and pick the audio receiver's track. Capture it right after `startSession()`.
+4. **Robot speaker = `replaceTrack()` on an existing sender**, not `addTrack()`. Grab the audio sender from `robot._pc.getSenders()` and swap its track when OpenAI's `ontrack` fires.
+5. **The daemon cannot play dances by name over WebRTC**. `PlayMoveTaskRequest not yet implemented over WS`. Dances must be evaluated client-side and streamed as `set_full_target` frames. See [protocols.md](protocols.md) and [motion-agents.md](motion-agents.md).
+6. **`set_full_target` uses flat arrays**, not nested: `head` is 16 floats row-major (4x4 homogeneous), `antennas` is `[right, left]` in radians, `body_yaw` is a scalar radian.
+7. **Three motion sources fight each other** (wobbler, antennas, tool-driven poses/dances). Serialize them with explicit guards or dances will jitter.
+8. **WebRTC over WiFi cuts voice** unless you tune Opus FEC, bitrate, and the jitter buffer. See [webrtc-tuning.md](webrtc-tuning.md).
+
+## Minimal build order
+
+Follow this order. Each step is independently testable.
+
+1. **Scaffold**: Vite + TS, `index.html` loading ReachyMini SDK from CDN, a single full-screen button.
+2. **Robot only**: login (HF OAuth), list robots, start session, play a canned head pose via `setHeadPose` to confirm commands work.
+3. **OpenAI only**: input key in UI (stored in `localStorage`), create PC, `addTransceiver('audio', { direction: 'sendrecv' })`, attach `getUserMedia` mic, POST SDP via your proxy, hear the model reply through default speakers.
+4. **Bridge**: replace `getUserMedia` with the robot mic track, and route OpenAI `ontrack` to the robot speaker sender.
+5. **UI state machine**: `signed-out | connected | ready | listening | user-speaking | processing | ai-speaking | error`. Drive CSS animations from states + an `--audio-level` var fed by an `AnalyserNode`.
+6. **Motion agents** (head wobbler, antennas) reading RMS from the OpenAI output track. See [motion-agents.md](motion-agents.md).
+7. **Tools**: declare `move_head` and `play_dance` in `session.update`, handle `response.function_call_arguments.done`, reply with `conversation.item.create` (function_call_output) + `response.create`.
+8. **Reliability** knobs: SDP munging, `playoutDelayHint`, `sender.setParameters`, ICE grace period, silent reconnect, transport pill. See [webrtc-tuning.md](webrtc-tuning.md).
+9. **Deploy**: Docker + Nginx + OAuth envsubst. See [deployment.md](deployment.md).
+
+## OpenAI Realtime event lifecycle
+
+The state machine is driven by events on the OpenAI data channel, not by audio analysis:
+
+| OpenAI event | UI state | Motion agents |
+|---|---|---|
+| `session.created` | `connected` -> `ready` after `session.update` ack | idle |
+| `input_audio_buffer.speech_started` | `user-speaking` | freeze antennas, stop wobbler |
+| `input_audio_buffer.speech_stopped` | `processing` | still frozen |
+| `response.audio.delta` (first one) | `ai-speaking` | enable wobbler, antennas resume |
+| `response.done` | `listening` | back to idle |
+| `response.function_call_arguments.done` | (transient, stay in current) | run tool, reply |
+
+Register tools **once** on `session.created` via `session.update`. Do not send `session.update` on every turn, it resets transcription.
+
+## Reference files
+
+- [architecture.md](architecture.md): detailed 2-hop topology, audio track plumbing code, state machine diagram.
+- [protocols.md](protocols.md): daemon WebRTC data channel commands (what works, what doesn't), OpenAI Realtime events we care about, tool-call envelope format.
+- [motion-agents.md](motion-agents.md): head wobbler math, antenna oscillation, why dances are procedural and how to port them from the Python lib.
+- [webrtc-tuning.md](webrtc-tuning.md): SDP munging for Opus, bitrate caps, jitter buffer hint, ICE handling, auto-reconnect, transport path detection.
+- [deployment.md](deployment.md): Dockerfile + Nginx config, OAuth env injection, HF Space YAML frontmatter, dev proxy.
+
+## Things you should NOT do
+
+- Do **not** proxy the Python conversation app logic: it runs on the robot, uses a Python SDK with direct ZMQ/ws access to the daemon, and has features (dance library, `play_move`) that are simply not exposed over the public WebRTC data channel.
+- Do **not** rebuild the ReachyMini JS SDK; it handles HF auth, signaling and WebRTC negotiation. Import it from jsdelivr; its internals (`_pc`, `sendRaw`) are stable enough to use for low-level access.
+- Do **not** fetch dance JSONs from random HF datasets; the real dances are procedural Python functions. If you want a quick win, pre-bake the evaluation offline, but prefer porting the `rhythmic_motion.py` primitives to TS.
+- Do **not** use `addTrack` on the robot PC to play TTS audio; the sender already exists, `replaceTrack` is the only path that works.
+- Do **not** rely on `window.huggingface.variables` for OAuth on Spaces; it is not populated automatically.

backend/src/agent/skills/build-reachy-voice-app/architecture.md

@@ -0,0 +1,108 @@
+# Architecture details
+
+## Two independent peer connections
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│                          Browser                             │
+│                                                              │
+│   ┌─────────────┐                         ┌──────────────┐   │
+│   │   PC1       │                         │    PC2       │   │
+│   │  (Robot)    │                         │  (OpenAI)    │   │
+│   │             │                         │              │   │
+│   │  mic track ─┼─────────────────────────┼─► sender     │   │
+│   │             │     (audio relay)       │              │   │
+│   │  spk sender ◄─────────────────────────┼── recv track │   │
+│   │             │                         │              │   │
+│   │  datachan   │                         │   datachan   │   │
+│   │   (JSON)    │                         │  (events +   │   │
+│   │             │                         │   tools)     │   │
+│   └──────┬──────┘                         └──────┬───────┘   │
+│          │                                       │           │
+└──────────┼───────────────────────────────────────┼───────────┘
+           │ WebRTC                         WebRTC │
+           ▼                                       ▼
+      Reachy daemon                       OpenAI Realtime
+      (ws signaling                       (single POST
+       via HF server)                      SDP handshake)
+```
+
+Both PCs are completely independent. Failure of one must not tear down the other. The audio relay is the only thing that links them.
+
+## Audio plumbing
+
+### Robot mic -> OpenAI
+
+After `robot.startSession()`:
+
+```ts
+const robotPc: RTCPeerConnection = robot._pc;
+const micReceiver = robotPc.getReceivers().find(r => r.track?.kind === "audio");
+const robotMicTrack = micReceiver!.track;
+```
+
+Pass this track to the OpenAI client and `addTrack(robotMicTrack, new MediaStream([robotMicTrack]))` on the OpenAI PC before `createOffer()`. Also add a `RTCRtpTransceiver('audio', { direction: 'sendrecv' })` so the model can send audio back.
+
+### OpenAI TTS -> Robot speaker
+
+On OpenAI `pc.ontrack`:
+
+```ts
+const spkSender = robotPc.getSenders().find(s => s.track?.kind === "audio");
+await spkSender!.replaceTrack(event.track);
+```
+
+Do not `addTrack`, the robot already has an audio sender wired to the robot's speaker. Replacing its track is what actually routes audio to the robot.
+
+Also attach a silent `<audio autoplay>` element to the OpenAI track so the browser keeps the receiver "alive" (some browsers stop decoding when no sink is attached).
+
+## UI state machine
+
+Drive the central animated circle from a single `state` variable:
+
+```
+signed-out ─login─▶ authenticated ─pickRobot─▶ connected ─start─▶ ready
+                                                                    │
+                                                           (barge-in)
+                                                                    ▼
+                    listening ◀──response.done── ai-speaking ◀─ processing
+                        │                             ▲              ▲
+                        ▼                             │              │
+                  user-speaking ──speech_stopped──────┴──────────────┘
+```
+
+Use `data-state="..."` on the root and express all animations in CSS. Never mutate inline styles for state changes; only for the per-frame `--audio-level` var.
+
+## Audio level for UI
+
+One `AnalyserNode` per source of interest (robot mic for user speaking glow, OpenAI output for AI speaking glow and motion agents). Compute RMS in a `requestAnimationFrame` loop, smooth with a leaky integrator, write to a CSS var:
+
+```ts
+const smoothed = alpha * previous + (1 - alpha) * rms;
+document.documentElement.style.setProperty("--audio-level", smoothed.toFixed(3));
+```
+
+## Motion agent coordination
+
+Three animation sources can drive the head / antennas simultaneously:
+
+1. **Head wobbler**: low-amplitude continuous sway while `ai-speaking`.
+2. **Antennas oscillator**: slow breathing while idle, freeze on user speech, medium amplitude during AI speech.
+3. **Tool-driven**: `move_head` (static pose for N seconds) or `play_dance` (procedural stream at 100 Hz).
+
+Resolution rules:
+- When a tool fires, set a `toolLock` boolean. Wobbler and antennas become no-ops while true.
+- Dances take exclusive control at 100 Hz via `set_full_target`. On dance end, restore idle pose before releasing the lock.
+- Never interleave `setHeadPose` calls from different agents in the same tick. The daemon's last-write-wins semantics will cause visible jitter.
+
+## Error and reconnect boundaries
+
+Distinguish three classes of errors:
+
+| Source | Retry? | UX |
+|---|---|---|
+| Robot PC fails | No (fatal) | show error, require full restart |
+| OpenAI PC fails | Yes, 1 silent retry | stay in current state, log warn, escalate to fatal on 2nd failure |
+| Daemon command fails (JSON error on data chan) | No (log) | continue, it's a transient robot issue |
+
+Reset the retry counter on `connected`. Reset all timers and locks in the teardown path.

backend/src/agent/skills/build-reachy-voice-app/deployment.md

@@ -0,0 +1,196 @@
+# Deployment on Hugging Face Spaces
+
+## Why Docker, not Static
+
+You need:
+1. A same-origin proxy for `api.openai.com` (CORS).
+2. Runtime env-var injection for the HF OAuth clientId.
+
+Both require a real server. Use Spaces **Docker SDK** with Nginx; `Static` SDK cannot proxy and has no entrypoint hook.
+
+## `README.md` frontmatter
+
+```yaml
+---
+title: Reachy Voice Demo
+emoji: 🤖
+colorFrom: indigo
+colorTo: pink
+sdk: docker
+app_port: 8080
+hf_oauth: true
+hf_oauth_scopes:
+  - read-repos
+pinned: false
+---
+```
+
+Key bits:
+- `sdk: docker`, NOT `static`.
+- `app_port: 8080` (match your Nginx `listen`).
+- `hf_oauth: true` makes `OAUTH_CLIENT_ID`, `SPACE_HOST` and friends available as env vars inside the container.
+
+## Dockerfile
+
+```dockerfile
+FROM node:20-alpine AS build
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npm run build
+
+FROM nginx:1.27-alpine
+RUN apk add --no-cache bash gettext
+COPY nginx.conf /etc/nginx/nginx.conf
+COPY --from=build /app/dist /usr/share/nginx/html
+COPY docker-entrypoint.d/ /docker-entrypoint.d/
+RUN chmod +x /docker-entrypoint.d/*.sh
+EXPOSE 8080
+```
+
+The base `nginx` image already runs `/docker-entrypoint.d/*.sh` before starting Nginx.
+
+## Nginx config
+
+```nginx
+worker_processes  1;
+events { worker_connections 1024; }
+
+http {
+  include       /etc/nginx/mime.types;
+  default_type  application/octet-stream;
+  sendfile      on;
+  keepalive_timeout 65;
+
+  # Hide version
+  server_tokens off;
+
+  server {
+    listen 8080 default_server;
+
+    root /usr/share/nginx/html;
+    index index.html;
+
+    # SPA fallback
+    location / {
+      try_files $uri $uri/ /index.html;
+    }
+
+    # Same-origin proxy to OpenAI (bypasses CORS)
+    location /openai/ {
+      proxy_pass https://api.openai.com/;
+      proxy_set_header Host api.openai.com;
+      proxy_ssl_server_name on;
+      proxy_ssl_name api.openai.com;
+      proxy_http_version 1.1;
+      proxy_set_header Connection "";
+      proxy_read_timeout 600s;
+      proxy_send_timeout 600s;
+
+      # Preserve client Authorization header
+      proxy_pass_request_headers on;
+    }
+  }
+}
+```
+
+Common pitfalls:
+- **421 Misdirected Request**: you forgot `proxy_set_header Host` or `proxy_ssl_name`. OpenAI refuses requests whose SNI/host doesn't match.
+- **500 from Nginx**: missing `resolver` when upstream is HTTPS. Fix: either add `resolver 8.8.8.8 valid=30s;` or ensure `proxy_pass https://api.openai.com/` (without variable) is resolved at boot.
+- **401 pass-through**: good, your proxy works; the key is wrong.
+
+## OAuth env injection
+
+HF sets env vars server-side but your bundle is static JS. Inject them at container start with `envsubst`.
+
+### `index.html` placeholders
+
+```html
+<meta name="oauth-client-id" content="__OAUTH_CLIENT_ID__" />
+<meta name="oauth-scopes"    content="__OAUTH_SCOPES__" />
+<meta name="space-host"      content="__SPACE_HOST__" />
+```
+
+Read them in JS:
+
+```ts
+function meta(name: string, fallback = "") {
+  const el = document.querySelector(`meta[name="${name}"]`) as HTMLMetaElement | null;
+  const v = el?.content ?? "";
+  // the placeholder survives in dev where envsubst hasn't run
+  return v.startsWith("__") && v.endsWith("__") ? fallback : v;
+}
+```
+
+### `docker-entrypoint.d/10-envsubst.sh`
+
+```bash
+#!/bin/bash
+set -euo pipefail
+
+TARGET=/usr/share/nginx/html/index.html
+
+: "${OAUTH_CLIENT_ID:=}"
+: "${OAUTH_SCOPES:=read-repos}"
+: "${SPACE_HOST:=}"
+
+export OAUTH_CLIENT_ID OAUTH_SCOPES SPACE_HOST
+
+envsubst '${OAUTH_CLIENT_ID} ${OAUTH_SCOPES} ${SPACE_HOST}' \
+  < "$TARGET" > "${TARGET}.tmp" && mv "${TARGET}.tmp" "$TARGET"
+```
+
+Pass the variable list to `envsubst` explicitly; without it, Nginx config `$uri` would also be substituted.
+
+## Dev mode (Vite)
+
+Skip Nginx. Use Vite's proxy in `vite.config.ts`:
+
+```ts
+export default defineConfig({
+  server: {
+    proxy: {
+      "/openai": {
+        target: "https://api.openai.com",
+        changeOrigin: true,
+        rewrite: (p) => p.replace(/^\/openai/, ""),
+        secure: true,
+      },
+    },
+  },
+});
+```
+
+Local OAuth does NOT work out of the box because HF requires a registered redirect URI. Either:
+- register `http://localhost:5173` as a redirect in your own HF OAuth app and paste the clientId in a Settings UI (store in `localStorage`);
+- or skip OAuth locally and hardcode a robot URL for dev.
+
+## Build + push
+
+The repo should have two remotes (see `git-remotes-safety.mdc` in this workspace):
+- `github` (public upstream): never force-push.
+- `space` (HF Space): force-push on your own namespace is fine.
+
+```bash
+npm run build          # sanity check
+git add -A && git commit -m "..."
+git push space feat/new-ui:main --force-with-lease
+```
+
+If the Space doesn't rebuild, push an empty commit:
+
+```bash
+git commit --allow-empty -m "chore: trigger rebuild"
+git push space feat/new-ui:main --force-with-lease
+```
+
+## Post-deploy smoke test
+
+- Open the Space, sign in via HF: should NOT say "Missing clientId".
+- List robots: should show your robot (requires the robot to be online and authed with the same HF account).
+- Start session: the central circle should animate `listening`.
+- Speak: state -> `user-speaking` -> `processing` -> `ai-speaking`. Voice reaches the robot's speakers.
+- Say "nod yes": tool fires, head nods.
+- Say "dance dizzy spin": tool fires, dance plays at 100 Hz.
+- Transport pill shows `LAN` on local network, `Relay` through a mobile hotspot.

backend/src/agent/skills/build-reachy-voice-app/motion-agents.md

@@ -0,0 +1,129 @@
+# Motion agents
+
+Three concurrent agents animate the robot. All of them ultimately write to the daemon via `set_full_target` (or equivalent) and must not fight.
+
+## Head wobbler
+
+Goal: gentle head sway while the AI is speaking, amplitude proportional to TTS loudness.
+
+Recipe:
+- `AnalyserNode` on the OpenAI output track, read time-domain data in a `requestAnimationFrame` loop, compute RMS.
+- Smooth with a leaky integrator (`alpha ~0.12`). Clip to [0, 1].
+- Drive two lissajous-style sinusoids with independent frequencies for roll/pitch, amplitude modulated by the smoothed RMS.
+- Ship a head pose via `robot.setHeadPose(matrix)` every frame, or stop if `audioLevel < epsilon`.
+
+```ts
+const roll  = maxRoll  * level * Math.sin(2 * Math.PI * 0.9 * t + 0.3);
+const pitch = maxPitch * level * Math.sin(2 * Math.PI * 1.3 * t + 1.1);
+// yaw = 0, small translation optional
+```
+
+Pause (emit identity pose or skip emission) when:
+- tool lock is active
+- dance is playing
+- state is `user-speaking` (barge-in)
+
+## Antennas oscillator
+
+Goal: idle "breathing" + reactive motion during AI speech.
+
+Two modes:
+- **Idle**: slow symmetric oscillation, `antennas = [A*sin(w*t), A*sin(w*t + pi)]` with small `A` (0.1 rad), period ~4 s.
+- **Speaking**: faster, audio-reactive amplitude, optional asymmetry.
+
+Freeze to `[0, 0]` during `user-speaking`. Release tool lock by restoring idle mode gradually over ~300 ms.
+
+## Dances (tool-driven)
+
+Dances in the Reachy ecosystem are **procedural Python functions**, not recorded keyframes. They live in `reachy_mini_dances_library/`:
+
+- `rhythmic_motion.py`: primitives
+  - `oscillation_motion(t_beats, {amplitude, subcycles_per_beat, phase_offset, waveform})` with waveforms `sin | cos | square | triangle | sawtooth`
+  - `transient_motion(t_beats, {amplitude, duration, delay, repeat_every})` with smoothstep easing
+  - atomic helpers: `atomic_x_pos`, `atomic_roll`, ..., `atomic_antennas_wiggle`, ...
+  - `combine_offsets([...])`: sum of `MoveOffsets`
+- `collection/dance.py`: ~19 named dances composed from the primitives (`move_simple_nod`, `move_yeah_nod`, `move_dizzy_spin`, `move_jackson_square`, ...).
+- `dance_move.py`: wraps a move function with its parameters, `evaluate(t_seconds)` converts `t_seconds` to `t_beats` (with a global tempo, typically ~1.9 beats/s) and returns a 4x4 head matrix + antennas + body_yaw via `create_head_pose`.
+
+### Port strategy (recommended)
+
+Do not fetch JSON. Port the primitives + collection to TypeScript. Then:
+
+```ts
+class DancePlayer {
+  async play(name: string) {
+    const move = AVAILABLE_MOVES[name];
+    const durationS = (1 / TEMPO_BPS) * move.defaultDurationBeats;
+    const start = performance.now();
+    const tick = () => {
+      const t = (performance.now() - start) / 1000;
+      if (t >= durationS) return this.stop();
+      const tBeats = t * TEMPO_BPS;
+      const offsets = move.fn(tBeats, move.params);
+      const head = createHeadPose(offsets.x, offsets.y, offsets.z,
+                                  offsets.roll, offsets.pitch, offsets.yaw);
+      robot.sendRaw({
+        type: "set_full_target",
+        head: Array.from(head),         // 16 floats
+        antennas: [offsets.antennas[0], offsets.antennas[1]],
+        body_yaw: 0,
+      });
+      this.rafId = requestAnimationFrame(tick);
+    };
+    tick();
+  }
+}
+```
+
+Ship at 100 Hz either via `setInterval(10)` or via a `requestAnimationFrame` loop with a 10 ms check. 60 Hz is acceptable but feels less smooth on fast dances.
+
+### createHeadPose (port of scipy Euler -> matrix)
+
+`scipy.spatial.transform.Rotation.from_euler("xyz", [roll, pitch, yaw])` builds `Rx @ Ry @ Rz` with intrinsic rotations. In TS:
+
+```ts
+function createHeadPose(x: number, y: number, z: number,
+                        roll: number, pitch: number, yaw: number): Float32Array {
+  const cr = Math.cos(roll),  sr = Math.sin(roll);
+  const cp = Math.cos(pitch), sp = Math.sin(pitch);
+  const cy = Math.cos(yaw),   sy = Math.sin(yaw);
+  // R = Rx(roll) @ Ry(pitch) @ Rz(yaw)
+  const r00 =  cp * cy;
+  const r01 = -cp * sy;
+  const r02 =  sp;
+  const r10 =  cr * sy + sr * sp * cy;
+  const r11 =  cr * cy - sr * sp * sy;
+  const r12 = -sr * cp;
+  const r20 =  sr * sy - cr * sp * cy;
+  const r21 =  sr * cy + cr * sp * sy;
+  const r22 =  cr * cp;
+  const m = new Float32Array(16);
+  m[0]=r00; m[1]=r01; m[2]=r02;  m[3]=x;
+  m[4]=r10; m[5]=r11; m[6]=r12;  m[7]=y;
+  m[8]=r20; m[9]=r21; m[10]=r22; m[11]=z;
+  m[12]=0;  m[13]=0;  m[14]=0;   m[15]=1;
+  return m;
+}
+```
+
+Cross-check against Python: pick a few `(x,y,z,r,p,y)` triplets, compute in Python, paste the expected matrix into a unit test.
+
+### Alternative: pre-baked JSON
+
+If porting feels heavy, run the Python evaluator offline for each dance at 100 Hz, dump to JSON (`[{head: number[16], antennas: [r,l], body_yaw}, ...]`), ship them statically. Simpler, but you lose parameterisation.
+
+## Tool-driven poses (`move_head`)
+
+Tiny tool, much simpler than dances. Keep a dict of named poses:
+
+```ts
+const HEAD_POSES = {
+  nod_yes:    { x: 0, y: 0, z: 0, roll: 0, pitch:  0.3, yaw: 0 },
+  nod_no:     { x: 0, y: 0, z: 0, roll: 0, pitch:  0,   yaw: 0.4 },
+  look_left:  { x: 0, y: 0, z: 0, roll: 0, pitch:  0,   yaw: 0.5 },
+  look_right: { x: 0, y: 0, z: 0, roll: 0, pitch:  0,   yaw:-0.5 },
+  tilt:       { x: 0, y: 0, z: 0, roll: 0.4, pitch: 0,  yaw: 0 },
+};
+```
+
+Set tool lock, emit pose, wait `duration_seconds`, restore identity pose, release lock. Reply the tool call once the motion completes so the model can reference it in the next turn.

backend/src/agent/skills/build-reachy-voice-app/protocols.md

@@ -0,0 +1,132 @@
+# Protocol details
+
+## Reachy Mini daemon data channel
+
+Send JSON messages through the robot's data channel. The SDK wraps this as `robot.sendRaw(obj)`. The daemon accepts (verified in `reachy_mini/io/protocol.py` and `ws_server.py`):
+
+| Command | Payload | Notes |
+|---|---|---|
+| `set_target` | `{head, antennas, body_yaw}` keyframe | interpolated by daemon |
+| `set_full_target` | `{head: float[16], antennas: [r,l], body_yaw}` | **this is the fast path**, no interpolation, ship at 100 Hz for smooth motion |
+| `set_head_joints` | per-joint angles | rarely needed |
+| `set_body_yaw` | scalar radians | body turntable |
+| `set_antennas` | `[right, left]` radians | |
+| `goto_target` | keyframe + duration | daemon blends |
+| `wake_up` / `goto_sleep` | `{}` | safe boot/shutdown poses |
+| `play_sound` | base64 WAV or URL | daemon speaker out |
+| `set_motor_mode` / `set_torque` | per motor | |
+
+### Not supported over the data channel
+
+- **`PlayMoveTaskRequest`** (dances by name): the daemon logs `"PlayMoveTaskRequest not yet implemented over WS"`. Never rely on this.
+- Any task-style long-running request. The data channel is for state updates, not RPC with awaitable results.
+
+### `set_full_target` format
+
+Head is a 4x4 homogeneous transformation matrix in **row-major** order, flattened to 16 floats. Construct it with the same convention as `reachy_mini.utils.create_head_pose`:
+
+```
+T = Translation(x, y, z) @ Rx(roll) @ Ry(pitch) @ Rz(yaw)
+```
+
+In TypeScript, compose three 3x3 rotations with scipy's intrinsic-XYZ convention, insert into the top-left of a 4x4, translation in the last column, `[0,0,0,1]` at the bottom row, then flatten row-major.
+
+Units: meters for translation, radians for rotations and antennas.
+
+## OpenAI Realtime events we actually use
+
+Over the OpenAI data channel:
+
+### Outbound (we send)
+
+- `session.update` with `{type: "realtime", model, voice, instructions, tools, turn_detection, input_audio_transcription}` **once** on `session.created`. Re-sending this mid-conversation resets transcription.
+- `conversation.item.create` with a `function_call_output` item, to reply to a tool call.
+- `response.create` right after, to let the model speak again.
+
+### Inbound (we listen)
+
+| Event | Action |
+|---|---|
+| `session.created` | send `session.update`, set state `connected` |
+| `session.updated` | state `ready` |
+| `input_audio_buffer.speech_started` | state `user-speaking`, freeze motion |
+| `input_audio_buffer.speech_stopped` | state `processing` |
+| `response.audio.delta` (first) | state `ai-speaking`, enable wobbler |
+| `response.audio_transcript.delta` | optional: live caption |
+| `response.function_call_arguments.delta` | accumulate into `toolCalls[callId].arguments` |
+| `response.function_call_arguments.done` | parse JSON args, execute tool, reply |
+| `response.done` | state `listening` |
+| `error` | log; do not tear down unless data channel closes |
+
+### Tool call envelope
+
+Declare tools in `session.update`:
+
+```ts
+{
+  type: "function",
+  name: "move_head",
+  description: "Move the robot head to a named pose for N seconds",
+  parameters: {
+    type: "object",
+    properties: {
+      pose: { type: "string", enum: ["nod_yes", "nod_no", "look_left", "look_right", "tilt"] },
+      duration_seconds: { type: "number", minimum: 0.3, maximum: 5 }
+    },
+    required: ["pose"]
+  }
+}
+```
+
+Handle:
+
+```ts
+dc.addEventListener("message", (e) => {
+  const msg = JSON.parse(e.data);
+  if (msg.type === "response.function_call_arguments.done") {
+    const args = JSON.parse(msg.arguments);
+    const result = await executeTool(msg.name, args);
+    dc.send(JSON.stringify({
+      type: "conversation.item.create",
+      item: {
+        type: "function_call_output",
+        call_id: msg.call_id,
+        output: JSON.stringify(result),
+      }
+    }));
+    dc.send(JSON.stringify({ type: "response.create" }));
+  }
+});
+```
+
+`call_id` **must** match. Always respond, even on error (set `output: JSON.stringify({ error: "..." })`), otherwise the model stalls.
+
+## OpenAI Realtime WebRTC handshake
+
+One POST, SDP as body, not JSON:
+
+```ts
+const res = await fetch(`${proxy}/openai/v1/realtime?model=gpt-realtime`, {
+  method: "POST",
+  headers: {
+    "Authorization": `Bearer ${apiKey}`,
+    "Content-Type": "application/sdp",
+  },
+  body: offer.sdp,
+});
+const answerSdp = await res.text();
+await pc.setRemoteDescription({ type: "answer", sdp: answerSdp });
+```
+
+- `proxy` is `""` in prod (same origin, Nginx strips `/openai/`) and `""` in dev (Vite proxy rewrites).
+- Status codes seen in the wild: 401 (bad key), 421 (wrong host header via proxy, check your Nginx config), 500 (Nginx upstream issue), 400 (bad SDP, usually m-line order).
+
+## Robot daemon signaling
+
+You never touch this directly. The ReachyMini SDK handles:
+- listing robots via HF-hosted server
+- OAuth token exchange
+- WebRTC offer/answer and ICE through the HF signaling relay
+- creating the PC, the data channel, and the initial audio transceivers
+
+You only consume `robot._pc`, `robot.startSession()`, `robot.setHeadPose(...)`, `robot.setAntennas(...)`, `robot.sendRaw(...)`, `robot.login(...)`, `robot.listRobots()`.

backend/src/agent/skills/build-reachy-voice-app/webrtc-tuning.md

@@ -0,0 +1,162 @@
+# WebRTC reliability tuning
+
+Problem: we ship voice over WiFi with the browser as an audio hub. Default WebRTC settings produce audible cutouts when signal dips. The following four knobs, applied together, eliminate most mid-sentence cutouts on typical home WiFi. All four are applied on the OpenAI PC; the robot PC is local to the network (low RTT, no tuning needed).
+
+## 1. SDP munging: Opus FEC + DTX + bitrate
+
+Patch the `a=fmtp:<pt>` line for Opus in **both** the local offer and the remote answer (OpenAI's SDP defaults are not great for lossy links).
+
+```ts
+const OPUS_FMTP_OVERRIDES = {
+  minptime: "10",
+  useinbandfec: "1",         // in-band FEC, costs ~10% bitrate, recovers single-packet loss
+  usedtx: "0",               // disable discontinuous transmission, TTS hates silence gaps
+  stereo: "0",
+  "sprop-stereo": "0",
+  maxaveragebitrate: "32000",
+};
+
+function patchOpusFmtp(sdp: string): string {
+  // find opus payload type via "a=rtpmap:<pt> opus/48000/2"
+  // rewrite the matching "a=fmtp:<pt> ..." line with OPUS_FMTP_OVERRIDES
+  // if no fmtp line exists, inject one right after the rtpmap
+}
+
+const rawOffer = await pc.createOffer();
+await pc.setLocalDescription({ type: "offer", sdp: patchOpusFmtp(rawOffer.sdp!) });
+// ... POST to OpenAI ...
+const rawAnswer = await res.text();
+await pc.setRemoteDescription({ type: "answer", sdp: patchOpusFmtp(rawAnswer) });
+```
+
+Both patches matter. Patching the offer tells OpenAI what we accept; patching the answer forces the decoder and our encoder into the expected mode.
+
+## 2. `playoutDelayHint` on inbound receivers
+
+Increases the jitter buffer from ~40 ms default to 150 ms. Adds some latency but absorbs WiFi burst losses.
+
+```ts
+pc.ontrack = (event) => {
+  try {
+    (event.receiver as any).playoutDelayHint = 0.15;
+  } catch {}
+  // ... route to robot speaker ...
+};
+```
+
+150 ms is a good trade-off for voice chat; anything past 300 ms feels laggy.
+
+## 3. `sender.setParameters` bitrate cap
+
+Caps the outgoing audio bitrate to prevent WiFi saturation when several devices share the AP. Has to be done after `setLocalDescription`.
+
+```ts
+async function capSenderBitrate(pc: RTCPeerConnection, maxBitrate: number) {
+  const sender = pc.getSenders().find(s => s.track?.kind === "audio");
+  if (!sender) return;
+  const params = sender.getParameters();
+  if (!params.encodings || !params.encodings.length) {
+    params.encodings = [{}];
+  }
+  params.encodings[0].maxBitrate = maxBitrate;
+  await sender.setParameters(params);
+}
+```
+
+Call with `32000` to match the Opus `maxaveragebitrate`.
+
+## 4. Robust ICE state handling
+
+Default behavior: `iceConnectionState === "disconnected"` fires on any 2-second gap and panics. Over WiFi this happens all the time and auto-heals.
+
+```ts
+const ICE_DISCONNECT_GRACE_MS = 5000;
+let iceGraceTimer: number | null = null;
+
+pc.oniceconnectionstatechange = () => {
+  const s = pc.iceConnectionState;
+  if (s === "connected" || s === "completed") {
+    if (iceGraceTimer !== null) { clearTimeout(iceGraceTimer); iceGraceTimer = null; }
+    return;
+  }
+  if (s === "failed") {
+    if (iceGraceTimer !== null) { clearTimeout(iceGraceTimer); iceGraceTimer = null; }
+    escalateToError(new Error("ICE failed"));
+    return;
+  }
+  if (s === "disconnected") {
+    if (iceGraceTimer !== null) return;
+    iceGraceTimer = window.setTimeout(() => {
+      iceGraceTimer = null;
+      if (pc.iceConnectionState === "disconnected") {
+        escalateToError(new Error("ICE disconnected beyond grace"));
+      }
+    }, ICE_DISCONNECT_GRACE_MS);
+  }
+};
+```
+
+## Silent auto-reconnect
+
+If ICE escalates, close the OpenAI PC (not the robot PC) and retry once with the same robot mic track. If the second attempt also fails, bubble the error.
+
+```ts
+let reconnecting = false, reconnectAttempts = 0;
+
+async function tryReconnectOpenai(robotMicTrack: MediaStreamTrack, cause: Error) {
+  if (reconnecting) return;
+  if (reconnectAttempts >= 1) { onFatalError(cause); return; }
+  reconnecting = true;
+  reconnectAttempts += 1;
+  pauseMotionAgents();
+  openai.close();
+  await new Promise(r => setTimeout(r, 500));
+  try {
+    await connectOpenai(robotMicTrack);
+    // reset attempts on `connected`
+  } catch (err) {
+    onFatalError(err as Error);
+  } finally {
+    reconnecting = false;
+  }
+}
+```
+
+Reset `reconnectAttempts = 0` whenever the new PC reaches `connected`. Reset everything in the `teardown()` path.
+
+## Transport path detection (LAN / Direct / Relay pill)
+
+Useful to diagnose WiFi issues: tells the user whether the robot PC went peer-to-peer on the LAN or got relayed through a TURN server.
+
+Poll `robot._pc.getStats()` every 3 seconds and read the selected candidate pair:
+
+```ts
+type TransportKind = "lan" | "direct" | "relay" | "checking";
+
+function classify(stats: RTCStatsReport): TransportKind {
+  let pair: any;
+  stats.forEach(r => {
+    if (r.type === "candidate-pair" && (r.nominated || r.state === "succeeded") && r.selected !== false) {
+      pair = r;
+    }
+  });
+  if (!pair) return "checking";
+  const local  = stats.get(pair.localCandidateId);
+  const remote = stats.get(pair.remoteCandidateId);
+  if (!local || !remote) return "checking";
+  if (local.candidateType === "relay" || remote.candidateType === "relay") return "relay";
+  if (local.candidateType === "host"  && remote.candidateType === "host")  return "lan";
+  return "direct"; // srflx, prflx
+}
+```
+
+Drive a small header pill with CSS classes `transport-{lan|direct|relay|checking}` (green / blue / amber / blinking).
+
+Start the monitor after `startSession()` resolves (give ICE ~600 ms to pick a pair), stop it in teardown.
+
+## What NOT to bother with
+
+- Custom TURN servers: the HF signaling relay already provides one; switching gains nothing unless you self-host.
+- Disabling audio-level event updates: they are cheap.
+- `RTCPeerConnection.restartIce()`: tested, does not fix ICE failures in this setup; rebuilding the PC is cleaner.
+- FEC on the robot PC: it's on the local network, RTT < 10 ms, losses are zero. Only tune the OpenAI PC.

backend/src/agent/system-prompt.ts

@@ -0,0 +1,114 @@
+import { getPrimarySkill, listSkillDocs } from "./skill-loader.js";
+
+const BASE_PROMPT = `You are **Reachy Vibe Coder**, an agent that helps users build browser-based
+voice conversation apps for the Reachy Mini robot. The user describes what
+they want, you produce the source files, the user previews them live in a
+sandboxed iframe and can publish the result to a Hugging Face Space in one
+click.
+
+## How you work
+
+You maintain a small **virtual file system** for the current project. Every
+file mutation MUST go through one of these tools:
+
+- **write_file(path, content)** — Create or fully overwrite a file. Use for
+  new files and when a rewrite is cleaner than a surgical patch.
+- **edit_file(path, oldString, newString)** — Replace an *exact* substring.
+  Use for small targeted edits. If \`oldString\` is not unique the edit
+  fails - provide more context.
+- **delete_file(path)** — Remove a file.
+- **read_file(path)** — Inspect a file before editing.
+- **list_files()** — List the files currently in the virtual FS.
+- **read_skill_doc(topic)** — Load a detailed skill reference page. Use
+  *before* writing code whenever the topic is non-trivial.
+
+The virtual FS is rendered as a file tree in the UI and each file is shown
+in a Monaco editor. A sandboxed iframe re-runs the app whenever
+\`index.html\` changes.
+
+## Target project shape
+
+A typical Reachy Mini voice app produced by you looks like:
+
+\`\`\`
+index.html            ReachyMini SDK from CDN + OAuth injection placeholders
+src/main.ts           entry point (PC1 robot + PC2 OpenAI + state machine)
+src/style.css
+src/<module>.ts       motion agents, OpenAI glue, etc.
+package.json          vite + TypeScript, no framework deps
+vite.config.ts        dev proxy for /openai/*
+nginx.conf            prod proxy for /openai/* (same shape as dev)
+Dockerfile            multi-stage Vite build + Nginx runtime
+docker-entrypoint.d/
+  10-inject-hf-vars.sh   envsubst OAuth vars at container start
+README.md             HF Space frontmatter (sdk: docker, hf_oauth: true)
+\`\`\`
+
+The reference implementation is \`reachy_mini_minimal_conversation/\` and the
+full conventions live in the embedded **build-reachy-voice-app** skill (see
+below - call \`read_skill_doc\` for the chapter you need).
+
+## Working loop
+
+1. Start with a \`<thinking>\` block: what is the user asking, what files are
+   already there (call \`list_files\` if uncertain), which skill docs do you
+   need to re-read before editing.
+2. Call \`read_skill_doc\` for every relevant chapter (architecture, webrtc
+   tuning, deployment, …) *before* writing non-trivial code.
+3. Mutate the virtual FS through the tools. Prefer \`edit_file\` over
+   \`write_file\` for small changes.
+4. Finish with a short plain-text summary of what you did and what the user
+   should test next.
+
+## Non-negotiables
+
+- OpenAI's Realtime API has no CORS - every fetch to \`api.openai.com\` MUST
+  go through a same-origin proxy (Vite dev + Nginx prod). Never call it
+  directly from the browser.
+- On a Space, OAuth variables (\`OAUTH_CLIENT_ID\`, \`SPACE_HOST\`, …) are only
+  available server-side. You must inject them into \`index.html\` at
+  container start via a \`docker-entrypoint.d\` script using \`envsubst\`.
+- The robot mic track is obtained through \`robot._pc.getReceivers()\`, and
+  the robot speaker is updated through \`replaceTrack()\` on the existing
+  sender - never \`addTrack()\`.
+- Skill docs are the source of truth. When the user's request touches a
+  topic you haven't loaded yet, load it first.
+
+## Publishing
+
+When the user asks to publish, do NOT call a tool - tell them to click the
+"Publish to HF Space" button in the top bar. The frontend handles the
+\`@huggingface/hub\` upload; your job is to make sure the virtual FS is
+deploy-ready (has a valid \`README.md\` with the right frontmatter, a
+\`Dockerfile\`, and no missing imports).
+`;
+
+function buildSkillSection(): string {
+  const skill = getPrimarySkill();
+  if (!skill) {
+    return `\n## Embedded skill\n\n*(No skill loaded - running in minimal mode.)*\n`;
+  }
+
+  const docs = listSkillDocs(skill);
+  const docsList =
+    docs.length > 0
+      ? docs.map((d) => `- \`${d}\` — call \`read_skill_doc("${d}")\` to load it`).join("\n")
+      : "*(no additional docs)*";
+
+  return `
+## Embedded skill: \`${skill.id}\`
+
+Below is the skill **hub** (always in context). Additional chapters are
+available on demand via \`read_skill_doc\`:
+
+${docsList}
+
+---
+
+${skill.hub.content}
+`;
+}
+
+export function buildSystemPrompt(): string {
+  return `${BASE_PROMPT}\n${buildSkillSection()}`;
+}

backend/src/agent/tools.ts

@@ -0,0 +1,115 @@
+import { tool } from "ai";
+import { z } from "zod";
+import { getPrimarySkill, getSkillDoc, listSkillDocs } from "./skill-loader.js";
+
+/**
+ * ## Editor tools
+ *
+ * These tools describe *intents* to the LLM but are **executed client-side**:
+ * the Vercel AI SDK streams the tool call to the browser, the React app
+ * mutates the virtual FS, then sends the tool result back. This mirrors the
+ * pattern from `collab-editor` and keeps the backend completely stateless.
+ *
+ * ## Skill tools
+ *
+ * `read_skill_doc` is executed **server-side** (we have the files on disk)
+ * and returns markdown content directly in the tool result.
+ */
+
+const editorTools = {
+  write_file: tool({
+    description:
+      "Create a new file or fully overwrite an existing one in the virtual " +
+      "file system. Use when introducing a brand-new file or when a full " +
+      "rewrite is cleaner than a targeted edit. The UI will update its file " +
+      "tree and preview immediately.",
+    inputSchema: z.object({
+      path: z
+        .string()
+        .describe(
+          "Relative POSIX path inside the virtual project (e.g. " +
+            "`src/main.ts`, `index.html`, `Dockerfile`). No leading slash.",
+        ),
+      content: z
+        .string()
+        .describe("Full file contents. UTF-8 text."),
+    }),
+  }),
+
+  edit_file: tool({
+    description:
+      "Replace an exact substring inside an existing file. Preferred for " +
+      "small, surgical edits - much cheaper than rewriting the whole file. " +
+      "`old_string` must appear EXACTLY ONCE in the target file (add " +
+      "surrounding context if needed).",
+    inputSchema: z.object({
+      path: z.string().describe("Path of the file to edit."),
+      old_string: z
+        .string()
+        .describe(
+          "Exact text to find (must be unique in the file, include context " +
+            "lines before/after if ambiguous).",
+        ),
+      new_string: z.string().describe("Text to replace `old_string` with."),
+    }),
+  }),
+
+  delete_file: tool({
+    description: "Delete a file from the virtual FS.",
+    inputSchema: z.object({
+      path: z.string(),
+    }),
+  }),
+
+  read_file: tool({
+    description:
+      "Read the current contents of a file in the virtual FS. Use before " +
+      "`edit_file` when you are not sure of the exact current text.",
+    inputSchema: z.object({
+      path: z.string(),
+    }),
+  }),
+
+  list_files: tool({
+    description:
+      "List all files currently in the virtual FS with their size in bytes.",
+    inputSchema: z.object({}),
+  }),
+};
+
+const skillTools = {
+  read_skill_doc: tool({
+    description:
+      "Read a detailed chapter from the embedded `build-reachy-voice-app` " +
+      "skill. Call this BEFORE writing non-trivial code on topics like " +
+      "architecture, WebRTC tuning, motion agents, HF deployment, or the " +
+      "daemon protocol. Returns the full markdown of the requested chapter.",
+    inputSchema: z.object({
+      topic: z
+        .string()
+        .describe(
+          "Chapter name without extension. Available topics: architecture, " +
+            "deployment, motion-agents, protocols, webrtc-tuning.",
+        ),
+    }),
+    execute: async ({ topic }) => {
+      const skill = getPrimarySkill();
+      if (!skill) {
+        return "ERROR: No skill is loaded on the server.";
+      }
+      const doc = getSkillDoc(skill, topic);
+      if (!doc) {
+        const available = listSkillDocs(skill).join(", ");
+        return `ERROR: No such skill chapter "${topic}". Available: ${available}`;
+      }
+      return doc.content;
+    },
+  }),
+};
+
+export const agentTools = {
+  ...editorTools,
+  ...skillTools,
+};
+
+export const TOOL_NAMES = Object.keys(agentTools) as (keyof typeof agentTools)[];

backend/src/auth.ts

@@ -0,0 +1,99 @@
+import type { Context, Next } from "hono";
+
+/**
+ * Minimal Hugging Face access-token verification.
+ *
+ * The frontend obtains a token via the HF OAuth flow (`@huggingface/hub`
+ * client-side helper). It sends that token as `Authorization: Bearer <token>`
+ * on every `/api/*` call. Here we validate it by hitting the HF whoami
+ * endpoint and stash the user info on `c.set('hfUser', ...)`.
+ *
+ * For responsiveness we cache positive lookups for a few minutes - the token
+ * itself has a much longer TTL managed by HF.
+ */
+export interface HfUser {
+  name: string;
+  fullname?: string;
+  avatarUrl?: string;
+  email?: string;
+}
+
+interface CacheEntry {
+  user: HfUser;
+  expiresAt: number;
+}
+
+const CACHE = new Map<string, CacheEntry>();
+const CACHE_TTL_MS = 5 * 60 * 1000;
+
+export async function verifyHfToken(token: string): Promise<HfUser | null> {
+  if (!token) return null;
+
+  const cached = CACHE.get(token);
+  if (cached && cached.expiresAt > Date.now()) {
+    return cached.user;
+  }
+
+  try {
+    const res = await fetch("https://huggingface.co/api/whoami-v2", {
+      headers: { Authorization: `Bearer ${token}` },
+    });
+    if (!res.ok) return null;
+
+    const data = (await res.json()) as {
+      name?: string;
+      fullname?: string;
+      avatarUrl?: string;
+      email?: string;
+    };
+    if (!data.name) return null;
+
+    const user: HfUser = {
+      name: data.name,
+      fullname: data.fullname,
+      avatarUrl: data.avatarUrl,
+      email: data.email,
+    };
+    CACHE.set(token, { user, expiresAt: Date.now() + CACHE_TTL_MS });
+    return user;
+  } catch {
+    return null;
+  }
+}
+
+export function hfAuthMiddleware() {
+  const required = process.env.REQUIRE_HF_AUTH === "1";
+  return async (c: Context, next: Next) => {
+    const authHeader = c.req.header("authorization") ?? "";
+    const token = authHeader.startsWith("Bearer ")
+      ? authHeader.slice("Bearer ".length).trim()
+      : "";
+
+    if (!token) {
+      if (required) {
+        return c.json({ error: "Missing Hugging Face access token" }, 401);
+      }
+      return next();
+    }
+
+    const user = await verifyHfToken(token);
+    if (!user) {
+      if (required) {
+        return c.json({ error: "Invalid Hugging Face access token" }, 401);
+      }
+      return next();
+    }
+
+    c.set("hfUser", user);
+    c.set("hfToken", token);
+    return next();
+  };
+}
+
+export function getHfToken(c: Context): string | null {
+  return (c.get("hfToken") as string | undefined) ?? null;
+}
+
+export function getHfUser(c: Context): HfUser | null {
+  return (c.get("hfUser") as HfUser | undefined) ?? null;
+}

backend/src/routes/chat.ts

@@ -0,0 +1,87 @@
+import { Hono } from "hono";
+import { streamText, convertToModelMessages, stepCountIs } from "ai";
+import { createOpenRouter } from "@openrouter/ai-sdk-provider";
+import { agentTools } from "../agent/tools.js";
+import { buildSystemPrompt } from "../agent/system-prompt.js";
+
+export const AVAILABLE_MODELS = [
+  { id: "anthropic/claude-sonnet-4-5", label: "Claude Sonnet 4.5", context: "200K", cost: "$$$" },
+  { id: "anthropic/claude-3.5-haiku", label: "Claude 3.5 Haiku", context: "200K", cost: "$" },
+  { id: "google/gemini-2.5-flash", label: "Gemini 2.5 Flash", context: "1M", cost: "$" },
+  { id: "google/gemini-2.5-pro", label: "Gemini 2.5 Pro", context: "1M", cost: "$$" },
+  { id: "openai/gpt-4.1", label: "GPT-4.1", context: "1M", cost: "$$" },
+  { id: "openai/gpt-4.1-mini", label: "GPT-4.1 Mini", context: "1M", cost: "$" },
+];
+
+export const DEFAULT_MODEL = "anthropic/claude-sonnet-4-5";
+
+/**
+ * Hard cap on consecutive tool-call rounds - prevents runaway loops when a
+ * model keeps calling tools instead of emitting a final text response.
+ */
+const MAX_STEPS = 16;
+
+export const chatRoute = new Hono();
+
+chatRoute.post("/", async (c) => {
+  const apiKey = process.env.OPENROUTER_API_KEY;
+  if (!apiKey) {
+    return c.json(
+      { error: "OPENROUTER_API_KEY is not set on the server." },
+      500,
+    );
+  }
+
+  let body: unknown;
+  try {
+    body = await c.req.json();
+  } catch {
+    return c.json({ error: "Invalid JSON body" }, 400);
+  }
+
+  const { messages, model, context } = (body ?? {}) as {
+    messages?: unknown;
+    model?: string;
+    context?: { files?: { path: string; size: number }[] };
+  };
+
+  if (!Array.isArray(messages)) {
+    return c.json({ error: "`messages` array is required" }, 400);
+  }
+
+  const provider = createOpenRouter({ apiKey });
+  const modelId = model || process.env.OPENROUTER_MODEL || DEFAULT_MODEL;
+
+  const systemPrompt = buildSystemPrompt();
+
+  const contextBlock = context?.files?.length
+    ? `\n\n## Current virtual FS\n\n${context.files
+        .map((f) => `- \`${f.path}\` (${f.size} bytes)`)
+        .join("\n")}\n`
+    : "\n\n## Current virtual FS\n\n*(empty)*\n";
+
+  const modelMessages = await convertToModelMessages(messages as never);
+
+  try {
+    const result = streamText({
+      model: provider.chat(modelId),
+      system: systemPrompt + contextBlock,
+      messages: modelMessages,
+      tools: agentTools,
+      stopWhen: stepCountIs(MAX_STEPS),
+    });
+
+    const response = result.toUIMessageStreamResponse({
+      onError: (error) => {
+        console.error("[chat] stream error:", error);
+        return error instanceof Error ? error.message : "Stream error";
+      },
+    });
+
+    return response;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    console.error("[chat] error:", message);
+    return c.json({ error: message }, 500);
+  }
+});

backend/src/routes/models.ts

@@ -0,0 +1,8 @@
+import { Hono } from "hono";
+import { AVAILABLE_MODELS, DEFAULT_MODEL } from "./chat.js";
+
+export const modelsRoute = new Hono();
+
+modelsRoute.get("/", (c) =>
+  c.json({ models: AVAILABLE_MODELS, default: DEFAULT_MODEL }),
+);

backend/src/routes/publish.ts

@@ -0,0 +1,144 @@
+import { Hono } from "hono";
+import { stream } from "hono/streaming";
+import { createRepo, uploadFiles, spaceInfo } from "@huggingface/hub";
+import { getHfToken, getHfUser } from "../auth.js";
+
+export const publishRoute = new Hono();
+
+interface VirtualFile {
+  path: string;
+  content: string;
+}
+
+interface PublishBody {
+  repoName?: string; // "my-app" - username is inferred from token
+  private?: boolean;
+  files: VirtualFile[];
+  overwrite?: boolean;
+  commitMessage?: string;
+}
+
+/**
+ * Normalize a user-provided repo slug. HF space names allow `[A-Za-z0-9-_.]`.
+ */
+function sanitizeSlug(raw: string): string {
+  return raw
+    .trim()
+    .toLowerCase()
+    .replace(/\s+/g, "-")
+    .replace(/[^a-z0-9._-]/g, "")
+    .replace(/^-+|-+$/g, "")
+    .slice(0, 96);
+}
+
+function textToBlob(content: string): Blob {
+  return new Blob([content], { type: "text/plain; charset=utf-8" });
+}
+
+publishRoute.post("/", async (c) => {
+  const token = getHfToken(c);
+  const user = getHfUser(c);
+  if (!token || !user) {
+    return c.json(
+      { error: "A valid Hugging Face access token is required to publish." },
+      401,
+    );
+  }
+
+  let body: PublishBody;
+  try {
+    body = (await c.req.json()) as PublishBody;
+  } catch {
+    return c.json({ error: "Invalid JSON body" }, 400);
+  }
+
+  const files = Array.isArray(body.files) ? body.files : [];
+  if (files.length === 0) {
+    return c.json({ error: "No files provided" }, 400);
+  }
+
+  const slug = sanitizeSlug(body.repoName ?? `reachy-app-${Date.now()}`);
+  if (!slug) {
+    return c.json({ error: "Invalid repo name" }, 400);
+  }
+
+  const repoId = `${user.name}/${slug}`;
+  const repo = { type: "space" as const, name: repoId };
+
+  // Server-Sent Events for progress
+  c.header("Content-Type", "text/event-stream; charset=utf-8");
+  c.header("Cache-Control", "no-cache, no-store");
+  c.header("X-Accel-Buffering", "no");
+
+  return stream(c, async (s) => {
+    const send = (event: string, data: Record<string, unknown>) =>
+      s.write(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`);
+
+    try {
+      await send("progress", { step: "check", message: `Checking ${repoId}…` });
+
+      let alreadyExists = false;
+      try {
+        await spaceInfo({ name: repoId, accessToken: token });
+        alreadyExists = true;
+      } catch {
+        alreadyExists = false;
+      }
+
+      if (alreadyExists && !body.overwrite) {
+        await send("error", {
+          step: "check",
+          message: `Space "${repoId}" already exists. Set overwrite=true to update it.`,
+          code: "REPO_EXISTS",
+          repoId,
+        });
+        return;
+      }
+
+      if (!alreadyExists) {
+        await send("progress", { step: "create", message: `Creating Space ${repoId}…` });
+        await createRepo({
+          repo,
+          accessToken: token,
+          private: body.private ?? false,
+          sdk: "docker",
+        });
+      } else {
+        await send("progress", { step: "create", message: `Updating existing Space ${repoId}…` });
+      }
+
+      await send("progress", {
+        step: "upload",
+        message: `Uploading ${files.length} file${files.length === 1 ? "" : "s"}…`,
+      });
+
+      const uploads = files.map((f) => ({
+        path: f.path,
+        content: textToBlob(f.content),
+      }));
+
+      await uploadFiles({
+        repo,
+        accessToken: token,
+        files: uploads,
+        commitTitle:
+          body.commitMessage ??
+          (alreadyExists
+            ? "Update from Reachy Vibe Coder"
+            : "Initial commit from Reachy Vibe Coder"),
+      });
+
+      const spaceUrl = `https://huggingface.co/spaces/${repoId}`;
+      await send("done", {
+        step: "done",
+        repoId,
+        spaceUrl,
+        message: `Published to ${spaceUrl}`,
+      });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      console.error("[publish] error:", message);
+      await send("error", { step: "error", message });
+    }
+  });
+});

backend/src/server.ts

@@ -0,0 +1,104 @@
+import "dotenv/config";
+import { serve } from "@hono/node-server";
+import { serveStatic } from "@hono/node-server/serve-static";
+import { Hono } from "hono";
+import { cors } from "hono/cors";
+import { logger } from "hono/logger";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { existsSync, readFileSync } from "node:fs";
+import { hfAuthMiddleware } from "./auth.js";
+import { chatRoute } from "./routes/chat.js";
+import { publishRoute } from "./routes/publish.js";
+import { modelsRoute } from "./routes/models.js";
+import type { AppBindings } from "./types.js";
+
+if (!process.env.OPENROUTER_API_KEY) {
+  console.warn(
+    "[startup] OPENROUTER_API_KEY is not set - /api/chat will fail at request time.",
+  );
+}
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+/**
+ * Production layout after `docker build`:
+ *   /app/backend/dist/server.js       (this file)
+ *   /app/frontend/dist/               (Vite build output served as static)
+ *
+ * Dev layout:
+ *   backend/src/server.ts             (tsx)
+ *   frontend/dist/  (optional)
+ */
+const STATIC_CANDIDATES = [
+  path.resolve(__dirname, "../../frontend/dist"), // production
+  path.resolve(__dirname, "../../../frontend/dist"), // just in case
+  path.resolve(process.cwd(), "../frontend/dist"), // dev run from backend/
+  path.resolve(process.cwd(), "frontend/dist"), // dev run from repo root
+];
+const STATIC_ROOT =
+  STATIC_CANDIDATES.find((p) => existsSync(path.join(p, "index.html"))) ?? null;
+
+const app = new Hono<AppBindings>();
+
+app.use("*", logger());
+app.use(
+  "*",
+  cors({
+    origin: (origin) => origin ?? "*",
+    allowHeaders: ["Content-Type", "Authorization"],
+    allowMethods: ["GET", "POST", "PUT", "DELETE", "OPTIONS"],
+    credentials: true,
+  }),
+);
+
+// ── API routes (auth-gated) ───────────────────────────────────────────────
+const api = new Hono<AppBindings>();
+api.use("*", hfAuthMiddleware());
+api.route("/chat", chatRoute);
+api.route("/publish", publishRoute);
+api.route("/models", modelsRoute);
+api.get("/me", (c) => {
+  const user = c.get("hfUser");
+  if (!user) return c.json({ authenticated: false });
+  return c.json({ authenticated: true, user });
+});
+api.get("/health", (c) => c.json({ status: "ok" }));
+
+app.route("/api", api);
+
+// ── Static frontend ───────────────────────────────────────────────────────
+if (STATIC_ROOT) {
+  const indexHtml = readFileSync(path.join(STATIC_ROOT, "index.html"), "utf-8");
+
+  app.use(
+    "/assets/*",
+    serveStatic({
+      root: path.relative(process.cwd(), STATIC_ROOT) || ".",
+    }),
+  );
+
+  app.use("/favicon.ico", serveStatic({ path: path.join(STATIC_ROOT, "favicon.ico") }));
+
+  // SPA fallback for anything that's not /api/*
+  app.get("*", (c) => {
+    if (c.req.path.startsWith("/api/")) {
+      return c.notFound();
+    }
+    return c.html(indexHtml);
+  });
+  console.log(`[startup] Serving static frontend from ${STATIC_ROOT}`);
+} else {
+  app.get("/", (c) =>
+    c.json({
+      status: "api-only",
+      hint: "Frontend dist not found - run `cd frontend && npm run build` or use Vite dev server at :5173",
+    }),
+  );
+  console.log("[startup] No frontend/dist found - API-only mode");
+}
+
+const port = Number(process.env.PORT ?? 7860);
+serve({ fetch: app.fetch, port, hostname: "0.0.0.0" }, () => {
+  console.log(`[startup] reachy-mini-vibe-coder listening on :${port}`);
+});

backend/src/types.ts

@@ -0,0 +1,8 @@
+import type { HfUser } from "./auth.js";
+
+export type AppBindings = {
+  Variables: {
+    hfUser?: HfUser;
+    hfToken?: string;
+  };
+};

backend/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": false,
+    "sourceMap": true,
+    "noUnusedLocals": false,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

docker-entrypoint.d/10-inject-hf-vars.sh

@@ -0,0 +1,37 @@
+#!/bin/sh
+# Substitute the HF Space OAuth runtime variables into the built index.html.
+#
+# On a Hugging Face Space with `hf_oauth: true` in the README frontmatter, HF
+# provisions an OAuth app for the Space and exposes its client ID (and a few
+# other handles) as server-side env vars. Since this is a static-file build,
+# we splice them into `dist/index.html` at container startup, replacing the
+# `__OAUTH_CLIENT_ID__` style placeholders that `index.html` ships with.
+set -eu
+
+INDEX="/app/frontend/dist/index.html"
+if [ ! -f "$INDEX" ]; then
+  echo "[inject-hf-vars] $INDEX not found, skipping"
+  exit 0
+fi
+
+: "${OAUTH_CLIENT_ID:=}"
+: "${OAUTH_SCOPES:=openid profile write-repos manage-repos}"
+: "${SPACE_HOST:=}"
+: "${SPACE_ID:=}"
+
+if [ -z "$OAUTH_CLIENT_ID" ]; then
+  echo "[inject-hf-vars] OAUTH_CLIENT_ID is empty - leaving index.html placeholders untouched"
+  exit 0
+fi
+
+# `|` as sed delimiter avoids issues with values containing `/` (URLs).
+# Values shouldn't contain `|`; if HF ever sends such a value we'd need to
+# escape it explicitly.
+sed -i \
+  -e "s|__OAUTH_CLIENT_ID__|${OAUTH_CLIENT_ID}|g" \
+  -e "s|__OAUTH_SCOPES__|${OAUTH_SCOPES}|g" \
+  -e "s|__SPACE_HOST__|${SPACE_HOST}|g" \
+  -e "s|__SPACE_ID__|${SPACE_ID}|g" \
+  "$INDEX"
+
+echo "[inject-hf-vars] Injected OAuth variables into $INDEX"

docker-entrypoint.d/entrypoint.sh

@@ -0,0 +1,17 @@
+#!/bin/sh
+# Run every *.sh script under /app/docker-entrypoint.d (sorted) before exec'ing
+# the main container command. Each helper script gets the full env of the
+# container and is responsible for its own error handling.
+set -eu
+
+for script in /app/docker-entrypoint.d/*.sh; do
+  case "$script" in
+    *entrypoint.sh) continue ;;
+  esac
+  if [ -x "$script" ]; then
+    echo "[entrypoint] running $(basename "$script")"
+    "$script"
+  fi
+done
+
+exec "$@"

frontend/index.html

@@ -0,0 +1,49 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
+    <title>Reachy Mini · Vibe Coder</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link
+      href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap"
+      rel="stylesheet"
+    />
+    <!--
+      HF Spaces OAuth helper variables.
+
+      On `sdk: docker`, HF exposes OAUTH_CLIENT_ID / SPACE_HOST / SPACE_ID as
+      server-side env vars. We have nginx substitute them into this script at
+      container startup via `docker-entrypoint.d/10-inject-hf-vars.sh`.
+
+      Locally (`npm run dev`) the placeholders stay untouched; the app then
+      reads the client ID from VITE_HF_OAUTH_CLIENT_ID (set in `.env.local`).
+    -->
+    <script>
+      (function () {
+        var clientId = "__OAUTH_CLIENT_ID__";
+        var scopes = "__OAUTH_SCOPES__";
+        var spaceHost = "__SPACE_HOST__";
+        var spaceId = "__SPACE_ID__";
+        var looksSubstituted = clientId && clientId.indexOf("__") !== 0;
+        if (looksSubstituted) {
+          window.huggingface = window.huggingface || {};
+          window.huggingface.variables = {
+            OAUTH_CLIENT_ID: clientId,
+            OAUTH_SCOPES:
+              scopes && scopes.indexOf("__") !== 0
+                ? scopes
+                : "openid profile write-repos manage-repos",
+            SPACE_HOST: spaceHost && spaceHost.indexOf("__") !== 0 ? spaceHost : "",
+            SPACE_ID: spaceId && spaceId.indexOf("__") !== 0 ? spaceId : "",
+          };
+        }
+      })();
+    </script>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

frontend/package-lock.json

@@ -0,0 +1,2220 @@
+{
+  "name": "reachy-mini-vibe-coder-frontend",
+  "version": "0.1.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "reachy-mini-vibe-coder-frontend",
+      "version": "0.1.0",
+      "dependencies": {
+        "@ai-sdk/react": "^3.0.160",
+        "@huggingface/hub": "^2.11.0",
+        "@monaco-editor/react": "^4.7.0",
+        "ai": "^6.0.158",
+        "clsx": "^2.1.1",
+        "nanoid": "^5.0.7",
+        "react": "^18.3.1",
+        "react-dom": "^18.3.1"
+      },
+      "devDependencies": {
+        "@types/react": "^18.3.12",
+        "@types/react-dom": "^18.3.1",
+        "@vitejs/plugin-react": "^4.3.4",
+        "typescript": "^5.6.0",
+        "vite": "^6.0.0"
+      }
+    },
+    "node_modules/@ai-sdk/gateway": {
+      "version": "3.0.104",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/gateway/-/gateway-3.0.104.tgz",
+      "integrity": "sha512-ZKX5n74io8VIRlhIMSLWVlvT3sXC8Z7cZ9GHuWBWZDVi96+62AIsWuLGvMfcBA1STYuSoDrp6rIziZmvrTq0TA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "3.0.8",
+        "@ai-sdk/provider-utils": "4.0.23",
+        "@vercel/oidc": "3.2.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
+    "node_modules/@ai-sdk/provider": {
+      "version": "3.0.8",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider/-/provider-3.0.8.tgz",
+      "integrity": "sha512-oGMAgGoQdBXbZqNG0Ze56CHjDZ1IDYOwGYxYjO5KLSlz5HiNQ9udIXsPZ61VWaHGZ5XW/jyjmr6t2xz2jGVwbQ==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "json-schema": "^0.4.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@ai-sdk/provider-utils": {
+      "version": "4.0.23",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider-utils/-/provider-utils-4.0.23.tgz",
+      "integrity": "sha512-z8GlDaCmRSDlqkMF2f4/RFgWxdarvIbyuk+m6WXT1LYgsnGiXRJGTD2Z1+SDl3LqtFuRtGX1aghYvQLoHL/9pg==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "3.0.8",
+        "@standard-schema/spec": "^1.1.0",
+        "eventsource-parser": "^3.0.6"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
+    "node_modules/@ai-sdk/react": {
+      "version": "3.0.170",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/react/-/react-3.0.170.tgz",
+      "integrity": "sha512-YUDn+mK0c8iUz14rCBf1A0zg6SV5b5aSVUz+azF1bdBd1SFXVI19dKYR+PQSpZY+0+z+zs252AAsacUqiO98Kw==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider-utils": "4.0.23",
+        "ai": "6.0.168",
+        "swr": "^2.2.5",
+        "throttleit": "2.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "react": "^18 || ~19.0.1 || ~19.1.2 || ^19.2.1"
+      }
+    },
+    "node_modules/@babel/code-frame": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.0.tgz",
+      "integrity": "sha512-9NhCeYjq9+3uxgdtp20LSiJXJvN0FeCtNGpJxuMFZ1Kv3cWUNb6DOhJwUvcVCzKGR66cw4njwM6hrJLqgOwbcw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-validator-identifier": "^7.28.5",
+        "js-tokens": "^4.0.0",
+        "picocolors": "^1.1.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/compat-data": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.29.0.tgz",
+      "integrity": "sha512-T1NCJqT/j9+cn8fvkt7jtwbLBfLC/1y1c7NtCeXFRgzGTsafi68MRv8yzkYSapBnFA6L3U2VSc02ciDzoAJhJg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/core": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.29.0.tgz",
+      "integrity": "sha512-CGOfOJqWjg2qW/Mb6zNsDm+u5vFQ8DxXfbM09z69p5Z6+mE1ikP2jUXw+j42Pf1XTYED2Rni5f95npYeuwMDQA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@babel/code-frame": "^7.29.0",
+        "@babel/generator": "^7.29.0",
+        "@babel/helper-compilation-targets": "^7.28.6",
+        "@babel/helper-module-transforms": "^7.28.6",
+        "@babel/helpers": "^7.28.6",
+        "@babel/parser": "^7.29.0",
+        "@babel/template": "^7.28.6",
+        "@babel/traverse": "^7.29.0",
+        "@babel/types": "^7.29.0",
+        "@jridgewell/remapping": "^2.3.5",
+        "convert-source-map": "^2.0.0",
+        "debug": "^4.1.0",
+        "gensync": "^1.0.0-beta.2",
+        "json5": "^2.2.3",
+        "semver": "^6.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/babel"
+      }
+    },
+    "node_modules/@babel/generator": {
+      "version": "7.29.1",
+      "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.29.1.tgz",
+      "integrity": "sha512-qsaF+9Qcm2Qv8SRIMMscAvG4O3lJ0F1GuMo5HR/Bp02LopNgnZBC/EkbevHFeGs4ls/oPz9v+Bsmzbkbe+0dUw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.29.0",
+        "@babel/types": "^7.29.0",
+        "@jridgewell/gen-mapping": "^0.3.12",
+        "@jridgewell/trace-mapping": "^0.3.28",
+        "jsesc": "^3.0.2"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-compilation-targets": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.28.6.tgz",
+      "integrity": "sha512-JYtls3hqi15fcx5GaSNL7SCTJ2MNmjrkHXg4FSpOA/grxK8KwyZ5bubHsCq8FXCkua6xhuaaBit+3b7+VZRfcA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/compat-data": "^7.28.6",
+        "@babel/helper-validator-option": "^7.27.1",
+        "browserslist": "^4.24.0",
+        "lru-cache": "^5.1.1",
+        "semver": "^6.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-globals": {
+      "version": "7.28.0",
+      "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.28.0.tgz",
+      "integrity": "sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-module-imports": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.28.6.tgz",
+      "integrity": "sha512-l5XkZK7r7wa9LucGw9LwZyyCUscb4x37JWTPz7swwFE/0FMQAGpiWUZn8u9DzkSBWEcK25jmvubfpw2dnAMdbw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/traverse": "^7.28.6",
+        "@babel/types": "^7.28.6"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-module-transforms": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.28.6.tgz",
+      "integrity": "sha512-67oXFAYr2cDLDVGLXTEABjdBJZ6drElUSI7WKp70NrpyISso3plG9SAGEF6y7zbha/wOzUByWWTJvEDVNIUGcA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-module-imports": "^7.28.6",
+        "@babel/helper-validator-identifier": "^7.28.5",
+        "@babel/traverse": "^7.28.6"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/helper-plugin-utils": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.28.6.tgz",
+      "integrity": "sha512-S9gzZ/bz83GRysI7gAD4wPT/AI3uCnY+9xn+Mx/KPs2JwHJIz1W8PZkg2cqyt3RNOBM8ejcXhV6y8Og7ly/Dug==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-string-parser": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz",
+      "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-validator-identifier": {
+      "version": "7.28.5",
+      "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz",
+      "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-validator-option": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.27.1.tgz",
+      "integrity": "sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helpers": {
+      "version": "7.29.2",
+      "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.29.2.tgz",
+      "integrity": "sha512-HoGuUs4sCZNezVEKdVcwqmZN8GoHirLUcLaYVNBK2J0DadGtdcqgr3BCbvH8+XUo4NGjNl3VOtSjEKNzqfFgKw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/template": "^7.28.6",
+        "@babel/types": "^7.29.0"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/parser": {
+      "version": "7.29.2",
+      "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.2.tgz",
+      "integrity": "sha512-4GgRzy/+fsBa72/RZVJmGKPmZu9Byn8o4MoLpmNe1m8ZfYnz5emHLQz3U4gLud6Zwl0RZIcgiLD7Uq7ySFuDLA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/types": "^7.29.0"
+      },
+      "bin": {
+        "parser": "bin/babel-parser.js"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-react-jsx-self": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-react-jsx-self/-/plugin-transform-react-jsx-self-7.27.1.tgz",
+      "integrity": "sha512-6UzkCs+ejGdZ5mFFC/OCUrv028ab2fp1znZmCZjAOBKiBK2jXD1O+BPSfX8X2qjJ75fZBMSnQn3Rq2mrBJK2mw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.27.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-react-jsx-source": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-react-jsx-source/-/plugin-transform-react-jsx-source-7.27.1.tgz",
+      "integrity": "sha512-zbwoTsBruTeKB9hSq73ha66iFeJHuaFkUbwvqElnygoNbj/jHRsSeokowZFN3CZ64IvEqcmmkVe89OPXc7ldAw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.27.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/template": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.28.6.tgz",
+      "integrity": "sha512-YA6Ma2KsCdGb+WC6UpBVFJGXL58MDA6oyONbjyF/+5sBgxY/dwkhLogbMT2GXXyU84/IhRw/2D1Os1B/giz+BQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.28.6",
+        "@babel/parser": "^7.28.6",
+        "@babel/types": "^7.28.6"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/traverse": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.29.0.tgz",
+      "integrity": "sha512-4HPiQr0X7+waHfyXPZpWPfWL/J7dcN1mx9gL6WdQVMbPnF3+ZhSMs8tCxN7oHddJE9fhNE7+lxdnlyemKfJRuA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.29.0",
+        "@babel/generator": "^7.29.0",
+        "@babel/helper-globals": "^7.28.0",
+        "@babel/parser": "^7.29.0",
+        "@babel/template": "^7.28.6",
+        "@babel/types": "^7.29.0",
+        "debug": "^4.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/types": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.0.tgz",
+      "integrity": "sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-string-parser": "^7.27.1",
+        "@babel/helper-validator-identifier": "^7.28.5"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@esbuild/aix-ppc64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.25.12.tgz",
+      "integrity": "sha512-Hhmwd6CInZ3dwpuGTF8fJG6yoWmsToE+vYgD4nytZVxcu1ulHpUQRAB1UJ8+N1Am3Mz4+xOByoQoSZf4D+CpkA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.25.12.tgz",
+      "integrity": "sha512-VJ+sKvNA/GE7Ccacc9Cha7bpS8nyzVv0jdVgwNDaR4gDMC/2TTRc33Ip8qrNYUcpkOHUT5OZ0bUcNNVZQ9RLlg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.25.12.tgz",
+      "integrity": "sha512-6AAmLG7zwD1Z159jCKPvAxZd4y/VTO0VkprYy+3N2FtJ8+BQWFXU+OxARIwA46c5tdD9SsKGZ/1ocqBS/gAKHg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.25.12.tgz",
+      "integrity": "sha512-5jbb+2hhDHx5phYR2By8GTWEzn6I9UqR11Kwf22iKbNpYrsmRB18aX/9ivc5cabcUiAT/wM+YIZ6SG9QO6a8kg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.25.12.tgz",
+      "integrity": "sha512-N3zl+lxHCifgIlcMUP5016ESkeQjLj/959RxxNYIthIg+CQHInujFuXeWbWMgnTo4cp5XVHqFPmpyu9J65C1Yg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.25.12.tgz",
+      "integrity": "sha512-HQ9ka4Kx21qHXwtlTUVbKJOAnmG1ipXhdWTmNXiPzPfWKpXqASVcWdnf2bnL73wgjNrFXAa3yYvBSd9pzfEIpA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.25.12.tgz",
+      "integrity": "sha512-gA0Bx759+7Jve03K1S0vkOu5Lg/85dou3EseOGUes8flVOGxbhDDh/iZaoek11Y8mtyKPGF3vP8XhnkDEAmzeg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.25.12.tgz",
+      "integrity": "sha512-TGbO26Yw2xsHzxtbVFGEXBFH0FRAP7gtcPE7P5yP7wGy7cXK2oO7RyOhL5NLiqTlBh47XhmIUXuGciXEqYFfBQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.25.12.tgz",
+      "integrity": "sha512-lPDGyC1JPDou8kGcywY0YILzWlhhnRjdof3UlcoqYmS9El818LLfJJc3PXXgZHrHCAKs/Z2SeZtDJr5MrkxtOw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.25.12.tgz",
+      "integrity": "sha512-8bwX7a8FghIgrupcxb4aUmYDLp8pX06rGh5HqDT7bB+8Rdells6mHvrFHHW2JAOPZUbnjUpKTLg6ECyzvas2AQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ia32": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.25.12.tgz",
+      "integrity": "sha512-0y9KrdVnbMM2/vG8KfU0byhUN+EFCny9+8g202gYqSSVMonbsCfLjUO+rCci7pM0WBEtz+oK/PIwHkzxkyharA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-loong64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.25.12.tgz",
+      "integrity": "sha512-h///Lr5a9rib/v1GGqXVGzjL4TMvVTv+s1DPoxQdz7l/AYv6LDSxdIwzxkrPW438oUXiDtwM10o9PmwS/6Z0Ng==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-mips64el": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.25.12.tgz",
+      "integrity": "sha512-iyRrM1Pzy9GFMDLsXn1iHUm18nhKnNMWscjmp4+hpafcZjrr2WbT//d20xaGljXDBYHqRcl8HnxbX6uaA/eGVw==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ppc64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.25.12.tgz",
+      "integrity": "sha512-9meM/lRXxMi5PSUqEXRCtVjEZBGwB7P/D4yT8UG/mwIdze2aV4Vo6U5gD3+RsoHXKkHCfSxZKzmDssVlRj1QQA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-riscv64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.25.12.tgz",
+      "integrity": "sha512-Zr7KR4hgKUpWAwb1f3o5ygT04MzqVrGEGXGLnj15YQDJErYu/BGg+wmFlIDOdJp0PmB0lLvxFIOXZgFRrdjR0w==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-s390x": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.25.12.tgz",
+      "integrity": "sha512-MsKncOcgTNvdtiISc/jZs/Zf8d0cl/t3gYWX8J9ubBnVOwlk65UIEEvgBORTiljloIWnBzLs4qhzPkJcitIzIg==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.25.12.tgz",
+      "integrity": "sha512-uqZMTLr/zR/ed4jIGnwSLkaHmPjOjJvnm6TVVitAa08SLS9Z0VM8wIRx7gWbJB5/J54YuIMInDquWyYvQLZkgw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.25.12.tgz",
+      "integrity": "sha512-xXwcTq4GhRM7J9A8Gv5boanHhRa/Q9KLVmcyXHCTaM4wKfIpWkdXiMog/KsnxzJ0A1+nD+zoecuzqPmCRyBGjg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.25.12.tgz",
+      "integrity": "sha512-Ld5pTlzPy3YwGec4OuHh1aCVCRvOXdH8DgRjfDy/oumVovmuSzWfnSJg+VtakB9Cm0gxNO9BzWkj6mtO1FMXkQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.25.12.tgz",
+      "integrity": "sha512-fF96T6KsBo/pkQI950FARU9apGNTSlZGsv1jZBAlcLL1MLjLNIWPBkj5NlSz8aAzYKg+eNqknrUJ24QBybeR5A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.25.12.tgz",
+      "integrity": "sha512-MZyXUkZHjQxUvzK7rN8DJ3SRmrVrke8ZyRusHlP+kuwqTcfWLyqMOE3sScPPyeIXN/mDJIfGXvcMqCgYKekoQw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openharmony-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.25.12.tgz",
+      "integrity": "sha512-rm0YWsqUSRrjncSXGA7Zv78Nbnw4XL6/dzr20cyrQf7ZmRcsovpcRBdhD43Nuk3y7XIoW2OxMVvwuRvk9XdASg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/sunos-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.25.12.tgz",
+      "integrity": "sha512-3wGSCDyuTHQUzt0nV7bocDy72r2lI33QL3gkDNGkod22EsYl04sMf0qLb8luNKTOmgF/eDEDP5BFNwoBKH441w==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.25.12.tgz",
+      "integrity": "sha512-rMmLrur64A7+DKlnSuwqUdRKyd3UE7oPJZmnljqEptesKM8wx9J8gx5u0+9Pq0fQQW8vqeKebwNXdfOyP+8Bsg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-ia32": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.25.12.tgz",
+      "integrity": "sha512-HkqnmmBoCbCwxUKKNPBixiWDGCpQGVsrQfJoVGYLPT41XWF8lHuE5N6WhVia2n4o5QK5M4tYr21827fNhi4byQ==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-x64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.25.12.tgz",
+      "integrity": "sha512-alJC0uCZpTFrSL0CCDjcgleBXPnCrEAhTBILpeAp7M/OFgoqtAetfBzX0xM00MUsVVPpVjlPuMbREqnZCXaTnA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@huggingface/hub": {
+      "version": "2.11.0",
+      "resolved": "https://registry.npmjs.org/@huggingface/hub/-/hub-2.11.0.tgz",
+      "integrity": "sha512-WS6QGaXYeBVFlaB4SOn6z4LGUpLB5kRZNL08uUni4izX353KxiwwZMK5+/AWX86MJh8SMZNa/JFcvFCcQsbszQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@huggingface/tasks": "^0.19.90"
+      },
+      "bin": {
+        "hfjs": "dist/cli.js"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "cli-progress": "^3.12.0"
+      }
+    },
+    "node_modules/@huggingface/tasks": {
+      "version": "0.19.90",
+      "resolved": "https://registry.npmjs.org/@huggingface/tasks/-/tasks-0.19.90.tgz",
+      "integrity": "sha512-nfV9luJbvwGQ/5oKXkKhCV9h4X7mwh1YaGG3ORd6UMLDSwr1OFSSatcBX0O9OtBtmNK19aGSjbLFqqgcIR6+IA==",
+      "license": "MIT"
+    },
+    "node_modules/@jridgewell/gen-mapping": {
+      "version": "0.3.13",
+      "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz",
+      "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/sourcemap-codec": "^1.5.0",
+        "@jridgewell/trace-mapping": "^0.3.24"
+      }
+    },
+    "node_modules/@jridgewell/remapping": {
+      "version": "2.3.5",
+      "resolved": "https://registry.npmjs.org/@jridgewell/remapping/-/remapping-2.3.5.tgz",
+      "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/gen-mapping": "^0.3.5",
+        "@jridgewell/trace-mapping": "^0.3.24"
+      }
+    },
+    "node_modules/@jridgewell/resolve-uri": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz",
+      "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@jridgewell/sourcemap-codec": {
+      "version": "1.5.5",
+      "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
+      "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@jridgewell/trace-mapping": {
+      "version": "0.3.31",
+      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
+      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/resolve-uri": "^3.1.0",
+        "@jridgewell/sourcemap-codec": "^1.4.14"
+      }
+    },
+    "node_modules/@monaco-editor/loader": {
+      "version": "1.7.0",
+      "resolved": "https://registry.npmjs.org/@monaco-editor/loader/-/loader-1.7.0.tgz",
+      "integrity": "sha512-gIwR1HrJrrx+vfyOhYmCZ0/JcWqG5kbfG7+d3f/C1LXk2EvzAbHSg3MQ5lO2sMlo9izoAZ04shohfKLVT6crVA==",
+      "license": "MIT",
+      "dependencies": {
+        "state-local": "^1.0.6"
+      }
+    },
+    "node_modules/@monaco-editor/react": {
+      "version": "4.7.0",
+      "resolved": "https://registry.npmjs.org/@monaco-editor/react/-/react-4.7.0.tgz",
+      "integrity": "sha512-cyzXQCtO47ydzxpQtCGSQGOC8Gk3ZUeBXFAxD+CWXYFo5OqZyZUonFl0DwUlTyAfRHntBfw2p3w4s9R6oe1eCA==",
+      "license": "MIT",
+      "dependencies": {
+        "@monaco-editor/loader": "^1.5.0"
+      },
+      "peerDependencies": {
+        "monaco-editor": ">= 0.25.0 < 1",
+        "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
+        "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+      }
+    },
+    "node_modules/@opentelemetry/api": {
+      "version": "1.9.0",
+      "resolved": "https://registry.npmjs.org/@opentelemetry/api/-/api-1.9.0.tgz",
+      "integrity": "sha512-3giAOQvZiH5F9bMlMiv8+GSPMeqg0dbaeo58/0SlA9sxSqZhnUtxzX9/2FzyhS9sWQf5S0GJE0AKBrFqjpeYcg==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
+    "node_modules/@rolldown/pluginutils": {
+      "version": "1.0.0-beta.27",
+      "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.0-beta.27.tgz",
+      "integrity": "sha512-+d0F4MKMCbeVUJwG96uQ4SgAznZNSq93I3V+9NHA4OpvqG8mRCpGdKmK8l/dl02h2CCDHwW2FqilnTyDcAnqjA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@rollup/rollup-android-arm-eabi": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.60.2.tgz",
+      "integrity": "sha512-dnlp69efPPg6Uaw2dVqzWRfAWRnYVb1XJ8CyyhIbZeaq4CA5/mLeZ1IEt9QqQxmbdvagjLIm2ZL8BxXv5lH4Yw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-android-arm64": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.60.2.tgz",
+      "integrity": "sha512-OqZTwDRDchGRHHm/hwLOL7uVPB9aUvI0am/eQuWMNyFHf5PSEQmyEeYYheA0EPPKUO/l0uigCp+iaTjoLjVoHg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-arm64": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.60.2.tgz",
+      "integrity": "sha512-UwRE7CGpvSVEQS8gUMBe1uADWjNnVgP3Iusyda1nSRwNDCsRjnGc7w6El6WLQsXmZTbLZx9cecegumcitNfpmA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-x64": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.60.2.tgz",
+      "integrity": "sha512-gjEtURKLCC5VXm1I+2i1u9OhxFsKAQJKTVB8WvDAHF+oZlq0GTVFOlTlO1q3AlCTE/DF32c16ESvfgqR7343/g==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-arm64": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.60.2.tgz",
+      "integrity": "sha512-Bcl6CYDeAgE70cqZaMojOi/eK63h5Me97ZqAQoh77VPjMysA/4ORQBRGo3rRy45x4MzVlU9uZxs8Uwy7ZaKnBw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-x64": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.60.2.tgz",
+      "integrity": "sha512-LU+TPda3mAE2QB0/Hp5VyeKJivpC6+tlOXd1VMoXV/YFMvk/MNk5iXeBfB4MQGRWyOYVJ01625vjkr0Az98OJQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.60.2.tgz",
+      "integrity": "sha512-2QxQrM+KQ7DAW4o22j+XZ6RKdxjLD7BOWTP0Bv0tmjdyhXSsr2Ul1oJDQqh9Zf5qOwTuTc7Ek83mOFaKnodPjg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-musleabihf": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.60.2.tgz",
+      "integrity": "sha512-TbziEu2DVsTEOPif2mKWkMeDMLoYjx95oESa9fkQQK7r/Orta0gnkcDpzwufEcAO2BLBsD7mZkXGFqEdMRRwfw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-gnu": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.60.2.tgz",
+      "integrity": "sha512-bO/rVDiDUuM2YfuCUwZ1t1cP+/yqjqz+Xf2VtkdppefuOFS2OSeAfgafaHNkFn0t02hEyXngZkxtGqXcXwO8Rg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-musl": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.60.2.tgz",
+      "integrity": "sha512-hr26p7e93Rl0Za+JwW7EAnwAvKkehh12BU1Llm9Ykiibg4uIr2rbpxG9WCf56GuvidlTG9KiiQT/TXT1yAWxTA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-loong64-gnu": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.60.2.tgz",
+      "integrity": "sha512-pOjB/uSIyDt+ow3k/RcLvUAOGpysT2phDn7TTUB3n75SlIgZzM6NKAqlErPhoFU+npgY3/n+2HYIQVbF70P9/A==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-loong64-musl": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.60.2.tgz",
+      "integrity": "sha512-2/w+q8jszv9Ww1c+6uJT3OwqhdmGP2/4T17cu8WuwyUuuaCDDJ2ojdyYwZzCxx0GcsZBhzi3HmH+J5pZNXnd+Q==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-ppc64-gnu": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.60.2.tgz",
+      "integrity": "sha512-11+aL5vKheYgczxtPVVRhdptAM2H7fcDR5Gw4/bTcteuZBlH4oP9f5s9zYO9aGZvoGeBpqXI/9TZZihZ609wKw==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-ppc64-musl": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.60.2.tgz",
+      "integrity": "sha512-i16fokAGK46IVZuV8LIIwMdtqhin9hfYkCh8pf8iC3QU3LpwL+1FSFGej+O7l3E/AoknL6Dclh2oTdnRMpTzFQ==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-gnu": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.60.2.tgz",
+      "integrity": "sha512-49FkKS6RGQoriDSK/6E2GkAsAuU5kETFCh7pG4yD/ylj9rKhTmO3elsnmBvRD4PgJPds5W2PkhC82aVwmUcJ7A==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-musl": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.60.2.tgz",
+      "integrity": "sha512-mjYNkHPfGpUR00DuM1ZZIgs64Hpf4bWcz9Z41+4Q+pgDx73UwWdAYyf6EG/lRFldmdHHzgrYyge5akFUW0D3mQ==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-s390x-gnu": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.60.2.tgz",
+      "integrity": "sha512-ALyvJz965BQk8E9Al/JDKKDLH2kfKFLTGMlgkAbbYtZuJt9LU8DW3ZoDMCtQpXAltZxwBHevXz5u+gf0yA0YoA==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-gnu": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.60.2.tgz",
+      "integrity": "sha512-UQjrkIdWrKI626Du8lCQ6MJp/6V1LAo2bOK9OTu4mSn8GGXIkPXk/Vsp4bLHCd9Z9Iz2OTEaokUE90VweJgIYQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-musl": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.60.2.tgz",
+      "integrity": "sha512-bTsRGj6VlSdn/XD4CGyzMnzaBs9bsRxy79eTqTCBsA8TMIEky7qg48aPkvJvFe1HyzQ5oMZdg7AnVlWQSKLTnw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-openbsd-x64": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.60.2.tgz",
+      "integrity": "sha512-6d4Z3534xitaA1FcMWP7mQPq5zGwBmGbhphh2DwaA1aNIXUu3KTOfwrWpbwI4/Gr0uANo7NTtaykFyO2hPuFLg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-openharmony-arm64": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.60.2.tgz",
+      "integrity": "sha512-NetAg5iO2uN7eB8zE5qrZ3CSil+7IJt4WDFLcC75Ymywq1VZVD6qJ6EvNLjZ3rEm6gB7XW5JdT60c6MN35Z85Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-arm64-msvc": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.60.2.tgz",
+      "integrity": "sha512-NCYhOotpgWZ5kdxCZsv6Iudx0wX8980Q/oW4pNFNihpBKsDbEA1zpkfxJGC0yugsUuyDZ7gL37dbzwhR0VI7pQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-ia32-msvc": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.60.2.tgz",
+      "integrity": "sha512-RXsaOqXxfoUBQoOgvmmijVxJnW2IGB0eoMO7F8FAjaj0UTywUO/luSqimWBJn04WNgUkeNhh7fs7pESXajWmkg==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-x64-gnu": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.60.2.tgz",
+      "integrity": "sha512-qdAzEULD+/hzObedtmV6iBpdL5TIbKVztGiK7O3/KYSf+HIzU257+MX1EXJcyIiDbMAqmbwaufcYPvyRryeZtA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-x64-msvc": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.60.2.tgz",
+      "integrity": "sha512-Nd/SgG27WoA9e+/TdK74KnHz852TLa94ovOYySo/yMPuTmpckK/jIF2jSwS3g7ELSKXK13/cVdmg1Z/DaCWKxA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@standard-schema/spec": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@standard-schema/spec/-/spec-1.1.0.tgz",
+      "integrity": "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==",
+      "license": "MIT"
+    },
+    "node_modules/@types/babel__core": {
+      "version": "7.20.5",
+      "resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.20.5.tgz",
+      "integrity": "sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.20.7",
+        "@babel/types": "^7.20.7",
+        "@types/babel__generator": "*",
+        "@types/babel__template": "*",
+        "@types/babel__traverse": "*"
+      }
+    },
+    "node_modules/@types/babel__generator": {
+      "version": "7.27.0",
+      "resolved": "https://registry.npmjs.org/@types/babel__generator/-/babel__generator-7.27.0.tgz",
+      "integrity": "sha512-ufFd2Xi92OAVPYsy+P4n7/U7e68fex0+Ee8gSG9KX7eo084CWiQ4sdxktvdl0bOPupXtVJPY19zk6EwWqUQ8lg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/types": "^7.0.0"
+      }
+    },
+    "node_modules/@types/babel__template": {
+      "version": "7.4.4",
+      "resolved": "https://registry.npmjs.org/@types/babel__template/-/babel__template-7.4.4.tgz",
+      "integrity": "sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.1.0",
+        "@babel/types": "^7.0.0"
+      }
+    },
+    "node_modules/@types/babel__traverse": {
+      "version": "7.28.0",
+      "resolved": "https://registry.npmjs.org/@types/babel__traverse/-/babel__traverse-7.28.0.tgz",
+      "integrity": "sha512-8PvcXf70gTDZBgt9ptxJ8elBeBjcLOAcOtoO/mPJjtji1+CdGbHgm77om1GrsPxsiE+uXIpNSK64UYaIwQXd4Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/types": "^7.28.2"
+      }
+    },
+    "node_modules/@types/estree": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz",
+      "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/prop-types": {
+      "version": "15.7.15",
+      "resolved": "https://registry.npmjs.org/@types/prop-types/-/prop-types-15.7.15.tgz",
+      "integrity": "sha512-F6bEyamV9jKGAFBEmlQnesRPGOQqS2+Uwi0Em15xenOxHaf2hv6L8YCVn3rPdPJOiJfPiCnLIRyvwVaqMY3MIw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/react": {
+      "version": "18.3.28",
+      "resolved": "https://registry.npmjs.org/@types/react/-/react-18.3.28.tgz",
+      "integrity": "sha512-z9VXpC7MWrhfWipitjNdgCauoMLRdIILQsAEV+ZesIzBq/oUlxk0m3ApZuMFCXdnS4U7KrI+l3WRUEGQ8K1QKw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@types/prop-types": "*",
+        "csstype": "^3.2.2"
+      }
+    },
+    "node_modules/@types/react-dom": {
+      "version": "18.3.7",
+      "resolved": "https://registry.npmjs.org/@types/react-dom/-/react-dom-18.3.7.tgz",
+      "integrity": "sha512-MEe3UeoENYVFXzoXEWsvcpg6ZvlrFNlOQ7EOsvhI3CfAXwzPfO8Qwuxd40nepsYKqyyVQnTdEfv68q91yLcKrQ==",
+      "dev": true,
+      "license": "MIT",
+      "peerDependencies": {
+        "@types/react": "^18.0.0"
+      }
+    },
+    "node_modules/@types/trusted-types": {
+      "version": "2.0.7",
+      "resolved": "https://registry.npmjs.org/@types/trusted-types/-/trusted-types-2.0.7.tgz",
+      "integrity": "sha512-ScaPdn1dQczgbl0QFTeTOmVHFULt394XJgOQNoyVhZ6r2vLnMLJfBPd53SB52T/3G36VI1/g2MZaX0cwDuXsfw==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/@vercel/oidc": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/@vercel/oidc/-/oidc-3.2.0.tgz",
+      "integrity": "sha512-UycprH3T6n3jH0k44NHMa7pnFHGu/N05MjojYr+Mc6I7obkoLIJujSWwin1pCvdy/eOxrI/l3uDLQsmcrOb4ug==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">= 20"
+      }
+    },
+    "node_modules/@vitejs/plugin-react": {
+      "version": "4.7.0",
+      "resolved": "https://registry.npmjs.org/@vitejs/plugin-react/-/plugin-react-4.7.0.tgz",
+      "integrity": "sha512-gUu9hwfWvvEDBBmgtAowQCojwZmJ5mcLn3aufeCsitijs3+f2NsrPtlAWIR6OPiqljl96GVCUbLe0HyqIpVaoA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/core": "^7.28.0",
+        "@babel/plugin-transform-react-jsx-self": "^7.27.1",
+        "@babel/plugin-transform-react-jsx-source": "^7.27.1",
+        "@rolldown/pluginutils": "1.0.0-beta.27",
+        "@types/babel__core": "^7.20.5",
+        "react-refresh": "^0.17.0"
+      },
+      "engines": {
+        "node": "^14.18.0 || >=16.0.0"
+      },
+      "peerDependencies": {
+        "vite": "^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0"
+      }
+    },
+    "node_modules/ai": {
+      "version": "6.0.168",
+      "resolved": "https://registry.npmjs.org/ai/-/ai-6.0.168.tgz",
+      "integrity": "sha512-2HqCJuO+1V2aV7vfYs5LFEUfxbkGX+5oa54q/gCCTL7KLTdbxcCu5D7TdLA5kwsrs3Szgjah9q6D9tpjHM3hUQ==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/gateway": "3.0.104",
+        "@ai-sdk/provider": "3.0.8",
+        "@ai-sdk/provider-utils": "4.0.23",
+        "@opentelemetry/api": "1.9.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
+    "node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/baseline-browser-mapping": {
+      "version": "2.10.20",
+      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.20.tgz",
+      "integrity": "sha512-1AaXxEPfXT+GvTBJFuy4yXVHWJBXa4OdbIebGN/wX5DlsIkU0+wzGnd2lOzokSk51d5LUmqjgBLRLlypLUqInQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "bin": {
+        "baseline-browser-mapping": "dist/cli.cjs"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/browserslist": {
+      "version": "4.28.2",
+      "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.2.tgz",
+      "integrity": "sha512-48xSriZYYg+8qXna9kwqjIVzuQxi+KYWp2+5nCYnYKPTr0LvD89Jqk2Or5ogxz0NUMfIjhh2lIUX/LyX9B4oIg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/browserslist"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "baseline-browser-mapping": "^2.10.12",
+        "caniuse-lite": "^1.0.30001782",
+        "electron-to-chromium": "^1.5.328",
+        "node-releases": "^2.0.36",
+        "update-browserslist-db": "^1.2.3"
+      },
+      "bin": {
+        "browserslist": "cli.js"
+      },
+      "engines": {
+        "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7"
+      }
+    },
+    "node_modules/caniuse-lite": {
+      "version": "1.0.30001790",
+      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001790.tgz",
+      "integrity": "sha512-bOoxfJPyYo+ds6W0YfptaCWbFnJYjh2Y1Eow5lRv+vI2u8ganPZqNm1JwNh0t2ELQCqIWg4B3dWEusgAmsoyOw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/caniuse-lite"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "CC-BY-4.0"
+    },
+    "node_modules/cli-progress": {
+      "version": "3.12.0",
+      "resolved": "https://registry.npmjs.org/cli-progress/-/cli-progress-3.12.0.tgz",
+      "integrity": "sha512-tRkV3HJ1ASwm19THiiLIXLO7Im7wlTuKnvkYaTkyoAPefqjNg7W7DHKUlGRxy9vxDvbyCYQkQozvptuMkGCg8A==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "string-width": "^4.2.3"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/clsx": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/clsx/-/clsx-2.1.1.tgz",
+      "integrity": "sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/convert-source-map": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz",
+      "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/csstype": {
+      "version": "3.2.3",
+      "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz",
+      "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/debug": {
+      "version": "4.4.3",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ms": "^2.1.3"
+      },
+      "engines": {
+        "node": ">=6.0"
+      },
+      "peerDependenciesMeta": {
+        "supports-color": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/dequal": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/dequal/-/dequal-2.0.3.tgz",
+      "integrity": "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/dompurify": {
+      "version": "3.2.7",
+      "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.2.7.tgz",
+      "integrity": "sha512-WhL/YuveyGXJaerVlMYGWhvQswa7myDG17P7Vu65EWC05o8vfeNbvNf4d/BOvH99+ZW+LlQsc1GDKMa1vNK6dw==",
+      "license": "(MPL-2.0 OR Apache-2.0)",
+      "optionalDependencies": {
+        "@types/trusted-types": "^2.0.7"
+      }
+    },
+    "node_modules/electron-to-chromium": {
+      "version": "1.5.343",
+      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.343.tgz",
+      "integrity": "sha512-YHnQ3MXI08icvL9ZKnEBy05F2EQ8ob01UaMOuMbM8l+4UcAq6MPPbBTJBbsBUg3H8JeZNt+O4fjsoWth3p6IFg==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/emoji-regex": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/esbuild": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.12.tgz",
+      "integrity": "sha512-bbPBYYrtZbkt6Os6FiTLCTFxvq4tt3JKall1vRwshA3fdVztsLAatFaZobhkBC8/BrPetoa0oksYoKXoG4ryJg==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.25.12",
+        "@esbuild/android-arm": "0.25.12",
+        "@esbuild/android-arm64": "0.25.12",
+        "@esbuild/android-x64": "0.25.12",
+        "@esbuild/darwin-arm64": "0.25.12",
+        "@esbuild/darwin-x64": "0.25.12",
+        "@esbuild/freebsd-arm64": "0.25.12",
+        "@esbuild/freebsd-x64": "0.25.12",
+        "@esbuild/linux-arm": "0.25.12",
+        "@esbuild/linux-arm64": "0.25.12",
+        "@esbuild/linux-ia32": "0.25.12",
+        "@esbuild/linux-loong64": "0.25.12",
+        "@esbuild/linux-mips64el": "0.25.12",
+        "@esbuild/linux-ppc64": "0.25.12",
+        "@esbuild/linux-riscv64": "0.25.12",
+        "@esbuild/linux-s390x": "0.25.12",
+        "@esbuild/linux-x64": "0.25.12",
+        "@esbuild/netbsd-arm64": "0.25.12",
+        "@esbuild/netbsd-x64": "0.25.12",
+        "@esbuild/openbsd-arm64": "0.25.12",
+        "@esbuild/openbsd-x64": "0.25.12",
+        "@esbuild/openharmony-arm64": "0.25.12",
+        "@esbuild/sunos-x64": "0.25.12",
+        "@esbuild/win32-arm64": "0.25.12",
+        "@esbuild/win32-ia32": "0.25.12",
+        "@esbuild/win32-x64": "0.25.12"
+      }
+    },
+    "node_modules/escalade": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",
+      "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/eventsource-parser": {
+      "version": "3.0.8",
+      "resolved": "https://registry.npmjs.org/eventsource-parser/-/eventsource-parser-3.0.8.tgz",
+      "integrity": "sha512-70QWGkr4snxr0OXLRWsFLeRBIRPuQOvt4s8QYjmUlmlkyTZkRqS7EDVRZtzU3TiyDbXSzaOeF0XUKy8PchzukQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/fdir": {
+      "version": "6.5.0",
+      "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
+      "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "peerDependencies": {
+        "picomatch": "^3 || ^4"
+      },
+      "peerDependenciesMeta": {
+        "picomatch": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
+    "node_modules/gensync": {
+      "version": "1.0.0-beta.2",
+      "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz",
+      "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/is-fullwidth-code-point": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
+      "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/js-tokens": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
+      "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
+      "license": "MIT"
+    },
+    "node_modules/jsesc": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.1.0.tgz",
+      "integrity": "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "jsesc": "bin/jsesc"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/json-schema": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/json-schema/-/json-schema-0.4.0.tgz",
+      "integrity": "sha512-es94M3nTIfsEPisRafak+HDLfHXnKBhV3vU5eqPcS3flIWqcxJWgXHXiey3YrpaNsanY5ei1VoYEbOzijuq9BA==",
+      "license": "(AFL-2.1 OR BSD-3-Clause)"
+    },
+    "node_modules/json5": {
+      "version": "2.2.3",
+      "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz",
+      "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "json5": "lib/cli.js"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/loose-envify": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz",
+      "integrity": "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==",
+      "license": "MIT",
+      "dependencies": {
+        "js-tokens": "^3.0.0 || ^4.0.0"
+      },
+      "bin": {
+        "loose-envify": "cli.js"
+      }
+    },
+    "node_modules/lru-cache": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-5.1.1.tgz",
+      "integrity": "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "yallist": "^3.0.2"
+      }
+    },
+    "node_modules/marked": {
+      "version": "14.0.0",
+      "resolved": "https://registry.npmjs.org/marked/-/marked-14.0.0.tgz",
+      "integrity": "sha512-uIj4+faQ+MgHgwUW1l2PsPglZLOLOT1uErt06dAPtx2kjteLAkbsd/0FiYg/MGS+i7ZKLb7w2WClxHkzOOuryQ==",
+      "license": "MIT",
+      "bin": {
+        "marked": "bin/marked.js"
+      },
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/monaco-editor": {
+      "version": "0.55.1",
+      "resolved": "https://registry.npmjs.org/monaco-editor/-/monaco-editor-0.55.1.tgz",
+      "integrity": "sha512-jz4x+TJNFHwHtwuV9vA9rMujcZRb0CEilTEwG2rRSpe/A7Jdkuj8xPKttCgOh+v/lkHy7HsZ64oj+q3xoAFl9A==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "dompurify": "3.2.7",
+        "marked": "14.0.0"
+      }
+    },
+    "node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/nanoid": {
+      "version": "5.1.9",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-5.1.9.tgz",
+      "integrity": "sha512-ZUvP7KeBLe3OZ1ypw6dI/TzYJuvHP77IM4Ry73waSQTLn8/g8rpdjfyVAh7t1/+FjBtG4lCP42MEbDxOsRpBMw==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "bin": {
+        "nanoid": "bin/nanoid.js"
+      },
+      "engines": {
+        "node": "^18 || >=20"
+      }
+    },
+    "node_modules/node-releases": {
+      "version": "2.0.38",
+      "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.38.tgz",
+      "integrity": "sha512-3qT/88Y3FbH/Kx4szpQQ4HzUbVrHPKTLVpVocKiLfoYvw9XSGOX2FmD2d6DrXbVYyAQTF2HeF6My8jmzx7/CRw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/picocolors": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/picomatch": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz",
+      "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/postcss": {
+      "version": "8.5.10",
+      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.10.tgz",
+      "integrity": "sha512-pMMHxBOZKFU6HgAZ4eyGnwXF/EvPGGqUr0MnZ5+99485wwW41kW91A4LOGxSHhgugZmSChL5AlElNdwlNgcnLQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/postcss/"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/postcss"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "nanoid": "^3.3.11",
+        "picocolors": "^1.1.1",
+        "source-map-js": "^1.2.1"
+      },
+      "engines": {
+        "node": "^10 || ^12 || >=14"
+      }
+    },
+    "node_modules/postcss/node_modules/nanoid": {
+      "version": "3.3.11",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
+      "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "bin": {
+        "nanoid": "bin/nanoid.cjs"
+      },
+      "engines": {
+        "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+      }
+    },
+    "node_modules/react": {
+      "version": "18.3.1",
+      "resolved": "https://registry.npmjs.org/react/-/react-18.3.1.tgz",
+      "integrity": "sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "loose-envify": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/react-dom": {
+      "version": "18.3.1",
+      "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-18.3.1.tgz",
+      "integrity": "sha512-5m4nQKp+rZRb09LNH59GM4BxTh9251/ylbKIbpe7TpGxfJ+9kv6BLkLBXIjjspbgbnIBNqlI23tRnTWT0snUIw==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "loose-envify": "^1.1.0",
+        "scheduler": "^0.23.2"
+      },
+      "peerDependencies": {
+        "react": "^18.3.1"
+      }
+    },
+    "node_modules/react-refresh": {
+      "version": "0.17.0",
+      "resolved": "https://registry.npmjs.org/react-refresh/-/react-refresh-0.17.0.tgz",
+      "integrity": "sha512-z6F7K9bV85EfseRCp2bzrpyQ0Gkw1uLoCel9XBVWPg/TjRj94SkJzUTGfOa4bs7iJvBWtQG0Wq7wnI0syw3EBQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/rollup": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.60.2.tgz",
+      "integrity": "sha512-J9qZyW++QK/09NyN/zeO0dG/1GdGfyp9lV8ajHnRVLfo/uFsbji5mHnDgn/qYdUHyCkM2N+8VyspgZclfAh0eQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/estree": "1.0.8"
+      },
+      "bin": {
+        "rollup": "dist/bin/rollup"
+      },
+      "engines": {
+        "node": ">=18.0.0",
+        "npm": ">=8.0.0"
+      },
+      "optionalDependencies": {
+        "@rollup/rollup-android-arm-eabi": "4.60.2",
+        "@rollup/rollup-android-arm64": "4.60.2",
+        "@rollup/rollup-darwin-arm64": "4.60.2",
+        "@rollup/rollup-darwin-x64": "4.60.2",
+        "@rollup/rollup-freebsd-arm64": "4.60.2",
+        "@rollup/rollup-freebsd-x64": "4.60.2",
+        "@rollup/rollup-linux-arm-gnueabihf": "4.60.2",
+        "@rollup/rollup-linux-arm-musleabihf": "4.60.2",
+        "@rollup/rollup-linux-arm64-gnu": "4.60.2",
+        "@rollup/rollup-linux-arm64-musl": "4.60.2",
+        "@rollup/rollup-linux-loong64-gnu": "4.60.2",
+        "@rollup/rollup-linux-loong64-musl": "4.60.2",
+        "@rollup/rollup-linux-ppc64-gnu": "4.60.2",
+        "@rollup/rollup-linux-ppc64-musl": "4.60.2",
+        "@rollup/rollup-linux-riscv64-gnu": "4.60.2",
+        "@rollup/rollup-linux-riscv64-musl": "4.60.2",
+        "@rollup/rollup-linux-s390x-gnu": "4.60.2",
+        "@rollup/rollup-linux-x64-gnu": "4.60.2",
+        "@rollup/rollup-linux-x64-musl": "4.60.2",
+        "@rollup/rollup-openbsd-x64": "4.60.2",
+        "@rollup/rollup-openharmony-arm64": "4.60.2",
+        "@rollup/rollup-win32-arm64-msvc": "4.60.2",
+        "@rollup/rollup-win32-ia32-msvc": "4.60.2",
+        "@rollup/rollup-win32-x64-gnu": "4.60.2",
+        "@rollup/rollup-win32-x64-msvc": "4.60.2",
+        "fsevents": "~2.3.2"
+      }
+    },
+    "node_modules/scheduler": {
+      "version": "0.23.2",
+      "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.23.2.tgz",
+      "integrity": "sha512-UOShsPwz7NrMUqhR6t0hWjFduvOzbtv7toDH1/hIrfRNIDBnnBWd0CwJTGvTpngVlmwGCdP9/Zl/tVrDqcuYzQ==",
+      "license": "MIT",
+      "dependencies": {
+        "loose-envify": "^1.1.0"
+      }
+    },
+    "node_modules/semver": {
+      "version": "6.3.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      }
+    },
+    "node_modules/source-map-js": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/state-local": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/state-local/-/state-local-1.0.7.tgz",
+      "integrity": "sha512-HTEHMNieakEnoe33shBYcZ7NX83ACUjCu8c40iOGEZsngj9zRnkqS9j1pqQPXwobB0ZcVTk27REb7COQ0UR59w==",
+      "license": "MIT"
+    },
+    "node_modules/string-width": {
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "emoji-regex": "^8.0.0",
+        "is-fullwidth-code-point": "^3.0.0",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-ansi": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/swr": {
+      "version": "2.4.1",
+      "resolved": "https://registry.npmjs.org/swr/-/swr-2.4.1.tgz",
+      "integrity": "sha512-2CC6CiKQtEwaEeNiqWTAw9PGykW8SR5zZX8MZk6TeAvEAnVS7Visz8WzphqgtQ8v2xz/4Q5K+j+SeMaKXeeQIA==",
+      "license": "MIT",
+      "dependencies": {
+        "dequal": "^2.0.3",
+        "use-sync-external-store": "^1.6.0"
+      },
+      "peerDependencies": {
+        "react": "^16.11.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+      }
+    },
+    "node_modules/throttleit": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/throttleit/-/throttleit-2.1.0.tgz",
+      "integrity": "sha512-nt6AMGKW1p/70DF/hGBdJB57B8Tspmbp5gfJ8ilhLnt7kkr2ye7hzD6NVG8GGErk2HWF34igrL2CXmNIkzKqKw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/tinyglobby": {
+      "version": "0.2.16",
+      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.16.tgz",
+      "integrity": "sha512-pn99VhoACYR8nFHhxqix+uvsbXineAasWm5ojXoN8xEwK5Kd3/TrhNn1wByuD52UxWRLy8pu+kRMniEi6Eq9Zg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.4"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/SuperchupuDev"
+      }
+    },
+    "node_modules/typescript": {
+      "version": "5.9.3",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
+      "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "bin": {
+        "tsc": "bin/tsc",
+        "tsserver": "bin/tsserver"
+      },
+      "engines": {
+        "node": ">=14.17"
+      }
+    },
+    "node_modules/update-browserslist-db": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.2.3.tgz",
+      "integrity": "sha512-Js0m9cx+qOgDxo0eMiFGEueWztz+d4+M3rGlmKPT+T4IS/jP4ylw3Nwpu6cpTTP8R1MAC1kF4VbdLt3ARf209w==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/browserslist"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "escalade": "^3.2.0",
+        "picocolors": "^1.1.1"
+      },
+      "bin": {
+        "update-browserslist-db": "cli.js"
+      },
+      "peerDependencies": {
+        "browserslist": ">= 4.21.0"
+      }
+    },
+    "node_modules/use-sync-external-store": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/use-sync-external-store/-/use-sync-external-store-1.6.0.tgz",
+      "integrity": "sha512-Pp6GSwGP/NrPIrxVFAIkOQeyw8lFenOHijQWkUTrDvrF4ALqylP2C/KCkeS9dpUM3KvYRQhna5vt7IL95+ZQ9w==",
+      "license": "MIT",
+      "peerDependencies": {
+        "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+      }
+    },
+    "node_modules/vite": {
+      "version": "6.4.2",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-6.4.2.tgz",
+      "integrity": "sha512-2N/55r4JDJ4gdrCvGgINMy+HH3iRpNIz8K6SFwVsA+JbQScLiC+clmAxBgwiSPgcG9U15QmvqCGWzMbqda5zGQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "esbuild": "^0.25.0",
+        "fdir": "^6.4.4",
+        "picomatch": "^4.0.2",
+        "postcss": "^8.5.3",
+        "rollup": "^4.34.9",
+        "tinyglobby": "^0.2.13"
+      },
+      "bin": {
+        "vite": "bin/vite.js"
+      },
+      "engines": {
+        "node": "^18.0.0 || ^20.0.0 || >=22.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/vitejs/vite?sponsor=1"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      },
+      "peerDependencies": {
+        "@types/node": "^18.0.0 || ^20.0.0 || >=22.0.0",
+        "jiti": ">=1.21.0",
+        "less": "*",
+        "lightningcss": "^1.21.0",
+        "sass": "*",
+        "sass-embedded": "*",
+        "stylus": "*",
+        "sugarss": "*",
+        "terser": "^5.16.0",
+        "tsx": "^4.8.1",
+        "yaml": "^2.4.2"
+      },
+      "peerDependenciesMeta": {
+        "@types/node": {
+          "optional": true
+        },
+        "jiti": {
+          "optional": true
+        },
+        "less": {
+          "optional": true
+        },
+        "lightningcss": {
+          "optional": true
+        },
+        "sass": {
+          "optional": true
+        },
+        "sass-embedded": {
+          "optional": true
+        },
+        "stylus": {
+          "optional": true
+        },
+        "sugarss": {
+          "optional": true
+        },
+        "terser": {
+          "optional": true
+        },
+        "tsx": {
+          "optional": true
+        },
+        "yaml": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/yallist": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz",
+      "integrity": "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/zod": {
+      "version": "4.3.6",
+      "resolved": "https://registry.npmjs.org/zod/-/zod-4.3.6.tgz",
+      "integrity": "sha512-rftlrkhHZOcjDwkGlnUtZZkvaPHCsDATp4pGpuOOMDaTdDDXF91wuVDJoWoPsKX/3YPQ5fHuF3STjcYyKr+Qhg==",
+      "license": "MIT",
+      "peer": true,
+      "funding": {
+        "url": "https://github.com/sponsors/colinhacks"
+      }
+    }
+  }
+}

frontend/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "reachy-mini-vibe-coder-frontend",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "preview": "vite preview",
+    "typecheck": "tsc -b --noEmit"
+  },
+  "dependencies": {
+    "@ai-sdk/react": "^3.0.160",
+    "@huggingface/hub": "^2.11.0",
+    "@monaco-editor/react": "^4.7.0",
+    "ai": "^6.0.158",
+    "clsx": "^2.1.1",
+    "nanoid": "^5.0.7",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "@vitejs/plugin-react": "^4.3.4",
+    "typescript": "^5.6.0",
+    "vite": "^6.0.0"
+  }
+}

frontend/src/App.tsx

@@ -0,0 +1,164 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+import { useHfAuth } from "./hooks/useHfAuth";
+import { useVirtualFS } from "./hooks/useVirtualFS";
+import { useAgentChat } from "./hooks/useAgentChat";
+import { SignInScreen } from "./components/SignInScreen";
+import { TopBar } from "./components/TopBar";
+import { ChatPanel } from "./components/ChatPanel";
+import { CodeEditor } from "./components/CodeEditor";
+import { PreviewFrame } from "./components/PreviewFrame";
+import { PublishDialog } from "./components/PublishDialog";
+
+interface Model {
+  id: string;
+  label: string;
+}
+
+type Tab = "code" | "preview";
+
+export function App() {
+  const auth = useHfAuth();
+  const vfs = useVirtualFS();
+
+  const [models, setModels] = useState<Model[]>([]);
+  const [selectedModel, setSelectedModel] = useState<string | null>(null);
+  const modelRef = useRef<string | null>(selectedModel);
+  modelRef.current = selectedModel;
+
+  const [activeTab, setActiveTab] = useState<Tab>("code");
+  const [publishOpen, setPublishOpen] = useState(false);
+
+  const chat = useAgentChat({
+    accessToken: auth.accessToken,
+    vfs,
+    modelRef,
+  });
+
+  useEffect(() => {
+    if (!auth.isSignedIn || !auth.accessToken) return;
+    let cancelled = false;
+    fetch("/api/models", {
+      headers: { Authorization: `Bearer ${auth.accessToken}` },
+    })
+      .then((r) => (r.ok ? r.json() : null))
+      .then((data) => {
+        if (cancelled || !data) return;
+        setModels(data.models ?? []);
+        if (data.default && !selectedModel) setSelectedModel(data.default);
+      })
+      .catch(() => {});
+    return () => {
+      cancelled = true;
+    };
+  }, [auth.isSignedIn, auth.accessToken, selectedModel]);
+
+  const handleReset = useCallback(() => {
+    if (
+      !confirm(
+        "Clear the chat history and all files in the virtual FS? This cannot be undone.",
+      )
+    ) {
+      return;
+    }
+    chat.clearMessages();
+    vfs.clear();
+  }, [chat, vfs]);
+
+  const handleFileChange = useCallback(
+    (path: string, content: string) => {
+      vfs.writeFile(path, content);
+    },
+    [vfs],
+  );
+
+  if (!auth.isReady) {
+    return (
+      <div className="app-shell">
+        <div style={{ margin: "auto", color: "var(--text-faint)" }}>
+          Loading…
+        </div>
+      </div>
+    );
+  }
+
+  if (!auth.isSignedIn) {
+    return (
+      <div className="app-shell">
+        <SignInScreen
+          onSignIn={auth.signIn}
+          isSigningIn={auth.isSigningIn}
+          error={auth.error}
+          hasClientId={!!auth.clientId}
+        />
+      </div>
+    );
+  }
+
+  const canPublish = vfs.files.length > 0;
+
+  return (
+    <div className="app-shell">
+      <TopBar
+        user={auth.user}
+        models={models}
+        selectedModel={selectedModel}
+        onModelChange={setSelectedModel}
+        onPublish={() => setPublishOpen(true)}
+        onSignOut={auth.signOut}
+        onReset={handleReset}
+        canPublish={canPublish}
+      />
+
+      <div className="app-main">
+        <ChatPanel
+          messages={chat.messages}
+          isLoading={chat.isLoading}
+          input={chat.input}
+          setInput={chat.setInput}
+          onSend={chat.sendMessage}
+          onStop={chat.stop}
+          error={chat.error ?? null}
+        />
+
+        <div className="right-pane">
+          <div className="tab-bar">
+            <button
+              type="button"
+              className={`tab ${activeTab === "code" ? "active" : ""}`}
+              onClick={() => setActiveTab("code")}
+            >
+              Code · {vfs.files.length}
+            </button>
+            <button
+              type="button"
+              className={`tab ${activeTab === "preview" ? "active" : ""}`}
+              onClick={() => setActiveTab("preview")}
+            >
+              Preview
+            </button>
+            <div className="tab-spacer" />
+          </div>
+
+          <div
+            className={`pane-content ${activeTab === "code" ? "" : "hidden"}`}
+          >
+            <CodeEditor files={vfs.files} onChange={handleFileChange} />
+          </div>
+          <div
+            className={`pane-content ${activeTab === "preview" ? "" : "hidden"}`}
+          >
+            <PreviewFrame files={vfs.files} version={vfs.version} />
+          </div>
+        </div>
+      </div>
+
+      <PublishDialog
+        open={publishOpen}
+        onClose={() => setPublishOpen(false)}
+        files={vfs.files}
+        accessToken={auth.accessToken}
+        defaultUsername={auth.user?.preferred_username ?? null}
+      />
+    </div>
+  );
+}

frontend/src/components/ChatPanel.tsx

@@ -0,0 +1,219 @@
+import type { UIMessage } from "ai";
+import { useEffect, useRef } from "react";
+
+interface ChatPanelProps {
+  messages: UIMessage[];
+  isLoading: boolean;
+  input: string;
+  setInput: (v: string) => void;
+  onSend: (text: string) => void;
+  onStop: () => void;
+  error: Error | null;
+}
+
+const EXAMPLE_PROMPTS = [
+  "Create a minimal Reachy Mini voice app that just connects to OpenAI Realtime and lets me talk.",
+  "Add a head-wobbler motion agent that reacts to the AI voice's RMS level.",
+  "Add a play_dance tool call that streams a procedural happy dance to the robot.",
+];
+
+function renderMessagePart(
+  part: UIMessage["parts"][number],
+  idx: number,
+): React.ReactNode {
+  const type = part.type;
+
+  if (type === "text") {
+    const text = (part as { text: string }).text;
+    if (!text.trim()) return null;
+    return (
+      <div key={idx} className="bubble-agent-text">
+        {text}
+      </div>
+    );
+  }
+
+  if (typeof type === "string" && type.startsWith("tool-")) {
+    const toolPart = part as {
+      type: string;
+      state?: string;
+      input?: Record<string, unknown>;
+      output?: unknown;
+      errorText?: string;
+    };
+    const toolName = type.slice("tool-".length);
+    const state = toolPart.state ?? "unknown";
+    const statusClass =
+      state === "output-available" || state === "result"
+        ? "status-done"
+        : state === "output-error" || state === "error"
+          ? "status-error"
+          : "";
+
+    let detail = "";
+    if (toolPart.input) {
+      const input = toolPart.input;
+      if (toolName === "write_file" && typeof input.path === "string") {
+        detail = `${input.path}${typeof input.content === "string" ? ` · ${input.content.length} chars` : ""}`;
+      } else if (toolName === "edit_file" && typeof input.path === "string") {
+        detail = String(input.path);
+      } else if (
+        (toolName === "read_file" ||
+          toolName === "delete_file") &&
+        typeof input.path === "string"
+      ) {
+        detail = String(input.path);
+      } else if (toolName === "read_skill_doc" && typeof input.topic === "string") {
+        detail = String(input.topic);
+      }
+    }
+
+    return (
+      <div key={idx} className={`bubble-tool ${statusClass}`}>
+        <div className="bubble-tool-header">
+          <span className="dot" />
+          <span>{toolLabel(toolName)}</span>
+          {detail && <span className="mono" style={{ color: "var(--text-faint)" }}>· {detail}</span>}
+        </div>
+        {toolPart.errorText && (
+          <div className="bubble-tool-detail">{toolPart.errorText}</div>
+        )}
+      </div>
+    );
+  }
+
+  return null;
+}
+
+function toolLabel(name: string): string {
+  const map: Record<string, string> = {
+    write_file: "Writing file",
+    edit_file: "Editing file",
+    delete_file: "Deleting file",
+    read_file: "Reading file",
+    list_files: "Listing files",
+    read_skill_doc: "Loading skill chapter",
+  };
+  return map[name] ?? name;
+}
+
+export function ChatPanel({
+  messages,
+  isLoading,
+  input,
+  setInput,
+  onSend,
+  onStop,
+  error,
+}: ChatPanelProps) {
+  const scrollRef = useRef<HTMLDivElement>(null);
+  const textareaRef = useRef<HTMLTextAreaElement>(null);
+
+  useEffect(() => {
+    scrollRef.current?.scrollTo({ top: scrollRef.current.scrollHeight });
+  }, [messages]);
+
+  const handleSubmit = (e?: React.FormEvent) => {
+    e?.preventDefault();
+    if (isLoading) {
+      onStop();
+      return;
+    }
+    const text = input.trim();
+    if (!text) return;
+    onSend(text);
+  };
+
+  const handleKeyDown = (e: React.KeyboardEvent<HTMLTextAreaElement>) => {
+    if (e.key === "Enter" && !e.shiftKey) {
+      e.preventDefault();
+      handleSubmit();
+    }
+  };
+
+  const showEmpty = messages.length === 0;
+
+  return (
+    <aside className="chat-panel">
+      <div className="chat-messages" ref={scrollRef}>
+        {showEmpty && (
+          <div className="chat-empty">
+            <p>
+              Describe the Reachy Mini voice app you want to build. The agent
+              knows the full <code>build-reachy-voice-app</code> skill (WebRTC
+              2-hop, OpenAI Realtime, motion agents, HF deployment) and will
+              create the files in the virtual FS on the right.
+            </p>
+            <div className="chat-empty-examples">
+              {EXAMPLE_PROMPTS.map((p) => (
+                <button
+                  key={p}
+                  type="button"
+                  className="chat-empty-example"
+                  onClick={() => setInput(p)}
+                >
+                  {p}
+                </button>
+              ))}
+            </div>
+          </div>
+        )}
+
+        {messages.map((m) =>
+          m.role === "user" ? (
+            <div key={m.id} className="bubble-user">
+              {m.parts
+                .map((p) => ((p as { type: string }).type === "text" ? (p as { text: string }).text : ""))
+                .join("")}
+            </div>
+          ) : (
+            <div key={m.id} className="bubble-agent">
+              {m.parts.map((p, i) => renderMessagePart(p, i))}
+            </div>
+          ),
+        )}
+
+        {error && (
+          <div className="signin-error" style={{ alignSelf: "stretch" }}>
+            {error.message}
+          </div>
+        )}
+      </div>
+
+      <form className="chat-composer" onSubmit={handleSubmit}>
+        <div className="chat-composer-field">
+          <textarea
+            ref={textareaRef}
+            value={input}
+            onChange={(e) => setInput(e.target.value)}
+            onKeyDown={handleKeyDown}
+            placeholder={
+              isLoading
+                ? "Agent is working…"
+                : "Describe what to build or change…"
+            }
+            rows={1}
+          />
+          <button
+            type="submit"
+            className="chat-send"
+            disabled={!isLoading && input.trim().length === 0}
+            title={isLoading ? "Stop" : "Send"}
+          >
+            {isLoading ? "■" : "↑"}
+          </button>
+        </div>
+        <div className="chat-status">
+          {isLoading ? (
+            <>
+              <span className="spinner" />
+              <span>Agent is thinking…</span>
+            </>
+          ) : (
+            <span>Enter to send · Shift+Enter for newline</span>
+          )}
+        </div>
+      </form>
+    </aside>
+  );
+}

frontend/src/components/CodeEditor.tsx

@@ -0,0 +1,113 @@
+import Editor from "@monaco-editor/react";
+import { useEffect, useMemo, useState } from "react";
+import type { VirtualFile } from "../hooks/useVirtualFS";
+
+interface CodeEditorProps {
+  files: VirtualFile[];
+  onChange: (path: string, content: string) => void;
+}
+
+function guessLanguage(path: string): string {
+  const ext = path.split(".").pop()?.toLowerCase() ?? "";
+  switch (ext) {
+    case "ts":
+    case "tsx":
+      return "typescript";
+    case "js":
+    case "jsx":
+      return "javascript";
+    case "html":
+      return "html";
+    case "css":
+      return "css";
+    case "json":
+      return "json";
+    case "md":
+      return "markdown";
+    case "yml":
+    case "yaml":
+      return "yaml";
+    case "sh":
+      return "shell";
+    default:
+      return "plaintext";
+  }
+}
+
+export function CodeEditor({ files, onChange }: CodeEditorProps) {
+  const [activePath, setActivePath] = useState<string | null>(null);
+
+  useEffect(() => {
+    if (!activePath && files.length > 0) {
+      const preferred = files.find(
+        (f) => f.path === "index.html" || f.path === "src/main.ts",
+      );
+      setActivePath(preferred?.path ?? files[0].path);
+      return;
+    }
+    if (activePath && !files.some((f) => f.path === activePath)) {
+      setActivePath(files[0]?.path ?? null);
+    }
+  }, [files, activePath]);
+
+  const activeFile = useMemo(
+    () => files.find((f) => f.path === activePath) ?? null,
+    [files, activePath],
+  );
+
+  if (files.length === 0) {
+    return (
+      <div className="code-layout">
+        <div className="file-tree">
+          <div className="file-tree-empty">No files yet.</div>
+        </div>
+        <div className="editor-area">
+          <div className="editor-placeholder">
+            The agent will write files here. Ask it to create an app.
+          </div>
+        </div>
+      </div>
+    );
+  }
+
+  return (
+    <div className="code-layout">
+      <div className="file-tree">
+        {files.map((f) => (
+          <div
+            key={f.path}
+            className={`file-tree-item ${activePath === f.path ? "active" : ""}`}
+            onClick={() => setActivePath(f.path)}
+          >
+            <span>{f.path}</span>
+            <span className="file-tree-size">{f.content.length}B</span>
+          </div>
+        ))}
+      </div>
+      <div className="editor-area">
+        {activeFile ? (
+          <Editor
+            key={activeFile.path}
+            height="100%"
+            theme="vs-dark"
+            language={guessLanguage(activeFile.path)}
+            value={activeFile.content}
+            onChange={(v) => onChange(activeFile.path, v ?? "")}
+            options={{
+              fontSize: 12,
+              fontFamily:
+                '"JetBrains Mono", ui-monospace, SFMono-Regular, Menlo, monospace',
+              minimap: { enabled: false },
+              scrollBeyondLastLine: false,
+              tabSize: 2,
+              wordWrap: "on",
+              automaticLayout: true,
+            }}
+          />
+        ) : (
+          <div className="editor-placeholder">Select a file from the tree.</div>
+        )}
+      </div>
+    </div>
+  );
+}

frontend/src/components/HfLogo.tsx

@@ -0,0 +1,31 @@
+/**
+ * The official Hugging Face emoji logo. Drop-in SVG; the container controls the
+ * size via font-size or an explicit width/height prop.
+ */
+export function HfLogo({ size = 20 }: { size?: number }) {
+  return (
+    <svg
+      viewBox="0 0 96 96"
+      width={size}
+      height={size}
+      aria-hidden="true"
+      style={{ display: "inline-block" }}
+    >
+      <defs>
+        <radialGradient id="hf-face" cx="0.5" cy="0.5" r="0.5">
+          <stop offset="0%" stopColor="#FFD21E" />
+          <stop offset="100%" stopColor="#FFAC03" />
+        </radialGradient>
+      </defs>
+      <circle cx="48" cy="48" r="44" fill="url(#hf-face)" stroke="#1A1A1A" strokeWidth="4" />
+      <circle cx="32" cy="42" r="6" fill="#1A1A1A" />
+      <circle cx="64" cy="42" r="6" fill="#1A1A1A" />
+      <path
+        d="M30 60 Q48 76 66 60 Q66 70 48 72 Q30 70 30 60 Z"
+        fill="#1A1A1A"
+      />
+      <circle cx="22" cy="56" r="5" fill="#FF7979" opacity="0.8" />
+      <circle cx="74" cy="56" r="5" fill="#FF7979" opacity="0.8" />
+    </svg>
+  );
+}

frontend/src/components/PreviewFrame.tsx

@@ -0,0 +1,104 @@
+import { useEffect, useMemo, useRef, useState } from "react";
+import type { VirtualFile } from "../hooks/useVirtualFS";
+
+interface PreviewFrameProps {
+  files: VirtualFile[];
+  version: number;
+}
+
+/**
+ * Render the virtual FS inside a sandboxed iframe.
+ *
+ * Strategy: we build a single HTML document by taking `index.html` from the
+ * virtual FS and inlining every other text asset (CSS + JS/TS). This is
+ * deliberately simple and works for the kind of minimal Vite apps the agent
+ * produces.
+ *
+ * Notes / limitations:
+ * - `.ts` files are shipped as `type="module"` with an esbuild-free path:
+ *   they run in the iframe as-is, so only ES2022-compatible TS (= "TypeScript
+ *   lite") works. Real Vite builds are what we ship to HF Spaces.
+ * - WebRTC/OpenAI calls will fail in the preview sandbox because of CORS and
+ *   missing OAuth. The preview is there to catch JS errors and see the UI.
+ * - We strip the `<script type="module" src="/src/main.ts">` tag when the
+ *   corresponding file is inlined just above it.
+ */
+function buildPreviewDoc(files: VirtualFile[]): string | null {
+  const fileMap = new Map(files.map((f) => [f.path, f.content]));
+
+  const rawHtml = fileMap.get("index.html");
+  if (!rawHtml) return null;
+
+  // Inline every local text asset referenced through href="/..." or src="/..."
+  const inlineAsset = (_match: string, attr: string, _q: string, path: string): string => {
+    const normalized = path.replace(/^\//, "");
+    const content = fileMap.get(normalized);
+    if (content === undefined) return _match;
+
+    if (attr === "href" && normalized.endsWith(".css")) {
+      return `<style data-inlined="${normalized}">\n${content}\n</style>`;
+    }
+    if (
+      attr === "src" &&
+      (normalized.endsWith(".js") ||
+        normalized.endsWith(".mjs") ||
+        normalized.endsWith(".ts") ||
+        normalized.endsWith(".tsx"))
+    ) {
+      return `<script type="module" data-inlined="${normalized}">\n${content}\n</script>`;
+    }
+    return _match;
+  };
+
+  const inlined = rawHtml.replace(
+    /<(?:link|script)[^>]*\b(href|src)\s*=\s*(["'])(\/[^"']+)\2[^>]*>(?:<\/script>)?/gi,
+    inlineAsset,
+  );
+
+  const bannerDoc = `<!-- Preview generated by reachy-mini-vibe-coder -->`;
+  return `${bannerDoc}\n${inlined}`;
+}
+
+export function PreviewFrame({ files, version }: PreviewFrameProps) {
+  const [docHtml, setDocHtml] = useState<string | null>(null);
+  const timerRef = useRef<number | null>(null);
+
+  const hasIndex = useMemo(
+    () => files.some((f) => f.path === "index.html"),
+    [files],
+  );
+
+  useEffect(() => {
+    if (timerRef.current) window.clearTimeout(timerRef.current);
+    timerRef.current = window.setTimeout(() => {
+      const doc = buildPreviewDoc(files);
+      setDocHtml(doc);
+    }, 300);
+    return () => {
+      if (timerRef.current) window.clearTimeout(timerRef.current);
+    };
+  }, [files, version]);
+
+  if (!hasIndex) {
+    return (
+      <div className="preview-empty">
+        <p>No <code>index.html</code> in the virtual FS yet.</p>
+        <p style={{ marginTop: 8 }}>Ask the agent to create one.</p>
+      </div>
+    );
+  }
+
+  if (docHtml === null) {
+    return <div className="preview-empty">Building preview…</div>;
+  }
+
+  return (
+    <iframe
+      key={version}
+      className="preview-frame"
+      title="App preview"
+      srcDoc={docHtml}
+      sandbox="allow-scripts allow-same-origin allow-forms"
+    />
+  );
+}

frontend/src/components/PublishDialog.tsx

@@ -0,0 +1,209 @@
+import { useEffect, useState } from "react";
+import type { VirtualFile } from "../hooks/useVirtualFS";
+import { usePublish } from "../hooks/usePublish";
+
+interface PublishDialogProps {
+  open: boolean;
+  onClose: () => void;
+  files: VirtualFile[];
+  accessToken: string | null;
+  defaultUsername: string | null;
+}
+
+function suggestRepoName(username: string | null): string {
+  const stamp = new Date()
+    .toISOString()
+    .slice(0, 10)
+    .replace(/-/g, "");
+  return `reachy-voice-${stamp}`;
+}
+
+export function PublishDialog({
+  open,
+  onClose,
+  files,
+  accessToken,
+  defaultUsername,
+}: PublishDialogProps) {
+  const { status, steps, result, error, errorCode, publish, reset } =
+    usePublish(accessToken);
+
+  const [repoName, setRepoName] = useState("");
+  const [isPrivate, setIsPrivate] = useState(false);
+  const [overwrite, setOverwrite] = useState(false);
+  const [commitMessage, setCommitMessage] = useState("");
+
+  useEffect(() => {
+    if (open) {
+      setRepoName((prev) => prev || suggestRepoName(defaultUsername));
+      if (status !== "idle") reset();
+    }
+  }, [open, defaultUsername, reset, status]);
+
+  if (!open) return null;
+
+  const handlePublish = () => {
+    if (status === "publishing") return;
+    publish({
+      repoName,
+      isPrivate,
+      overwrite,
+      commitMessage: commitMessage.trim() || undefined,
+      files,
+    });
+  };
+
+  const handleClose = () => {
+    if (status === "publishing") return;
+    reset();
+    onClose();
+  };
+
+  return (
+    <div className="dialog-backdrop" onClick={handleClose}>
+      <div className="dialog" onClick={(e) => e.stopPropagation()}>
+        <header className="dialog-header">
+          <span>Publish to Hugging Face Space</span>
+          <button
+            type="button"
+            className="btn-ghost"
+            onClick={handleClose}
+            disabled={status === "publishing"}
+            style={{ padding: "4px 8px" }}
+          >
+            ✕
+          </button>
+        </header>
+
+        <div className="dialog-body">
+          <div className="field">
+            <label>Space name</label>
+            <input
+              type="text"
+              value={repoName}
+              onChange={(e) => setRepoName(e.target.value)}
+              placeholder="my-reachy-app"
+              disabled={status === "publishing"}
+            />
+            {defaultUsername && (
+              <div className="field-hint">
+                Will be published as <code>{defaultUsername}/{repoName || "<name>"}</code>
+              </div>
+            )}
+          </div>
+
+          <div className="field">
+            <label>Commit message (optional)</label>
+            <input
+              type="text"
+              value={commitMessage}
+              onChange={(e) => setCommitMessage(e.target.value)}
+              placeholder="Initial commit from Reachy Vibe Coder"
+              disabled={status === "publishing"}
+            />
+          </div>
+
+          <div className="field-row">
+            <input
+              id="publish-private"
+              type="checkbox"
+              checked={isPrivate}
+              onChange={(e) => setIsPrivate(e.target.checked)}
+              disabled={status === "publishing"}
+            />
+            <label htmlFor="publish-private" style={{ cursor: "pointer" }}>
+              Make Space private
+            </label>
+          </div>
+
+          <div className="field-row">
+            <input
+              id="publish-overwrite"
+              type="checkbox"
+              checked={overwrite}
+              onChange={(e) => setOverwrite(e.target.checked)}
+              disabled={status === "publishing"}
+            />
+            <label htmlFor="publish-overwrite" style={{ cursor: "pointer" }}>
+              Overwrite if Space already exists
+            </label>
+          </div>
+
+          <div className="field">
+            <label>Files to upload ({files.length})</label>
+            <div className="publish-log">
+              {files.map((f) => (
+                <div key={f.path} className="publish-log-step">
+                  {f.path} <span style={{ color: "var(--text-faint)" }}>· {f.content.length}B</span>
+                </div>
+              ))}
+            </div>
+          </div>
+
+          {steps.length > 0 && (
+            <div className="field">
+              <label>Progress</label>
+              <div className="publish-log">
+                {steps.map((s, i) => (
+                  <div
+                    key={i}
+                    className={`publish-log-step ${s.step === "done" ? "done" : ""}`}
+                  >
+                    [{s.step}] {s.message}
+                  </div>
+                ))}
+              </div>
+            </div>
+          )}
+
+          {status === "done" && result.spaceUrl && (
+            <div className="publish-success">
+              <div>✓ Published!</div>
+              <div>
+                <a href={result.spaceUrl} target="_blank" rel="noopener">
+                  {result.spaceUrl}
+                </a>
+              </div>
+            </div>
+          )}
+
+          {status === "error" && error && (
+            <div className="publish-error">
+              {error}
+              {errorCode === "REPO_EXISTS" && (
+                <div style={{ marginTop: 6 }}>
+                  Enable "Overwrite if Space already exists" and try again.
+                </div>
+              )}
+            </div>
+          )}
+        </div>
+
+        <footer className="dialog-footer">
+          <button
+            type="button"
+            className="btn btn-ghost"
+            onClick={handleClose}
+            disabled={status === "publishing"}
+          >
+            {status === "done" ? "Close" : "Cancel"}
+          </button>
+          {status !== "done" && (
+            <button
+              type="button"
+              className="btn btn-primary"
+              onClick={handlePublish}
+              disabled={
+                status === "publishing" ||
+                repoName.trim().length === 0 ||
+                files.length === 0
+              }
+            >
+              {status === "publishing" ? "Publishing…" : "Publish"}
+            </button>
+          )}
+        </footer>
+      </div>
+    </div>
+  );
+}

frontend/src/components/SignInScreen.tsx

@@ -0,0 +1,47 @@
+import { HfLogo } from "./HfLogo";
+
+interface SignInScreenProps {
+  onSignIn: () => void;
+  isSigningIn: boolean;
+  error: string | null;
+  hasClientId: boolean;
+}
+
+export function SignInScreen({
+  onSignIn,
+  isSigningIn,
+  error,
+  hasClientId,
+}: SignInScreenProps) {
+  return (
+    <div className="signin-screen">
+      <div className="signin-emoji">🤖</div>
+      <h1 className="signin-title">Reachy Mini · Vibe Coder</h1>
+      <p className="signin-subtitle">
+        Sign in with your Hugging Face account to start vibe-coding browser-based
+        voice apps for Reachy Mini. You'll be able to preview the app live and
+        publish it as a Hugging Face Space in one click.
+      </p>
+      <button
+        type="button"
+        className="signin-button"
+        onClick={onSignIn}
+        disabled={isSigningIn || !hasClientId}
+      >
+        <HfLogo size={20} />
+        {isSigningIn ? "Redirecting…" : "Sign in with Hugging Face"}
+      </button>
+
+      {!hasClientId && (
+        <p className="signin-hint">
+          No OAuth client ID detected. On a Hugging Face Space this is injected
+          automatically via the Docker entrypoint. For local dev, create an
+          OAuth app and set <code>VITE_HF_OAUTH_CLIENT_ID</code> in{" "}
+          <code>frontend/.env.local</code>.
+        </p>
+      )}
+
+      {error && <div className="signin-error">{error}</div>}
+    </div>
+  );
+}

frontend/src/components/TopBar.tsx

@@ -0,0 +1,94 @@
+import type { OAuthResult } from "@huggingface/hub";
+import { HfLogo } from "./HfLogo";
+
+interface Model {
+  id: string;
+  label: string;
+}
+
+interface TopBarProps {
+  user: OAuthResult["userInfo"] | null;
+  models: Model[];
+  selectedModel: string | null;
+  onModelChange: (id: string) => void;
+  onPublish: () => void;
+  onSignOut: () => void;
+  onReset: () => void;
+  canPublish: boolean;
+}
+
+export function TopBar({
+  user,
+  models,
+  selectedModel,
+  onModelChange,
+  onPublish,
+  onSignOut,
+  onReset,
+  canPublish,
+}: TopBarProps) {
+  return (
+    <header className="topbar">
+      <div className="topbar-brand">
+        <HfLogo size={26} />
+        <div className="topbar-title">
+          <span className="topbar-title-main">Reachy Mini · Vibe Coder</span>
+          <span className="topbar-title-sub">Powered by Hugging Face</span>
+        </div>
+      </div>
+
+      <div className="topbar-spacer" />
+
+      {models.length > 0 && (
+        <div className="topbar-model">
+          <span>Model</span>
+          <select
+            value={selectedModel ?? ""}
+            onChange={(e) => onModelChange(e.target.value)}
+          >
+            {models.map((m) => (
+              <option key={m.id} value={m.id}>
+                {m.label}
+              </option>
+            ))}
+          </select>
+        </div>
+      )}
+
+      <button type="button" className="btn btn-ghost" onClick={onReset} title="Reset virtual FS and chat">
+        Reset
+      </button>
+
+      <button
+        type="button"
+        className="btn btn-primary"
+        onClick={onPublish}
+        disabled={!canPublish}
+        title={canPublish ? "Publish to Hugging Face Space" : "Add files before publishing"}
+      >
+        Publish to HF Space
+      </button>
+
+      {user && (
+        <div className="topbar-user" title={user.preferred_username}>
+          {user.picture ? (
+            <img src={user.picture} alt={user.preferred_username} />
+          ) : (
+            <span className="avatar-fallback">
+              {user.preferred_username.slice(0, 1).toUpperCase()}
+            </span>
+          )}
+          <span className="topbar-user-name">{user.preferred_username}</span>
+          <button
+            type="button"
+            className="btn-ghost topbar-user-menu"
+            onClick={onSignOut}
+            title="Sign out"
+          >
+            ✕
+          </button>
+        </div>
+      )}
+    </header>
+  );
+}

frontend/src/hooks/useAgentChat.ts

@@ -0,0 +1,186 @@
+import { useChat } from "@ai-sdk/react";
+import {
+  DefaultChatTransport,
+  lastAssistantMessageIsCompleteWithToolCalls,
+} from "ai";
+import type { UIMessage } from "ai";
+import { useCallback, useMemo, useRef, useState } from "react";
+import type { VirtualFSHandle } from "./useVirtualFS";
+
+const MAX_TOOL_ROUNDS = 12;
+
+interface UseAgentChatOptions {
+  accessToken: string | null;
+  vfs: VirtualFSHandle;
+  modelRef: React.RefObject<string | null>;
+}
+
+interface ToolCall {
+  toolName: string;
+  args: unknown;
+  toolCallId: string;
+  dynamic?: boolean;
+}
+
+function executeEditorToolCall(
+  tc: ToolCall,
+  vfs: VirtualFSHandle,
+): string | { error: string } {
+  const { toolName, args } = tc;
+
+  switch (toolName) {
+    case "write_file": {
+      const { path, content } = args as { path: string; content: string };
+      if (!path) return { error: "Missing `path`" };
+      if (typeof content !== "string") return { error: "Missing `content`" };
+      vfs.writeFile(path, content);
+      return `Wrote ${content.length} chars to ${path}`;
+    }
+
+    case "edit_file": {
+      const { path, old_string, new_string } = args as {
+        path: string;
+        old_string: string;
+        new_string: string;
+      };
+      const res = vfs.editFile(path, old_string, new_string);
+      if (!res.ok) return { error: res.error ?? "Edit failed" };
+      return `Edited ${path}`;
+    }
+
+    case "delete_file": {
+      const { path } = args as { path: string };
+      const res = vfs.deleteFile(path);
+      if (!res.ok) return { error: res.error ?? "Delete failed" };
+      return `Deleted ${path}`;
+    }
+
+    case "read_file": {
+      const { path } = args as { path: string };
+      const file = vfs.readFile(path);
+      if (!file) return { error: `File "${path}" does not exist` };
+      return file.content;
+    }
+
+    case "list_files": {
+      const list = vfs.listFiles();
+      if (list.length === 0) return "(virtual FS is empty)";
+      return list
+        .map((f) => `- ${f.path} (${f.content.length} bytes)`)
+        .join("\n");
+    }
+
+    default:
+      return { error: `Unknown client-side tool: ${toolName}` };
+  }
+}
+
+export function useAgentChat({ accessToken, vfs, modelRef }: UseAgentChatOptions) {
+  const vfsRef = useRef(vfs);
+  vfsRef.current = vfs;
+
+  const [input, setInput] = useState("");
+
+  const transport = useMemo(
+    () =>
+      new DefaultChatTransport({
+        api: "/api/chat",
+        headers: (): Record<string, string> =>
+          accessToken ? { Authorization: `Bearer ${accessToken}` } : {},
+      }),
+    [accessToken],
+  );
+
+  const { addToolResult, ...chat } = useChat({
+    transport,
+    sendAutomaticallyWhen: ({ messages }) => {
+      let toolRounds = 0;
+      for (let i = messages.length - 1; i >= 0; i--) {
+        const m = messages[i];
+        if (m.role !== "assistant") break;
+        const hasToolPart = (m.parts ?? []).some(
+          (p) => typeof p.type === "string" && p.type.startsWith("tool-"),
+        );
+        if (!hasToolPart) break;
+        toolRounds += 1;
+      }
+      if (toolRounds >= MAX_TOOL_ROUNDS) return false;
+      return lastAssistantMessageIsCompleteWithToolCalls({ messages });
+    },
+
+    async onToolCall({ toolCall }) {
+      if (toolCall.dynamic) return;
+
+      // `read_skill_doc` is executed server-side (see backend tools.ts).
+      // Only the editor tools are handled here.
+      const clientSideTools = new Set([
+        "write_file",
+        "edit_file",
+        "delete_file",
+        "read_file",
+        "list_files",
+      ]);
+      if (!clientSideTools.has(toolCall.toolName as string)) return;
+
+      const result = executeEditorToolCall(
+        {
+          toolName: toolCall.toolName as string,
+          args: toolCall.input,
+          toolCallId: toolCall.toolCallId,
+        },
+        vfsRef.current,
+      );
+
+      const output = typeof result === "string" ? result : `ERROR: ${result.error}`;
+
+      (addToolResult as (args: {
+        tool: string;
+        toolCallId: string;
+        output: unknown;
+      }) => void)({
+        tool: toolCall.toolName as string,
+        toolCallId: toolCall.toolCallId,
+        output,
+      });
+    },
+
+    onError(error) {
+      console.error("[agent] chat error:", error);
+    },
+  });
+
+  const sendMessage = useCallback(
+    (text: string) => {
+      const trimmed = text.trim();
+      if (!trimmed) return;
+      const context = {
+        files: vfsRef.current.getAll().map((f) => ({
+          path: f.path,
+          size: f.content.length,
+        })),
+      };
+      chat.sendMessage(
+        { text: trimmed },
+        { body: { context, model: modelRef.current } },
+      );
+      setInput("");
+    },
+    [chat, modelRef],
+  );
+
+  const clearMessages = useCallback(() => {
+    chat.setMessages([]);
+  }, [chat]);
+
+  return {
+    messages: chat.messages as UIMessage[],
+    status: chat.status,
+    isLoading: chat.status === "streaming" || chat.status === "submitted",
+    error: chat.error,
+    stop: chat.stop,
+    sendMessage,
+    clearMessages,
+    input,
+    setInput,
+  };
+}

frontend/src/hooks/useHfAuth.ts

@@ -0,0 +1,142 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+import {
+  oauthHandleRedirectIfPresent,
+  oauthLoginUrl,
+  type OAuthResult,
+} from "@huggingface/hub";
+
+/**
+ * HF OAuth flow, reused from `reachy_mini_minimal_conversation/src/main.ts`.
+ *
+ * - On a Space: the client ID is injected into `window.huggingface.variables`
+ *   by `docker-entrypoint.d/10-inject-hf-vars.sh` at container start.
+ * - Locally: we read it from `VITE_HF_OAUTH_CLIENT_ID` (`.env.local`).
+ */
+
+const STORAGE_KEY = "hf-oauth-result-v1";
+
+function readClientId(): string | null {
+  const injected = window.huggingface?.variables?.OAUTH_CLIENT_ID;
+  if (injected) return injected;
+  return import.meta.env.VITE_HF_OAUTH_CLIENT_ID ?? null;
+}
+
+function readScopes(): string {
+  return (
+    window.huggingface?.variables?.OAUTH_SCOPES ??
+    "openid profile write-repos manage-repos"
+  );
+}
+
+function loadStoredResult(): OAuthResult | null {
+  try {
+    const raw = sessionStorage.getItem(STORAGE_KEY);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw) as OAuthResult;
+    const expiresAt = parsed.accessTokenExpiresAt
+      ? new Date(parsed.accessTokenExpiresAt).getTime()
+      : 0;
+    if (expiresAt && expiresAt < Date.now()) {
+      sessionStorage.removeItem(STORAGE_KEY);
+      return null;
+    }
+    parsed.accessTokenExpiresAt = new Date(parsed.accessTokenExpiresAt);
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+
+function storeResult(result: OAuthResult): void {
+  sessionStorage.setItem(STORAGE_KEY, JSON.stringify(result));
+}
+
+export interface HfAuthState {
+  isReady: boolean;
+  isSignedIn: boolean;
+  isSigningIn: boolean;
+  user: OAuthResult["userInfo"] | null;
+  accessToken: string | null;
+  error: string | null;
+  clientId: string | null;
+  signIn: () => Promise<void>;
+  signOut: () => void;
+}
+
+export function useHfAuth(): HfAuthState {
+  const [result, setResult] = useState<OAuthResult | null>(null);
+  const [isReady, setIsReady] = useState(false);
+  const [isSigningIn, setIsSigningIn] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const clientIdRef = useRef<string | null>(readClientId());
+
+  useEffect(() => {
+    let cancelled = false;
+    (async () => {
+      try {
+        const redirectResult = await oauthHandleRedirectIfPresent();
+        if (cancelled) return;
+        if (redirectResult) {
+          storeResult(redirectResult);
+          setResult(redirectResult);
+          const url = new URL(window.location.href);
+          url.searchParams.delete("code");
+          url.searchParams.delete("state");
+          window.history.replaceState({}, "", url.toString());
+          setIsReady(true);
+          return;
+        }
+        const stored = loadStoredResult();
+        if (stored) setResult(stored);
+        setIsReady(true);
+      } catch (e) {
+        if (cancelled) return;
+        setError(e instanceof Error ? e.message : "OAuth error");
+        setIsReady(true);
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, []);
+
+  const signIn = useCallback(async () => {
+    setError(null);
+    const clientId = clientIdRef.current;
+    if (!clientId) {
+      setError(
+        "No Hugging Face OAuth client ID configured. On a Space this should be auto-injected; locally set VITE_HF_OAUTH_CLIENT_ID in frontend/.env.local.",
+      );
+      return;
+    }
+    setIsSigningIn(true);
+    try {
+      const url = await oauthLoginUrl({
+        clientId,
+        scopes: readScopes(),
+        redirectUrl: window.location.origin + window.location.pathname,
+      });
+      window.location.href = url;
+    } catch (e) {
+      setIsSigningIn(false);
+      setError(e instanceof Error ? e.message : "Failed to start OAuth flow");
+    }
+  }, []);
+
+  const signOut = useCallback(() => {
+    sessionStorage.removeItem(STORAGE_KEY);
+    setResult(null);
+  }, []);
+
+  return {
+    isReady,
+    isSignedIn: !!result?.accessToken,
+    isSigningIn,
+    user: result?.userInfo ?? null,
+    accessToken: result?.accessToken ?? null,
+    error,
+    clientId: clientIdRef.current,
+    signIn,
+    signOut,
+  };
+}

frontend/src/hooks/usePublish.ts

@@ -0,0 +1,155 @@
+import { useCallback, useRef, useState } from "react";
+import type { VirtualFile } from "./useVirtualFS";
+
+export type PublishStatus = "idle" | "publishing" | "done" | "error";
+
+export interface PublishStep {
+  step: string;
+  message: string;
+  timestamp: number;
+}
+
+interface PublishArgs {
+  repoName: string;
+  isPrivate: boolean;
+  overwrite: boolean;
+  files: VirtualFile[];
+  commitMessage?: string;
+}
+
+interface PublishResult {
+  repoId?: string;
+  spaceUrl?: string;
+}
+
+export function usePublish(accessToken: string | null) {
+  const [status, setStatus] = useState<PublishStatus>("idle");
+  const [steps, setSteps] = useState<PublishStep[]>([]);
+  const [result, setResult] = useState<PublishResult>({});
+  const [error, setError] = useState<string | null>(null);
+  const [errorCode, setErrorCode] = useState<string | null>(null);
+  const abortRef = useRef<AbortController | null>(null);
+
+  const reset = useCallback(() => {
+    setStatus("idle");
+    setSteps([]);
+    setResult({});
+    setError(null);
+    setErrorCode(null);
+  }, []);
+
+  const publish = useCallback(
+    async (args: PublishArgs) => {
+      if (!accessToken) {
+        setError("You must sign in with Hugging Face before publishing.");
+        setStatus("error");
+        return;
+      }
+      reset();
+      setStatus("publishing");
+
+      const controller = new AbortController();
+      abortRef.current = controller;
+
+      const pushStep = (step: string, message: string) =>
+        setSteps((prev) => [
+          ...prev,
+          { step, message, timestamp: Date.now() },
+        ]);
+
+      try {
+        const response = await fetch("/api/publish", {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${accessToken}`,
+          },
+          body: JSON.stringify({
+            repoName: args.repoName,
+            private: args.isPrivate,
+            overwrite: args.overwrite,
+            commitMessage: args.commitMessage,
+            files: args.files.map((f) => ({ path: f.path, content: f.content })),
+          }),
+          signal: controller.signal,
+        });
+
+        if (!response.ok || !response.body) {
+          const text = await response.text().catch(() => "");
+          throw new Error(
+            text || `Publish request failed (${response.status})`,
+          );
+        }
+
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+
+        while (true) {
+          const { done, value } = await reader.read();
+          if (done) break;
+          buffer += decoder.decode(value, { stream: true });
+
+          let eventEnd;
+          while ((eventEnd = buffer.indexOf("\n\n")) !== -1) {
+            const raw = buffer.slice(0, eventEnd);
+            buffer = buffer.slice(eventEnd + 2);
+            const lines = raw.split("\n");
+            let eventName = "message";
+            let dataStr = "";
+            for (const line of lines) {
+              if (line.startsWith("event:")) eventName = line.slice(6).trim();
+              else if (line.startsWith("data:")) dataStr += line.slice(5).trim();
+            }
+            if (!dataStr) continue;
+            let data: Record<string, unknown>;
+            try {
+              data = JSON.parse(dataStr);
+            } catch {
+              continue;
+            }
+
+            if (eventName === "progress") {
+              pushStep(String(data.step ?? "?"), String(data.message ?? ""));
+            } else if (eventName === "done") {
+              pushStep("done", String(data.message ?? "Published"));
+              setResult({
+                repoId: data.repoId as string | undefined,
+                spaceUrl: data.spaceUrl as string | undefined,
+              });
+              setStatus("done");
+            } else if (eventName === "error") {
+              setError(String(data.message ?? "Publish failed"));
+              setErrorCode((data.code as string | undefined) ?? null);
+              setStatus("error");
+            }
+          }
+        }
+      } catch (e) {
+        if ((e as { name?: string })?.name === "AbortError") return;
+        setError(e instanceof Error ? e.message : "Unknown error");
+        setStatus("error");
+      } finally {
+        abortRef.current = null;
+      }
+    },
+    [accessToken, reset],
+  );
+
+  const cancel = useCallback(() => {
+    abortRef.current?.abort();
+    abortRef.current = null;
+    setStatus("idle");
+  }, []);
+
+  return {
+    status,
+    steps,
+    result,
+    error,
+    errorCode,
+    publish,
+    cancel,
+    reset,
+  };
+}

frontend/src/hooks/useVirtualFS.ts

@@ -0,0 +1,108 @@
+import { useCallback, useRef, useState } from "react";
+
+export interface VirtualFile {
+  path: string;
+  content: string;
+  updatedAt: number;
+}
+
+/**
+ * In-memory virtual file system for the app the agent is building.
+ *
+ * The agent mutates it through client-side tool execution (`onToolCall` in
+ * `useAgentChat`), the user can also edit files by hand in the Monaco pane.
+ * `version` is bumped on every mutation so the preview iframe and the
+ * publish flow can react to changes.
+ */
+export function useVirtualFS(initial?: VirtualFile[]) {
+  const [files, setFiles] = useState<Map<string, VirtualFile>>(() => {
+    const map = new Map<string, VirtualFile>();
+    (initial ?? []).forEach((f) => map.set(f.path, f));
+    return map;
+  });
+  const [version, setVersion] = useState(0);
+  const filesRef = useRef(files);
+  filesRef.current = files;
+
+  const bump = () => setVersion((v) => v + 1);
+
+  const writeFile = useCallback((path: string, content: string) => {
+    setFiles((prev) => {
+      const next = new Map(prev);
+      next.set(path, { path, content, updatedAt: Date.now() });
+      return next;
+    });
+    bump();
+  }, []);
+
+  const editFile = useCallback(
+    (path: string, oldString: string, newString: string): { ok: boolean; error?: string } => {
+      const current = filesRef.current.get(path);
+      if (!current) {
+        return { ok: false, error: `File "${path}" does not exist (call write_file first).` };
+      }
+      const count = current.content.split(oldString).length - 1;
+      if (count === 0) {
+        return { ok: false, error: `old_string not found in "${path}".` };
+      }
+      if (count > 1) {
+        return {
+          ok: false,
+          error: `old_string is not unique in "${path}" (${count} occurrences). Add more surrounding context.`,
+        };
+      }
+      const nextContent = current.content.replace(oldString, newString);
+      setFiles((prev) => {
+        const next = new Map(prev);
+        next.set(path, { path, content: nextContent, updatedAt: Date.now() });
+        return next;
+      });
+      bump();
+      return { ok: true };
+    },
+    [],
+  );
+
+  const deleteFile = useCallback((path: string): { ok: boolean; error?: string } => {
+    if (!filesRef.current.has(path)) {
+      return { ok: false, error: `File "${path}" does not exist.` };
+    }
+    setFiles((prev) => {
+      const next = new Map(prev);
+      next.delete(path);
+      return next;
+    });
+    bump();
+    return { ok: true };
+  }, []);
+
+  const readFile = useCallback((path: string): VirtualFile | null => {
+    return filesRef.current.get(path) ?? null;
+  }, []);
+
+  const listFiles = useCallback((): VirtualFile[] => {
+    return Array.from(filesRef.current.values()).sort((a, b) =>
+      a.path.localeCompare(b.path),
+    );
+  }, []);
+
+  const clear = useCallback(() => {
+    setFiles(new Map());
+    bump();
+  }, []);
+
+  return {
+    files: Array.from(files.values()).sort((a, b) => a.path.localeCompare(b.path)),
+    filesMap: files,
+    version,
+    writeFile,
+    editFile,
+    deleteFile,
+    readFile,
+    listFiles,
+    clear,
+    getAll: () => Array.from(filesRef.current.values()),
+  };
+}
+
+export type VirtualFSHandle = ReturnType<typeof useVirtualFS>;

frontend/src/main.tsx

@@ -0,0 +1,10 @@
+import React from "react";
+import ReactDOM from "react-dom/client";
+import { App } from "./App";
+import "./styles.css";
+
+ReactDOM.createRoot(document.getElementById("root")!).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>,
+);

frontend/src/styles.css

@@ -0,0 +1,798 @@
+:root {
+  --font-sans: "Inter", ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
+  --font-mono: "JetBrains Mono", ui-monospace, SFMono-Regular, Menlo, monospace;
+
+  --bg: #0b0c10;
+  --bg-elev-1: #111218;
+  --bg-elev-2: #171922;
+  --bg-elev-3: #1e2130;
+  --border: #242838;
+  --border-strong: #30354a;
+
+  --text: #e7e9f1;
+  --text-dim: #a1a5b7;
+  --text-faint: #6a6f82;
+
+  --accent: #ffb020;
+  --accent-dim: #bf8418;
+  --accent-strong: #ffcd66;
+  --danger: #ff5c5c;
+  --success: #4ade80;
+
+  --user-bubble: #1e2130;
+  --agent-bubble: transparent;
+
+  --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.3);
+  --shadow-md: 0 4px 20px rgba(0, 0, 0, 0.4);
+
+  --radius-sm: 6px;
+  --radius-md: 10px;
+  --radius-lg: 14px;
+
+  color-scheme: dark;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+html,
+body,
+#root {
+  height: 100%;
+  margin: 0;
+  padding: 0;
+}
+
+body {
+  background: var(--bg);
+  color: var(--text);
+  font-family: var(--font-sans);
+  font-size: 14px;
+  line-height: 1.5;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+  overflow: hidden;
+}
+
+button {
+  font-family: inherit;
+  font-size: inherit;
+  color: inherit;
+  background: none;
+  border: none;
+  cursor: pointer;
+}
+
+input,
+textarea,
+select {
+  font-family: inherit;
+  font-size: inherit;
+  color: inherit;
+}
+
+code,
+pre,
+.mono {
+  font-family: var(--font-mono);
+}
+
+/* ── App shell ─────────────────────────────────────────────────────────── */
+.app-shell {
+  display: flex;
+  flex-direction: column;
+  height: 100vh;
+  min-height: 0;
+}
+
+.app-main {
+  display: grid;
+  grid-template-columns: minmax(360px, 420px) 1fr;
+  flex: 1;
+  min-height: 0;
+}
+
+/* ── Top bar ───────────────────────────────────────────────────────────── */
+.topbar {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  padding: 0 16px;
+  height: 52px;
+  border-bottom: 1px solid var(--border);
+  background: var(--bg-elev-1);
+}
+
+.topbar-brand {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  font-weight: 600;
+  letter-spacing: 0.01em;
+}
+
+.topbar-logo {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 28px;
+  height: 28px;
+  border-radius: 6px;
+  background: var(--accent);
+  color: #111;
+  font-size: 18px;
+  font-weight: 700;
+}
+
+.topbar-title {
+  display: flex;
+  flex-direction: column;
+  line-height: 1.15;
+}
+
+.topbar-title-main {
+  font-weight: 600;
+}
+
+.topbar-title-sub {
+  font-size: 11px;
+  color: var(--text-faint);
+  letter-spacing: 0.02em;
+  text-transform: uppercase;
+}
+
+.topbar-spacer {
+  flex: 1;
+}
+
+.topbar-model {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  font-size: 12px;
+  color: var(--text-dim);
+}
+
+.topbar-model select {
+  background: var(--bg-elev-2);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-sm);
+  padding: 4px 8px;
+  font-size: 12px;
+  cursor: pointer;
+}
+
+.topbar-user {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 4px 10px 4px 4px;
+  border: 1px solid var(--border);
+  border-radius: 999px;
+  background: var(--bg-elev-2);
+}
+
+.topbar-user img,
+.topbar-user .avatar-fallback {
+  width: 24px;
+  height: 24px;
+  border-radius: 50%;
+  object-fit: cover;
+  background: var(--bg-elev-3);
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 11px;
+  font-weight: 600;
+}
+
+.topbar-user-name {
+  font-size: 12px;
+  color: var(--text);
+  max-width: 140px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.topbar-user-menu {
+  margin-left: 4px;
+  color: var(--text-faint);
+  font-size: 11px;
+}
+
+.btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 6px 12px;
+  border-radius: var(--radius-sm);
+  background: var(--bg-elev-2);
+  border: 1px solid var(--border);
+  color: var(--text);
+  font-size: 12px;
+  font-weight: 500;
+  transition: all 0.15s ease;
+}
+
+.btn:hover {
+  background: var(--bg-elev-3);
+  border-color: var(--border-strong);
+}
+
+.btn:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+.btn-primary {
+  background: var(--accent);
+  border-color: var(--accent);
+  color: #111;
+}
+
+.btn-primary:hover {
+  background: var(--accent-strong);
+  border-color: var(--accent-strong);
+}
+
+.btn-ghost {
+  background: transparent;
+  border: 1px solid transparent;
+  color: var(--text-dim);
+}
+
+.btn-ghost:hover {
+  background: var(--bg-elev-2);
+  color: var(--text);
+}
+
+.btn-danger {
+  background: transparent;
+  border: 1px solid transparent;
+  color: var(--danger);
+}
+
+/* ── Sign-in screen ────────────────────────────────────────────────────── */
+.signin-screen {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  height: 100%;
+  text-align: center;
+  padding: 40px 24px;
+}
+
+.signin-emoji {
+  font-size: 56px;
+  margin-bottom: 16px;
+}
+
+.signin-title {
+  font-size: 28px;
+  font-weight: 700;
+  margin: 0 0 8px;
+}
+
+.signin-subtitle {
+  font-size: 14px;
+  color: var(--text-dim);
+  max-width: 480px;
+  margin: 0 0 28px;
+}
+
+.signin-button {
+  display: inline-flex;
+  align-items: center;
+  gap: 10px;
+  padding: 12px 22px;
+  border-radius: 999px;
+  background: var(--accent);
+  color: #111;
+  font-weight: 600;
+  border: none;
+  font-size: 14px;
+  transition: all 0.15s ease;
+}
+
+.signin-button:hover {
+  background: var(--accent-strong);
+}
+
+.signin-hint {
+  margin-top: 16px;
+  font-size: 12px;
+  color: var(--text-faint);
+  max-width: 480px;
+}
+
+.signin-error {
+  margin-top: 20px;
+  padding: 10px 14px;
+  background: rgba(255, 92, 92, 0.1);
+  border: 1px solid rgba(255, 92, 92, 0.4);
+  border-radius: var(--radius-sm);
+  color: var(--danger);
+  font-size: 12px;
+  max-width: 520px;
+}
+
+/* ── Chat panel ────────────────────────────────────────────────────────── */
+.chat-panel {
+  display: flex;
+  flex-direction: column;
+  min-height: 0;
+  border-right: 1px solid var(--border);
+  background: var(--bg-elev-1);
+}
+
+.chat-messages {
+  flex: 1;
+  overflow-y: auto;
+  padding: 16px;
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+}
+
+.chat-empty {
+  padding: 20px;
+  color: var(--text-faint);
+  font-size: 13px;
+  line-height: 1.6;
+}
+
+.chat-empty-examples {
+  margin-top: 12px;
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.chat-empty-example {
+  text-align: left;
+  padding: 8px 12px;
+  background: var(--bg-elev-2);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-sm);
+  color: var(--text-dim);
+  cursor: pointer;
+  font-size: 12px;
+  transition: all 0.15s ease;
+}
+
+.chat-empty-example:hover {
+  background: var(--bg-elev-3);
+  color: var(--text);
+}
+
+.bubble-user {
+  align-self: flex-end;
+  max-width: 85%;
+  padding: 10px 14px;
+  background: var(--user-bubble);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-md);
+  white-space: pre-wrap;
+  word-wrap: break-word;
+}
+
+.bubble-agent {
+  align-self: stretch;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  color: var(--text);
+}
+
+.bubble-agent-text {
+  white-space: pre-wrap;
+  word-wrap: break-word;
+}
+
+.bubble-tool {
+  align-self: stretch;
+  padding: 6px 10px;
+  background: var(--bg-elev-2);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-sm);
+  font-family: var(--font-mono);
+  font-size: 11px;
+  color: var(--text-dim);
+}
+
+.bubble-tool.status-done {
+  border-color: rgba(74, 222, 128, 0.3);
+  background: rgba(74, 222, 128, 0.05);
+}
+
+.bubble-tool.status-error {
+  border-color: rgba(255, 92, 92, 0.4);
+  background: rgba(255, 92, 92, 0.08);
+  color: var(--danger);
+}
+
+.bubble-tool-header {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  font-weight: 500;
+}
+
+.bubble-tool-detail {
+  margin-top: 4px;
+  color: var(--text-faint);
+  font-size: 10px;
+  white-space: pre-wrap;
+  word-break: break-all;
+}
+
+.chat-composer {
+  border-top: 1px solid var(--border);
+  padding: 12px 16px;
+  background: var(--bg-elev-1);
+}
+
+.chat-composer-field {
+  display: flex;
+  align-items: flex-end;
+  gap: 8px;
+  padding: 8px;
+  background: var(--bg-elev-2);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-md);
+  transition: border-color 0.15s ease;
+}
+
+.chat-composer-field:focus-within {
+  border-color: var(--accent);
+}
+
+.chat-composer textarea {
+  flex: 1;
+  min-height: 20px;
+  max-height: 160px;
+  resize: none;
+  background: transparent;
+  border: none;
+  outline: none;
+  padding: 4px 6px;
+  line-height: 1.4;
+  color: var(--text);
+}
+
+.chat-composer textarea::placeholder {
+  color: var(--text-faint);
+}
+
+.chat-send {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 32px;
+  height: 32px;
+  border-radius: var(--radius-sm);
+  background: var(--accent);
+  color: #111;
+  border: none;
+  font-size: 16px;
+  transition: all 0.15s ease;
+}
+
+.chat-send:hover:not(:disabled) {
+  background: var(--accent-strong);
+}
+
+.chat-send:disabled {
+  opacity: 0.4;
+  cursor: not-allowed;
+}
+
+.chat-status {
+  margin-top: 6px;
+  font-size: 11px;
+  color: var(--text-faint);
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+/* ── Right pane ────────────────────────────────────────────────────────── */
+.right-pane {
+  display: flex;
+  flex-direction: column;
+  min-height: 0;
+  background: var(--bg);
+}
+
+.tab-bar {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  padding: 0 8px;
+  height: 40px;
+  border-bottom: 1px solid var(--border);
+  background: var(--bg-elev-1);
+}
+
+.tab {
+  padding: 6px 14px;
+  color: var(--text-dim);
+  font-size: 12px;
+  font-weight: 500;
+  border-radius: var(--radius-sm);
+  border: 1px solid transparent;
+  cursor: pointer;
+}
+
+.tab.active {
+  color: var(--text);
+  background: var(--bg-elev-2);
+  border-color: var(--border);
+}
+
+.tab-spacer {
+  flex: 1;
+}
+
+.tab-actions {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+}
+
+.pane-content {
+  flex: 1;
+  min-height: 0;
+  display: flex;
+  flex-direction: column;
+}
+
+.pane-content.hidden {
+  display: none;
+}
+
+/* ── Code editor ───────────────────────────────────────────────────────── */
+.code-layout {
+  display: grid;
+  grid-template-columns: 220px 1fr;
+  height: 100%;
+  min-height: 0;
+}
+
+.file-tree {
+  border-right: 1px solid var(--border);
+  background: var(--bg-elev-1);
+  overflow-y: auto;
+  padding: 8px 0;
+}
+
+.file-tree-empty {
+  padding: 16px;
+  color: var(--text-faint);
+  font-size: 12px;
+}
+
+.file-tree-item {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  padding: 5px 12px;
+  font-family: var(--font-mono);
+  font-size: 12px;
+  color: var(--text-dim);
+  cursor: pointer;
+  border-left: 2px solid transparent;
+}
+
+.file-tree-item:hover {
+  background: var(--bg-elev-2);
+  color: var(--text);
+}
+
+.file-tree-item.active {
+  background: var(--bg-elev-2);
+  color: var(--text);
+  border-left-color: var(--accent);
+}
+
+.file-tree-size {
+  margin-left: auto;
+  color: var(--text-faint);
+  font-size: 10px;
+}
+
+.editor-area {
+  min-height: 0;
+  display: flex;
+  flex-direction: column;
+}
+
+.editor-placeholder {
+  margin: auto;
+  color: var(--text-faint);
+  font-size: 13px;
+  text-align: center;
+  padding: 40px;
+}
+
+/* ── Preview ───────────────────────────────────────────────────────────── */
+.preview-frame {
+  flex: 1;
+  min-height: 0;
+  background: white;
+  border: none;
+}
+
+.preview-empty {
+  margin: auto;
+  color: var(--text-faint);
+  font-size: 13px;
+  text-align: center;
+  padding: 40px;
+}
+
+/* ── Dialog ────────────────────────────────────────────────────────────── */
+.dialog-backdrop {
+  position: fixed;
+  inset: 0;
+  background: rgba(0, 0, 0, 0.6);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  z-index: 100;
+  padding: 24px;
+}
+
+.dialog {
+  width: 100%;
+  max-width: 480px;
+  background: var(--bg-elev-1);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-lg);
+  box-shadow: var(--shadow-md);
+  overflow: hidden;
+}
+
+.dialog-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 14px 18px;
+  border-bottom: 1px solid var(--border);
+  font-weight: 600;
+}
+
+.dialog-body {
+  padding: 18px;
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+}
+
+.dialog-footer {
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+  padding: 14px 18px;
+  border-top: 1px solid var(--border);
+  background: var(--bg-elev-2);
+}
+
+.field {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.field label {
+  font-size: 12px;
+  color: var(--text-dim);
+  font-weight: 500;
+}
+
+.field input[type="text"],
+.field input[type="password"],
+.field textarea {
+  padding: 8px 10px;
+  background: var(--bg-elev-2);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-sm);
+  color: var(--text);
+}
+
+.field input:focus,
+.field textarea:focus {
+  outline: none;
+  border-color: var(--accent);
+}
+
+.field-hint {
+  font-size: 11px;
+  color: var(--text-faint);
+}
+
+.field-row {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.publish-log {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 12px;
+  background: var(--bg-elev-2);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-sm);
+  font-family: var(--font-mono);
+  font-size: 11px;
+  max-height: 180px;
+  overflow-y: auto;
+}
+
+.publish-log-step {
+  color: var(--text-dim);
+}
+
+.publish-log-step.done {
+  color: var(--success);
+}
+
+.publish-log-step.error {
+  color: var(--danger);
+}
+
+.publish-success {
+  padding: 10px 12px;
+  background: rgba(74, 222, 128, 0.08);
+  border: 1px solid rgba(74, 222, 128, 0.3);
+  border-radius: var(--radius-sm);
+  color: var(--success);
+  font-size: 12px;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+
+.publish-success a {
+  color: inherit;
+  font-weight: 600;
+}
+
+.publish-error {
+  padding: 10px 12px;
+  background: rgba(255, 92, 92, 0.1);
+  border: 1px solid rgba(255, 92, 92, 0.3);
+  border-radius: var(--radius-sm);
+  color: var(--danger);
+  font-size: 12px;
+}
+
+/* ── Utility ───────────────────────────────────────────────────────────── */
+.dot {
+  display: inline-block;
+  width: 6px;
+  height: 6px;
+  border-radius: 50%;
+  background: currentColor;
+}
+
+.spinner {
+  display: inline-block;
+  width: 12px;
+  height: 12px;
+  border: 2px solid var(--text-faint);
+  border-top-color: var(--accent);
+  border-radius: 50%;
+  animation: spin 0.8s linear infinite;
+}
+
+@keyframes spin {
+  to {
+    transform: rotate(360deg);
+  }
+}

frontend/src/vite-env.d.ts

@@ -0,0 +1,20 @@
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+  readonly VITE_HF_OAUTH_CLIENT_ID?: string;
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}
+
+interface Window {
+  huggingface?: {
+    variables?: {
+      OAUTH_CLIENT_ID?: string;
+      OAUTH_SCOPES?: string;
+      SPACE_HOST?: string;
+      SPACE_ID?: string;
+    };
+  };
+}

frontend/tsconfig.app.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "useDefineForClassFields": true,
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": false,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noFallthroughCasesInSwitch": true,
+    "resolveJsonModule": true,
+    "types": ["vite/client"]
+  },
+  "include": ["src"]
+}

frontend/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "files": [],
+  "references": [
+    { "path": "./tsconfig.app.json" },
+    { "path": "./tsconfig.node.json" }
+  ]
+}

frontend/tsconfig.node.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2023"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "strict": true
+  },
+  "include": ["vite.config.ts"]
+}

frontend/vite.config.ts

@@ -0,0 +1,24 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+
+/**
+ * Dev: Vite serves the React app on :5173 and proxies `/api/*` to the
+ * Hono backend on :7860. In production the same Hono server serves the
+ * static build from `frontend/dist` (see `backend/src/server.ts`).
+ */
+export default defineConfig({
+  plugins: [react()],
+  server: {
+    port: 5173,
+    proxy: {
+      "/api": {
+        target: "http://localhost:7860",
+        changeOrigin: true,
+      },
+    },
+  },
+  build: {
+    outDir: "dist",
+    sourcemap: true,
+  },
+});