Release v0.9.0

chore: bump version to 0.9.0
2026-02-17 18:10:18 -03:00 · 2026-02-17 18:09:44 -03:00 · 2026-02-17 18:08:31 -03:00 · 2026-02-17 15:14:25 -03:00 · 2026-02-17 14:56:38 -03:00 · 2026-02-17 14:47:56 -03:00
32 changed files with 346 additions and 1456 deletions
@@ -71,9 +71,6 @@ docs/*
 !docs/planning/
 !docs/improvement-plans/
 !docs/api/
-!docs/VM_DEPLOYMENT_GUIDE.md
-!docs/FEATURES.md
-!docs/screenshots/

 # open-sse tests
 open-sse/test/*
@@ -91,6 +88,3 @@ omnirouteSite/

 # Security Analysis (standalone project with own git)
 security-analysis/
-
-# Deploy workflow (contains sensitive VPS credentials)
-.agent/workflows/deploy.md
@@ -7,135 +7,242 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

 ---

-## [1.0.0] — 2026-02-18
+## [0.9.0] — 2026-02-17

-> ### 🎉 First Major Release — OmniRoute 1.0
->
-> OmniRoute is an intelligent API gateway that unifies 20+ AI providers behind a single OpenAI-compatible endpoint. This release represents the culmination of the entire development effort — from initial prototype to production-ready platform.
+### Added

-### 🧠 Core Routing & Intelligence
-
- **Smart 4-tier fallback** — Auto-routing: Subscription → Cheap → Free → Emergency
- **6 routing strategies** — Fill First, Round Robin, Power-of-Two-Choices, Random, Least Used, Cost Optimized
- **Semantic caching** — Auto-cache responses for deduplication with configurable TTL
- **Request idempotency** — Prevent duplicate processing of identical requests
- **Thinking budget validation** — Control reasoning token allocation per request
- **System prompt injection** — Configurable global system prompts for all requests
-
-### 🔌 Providers & Models
-
- **20+ AI providers** — OpenAI, Claude (Anthropic), Gemini, GitHub Copilot, DeepSeek, Groq, xAI, Mistral, Qwen, iFlow, Kiro, OpenRouter, GLM, MiniMax, Kimi, NVIDIA NIM, and more
- **Multi-account support** — Multiple accounts per provider with automatic rotation
- **OAuth 2.0 (PKCE)** — Automatic token management and refresh for Claude Code, Codex, Gemini CLI, Copilot, Kiro
- **Auto token refresh** — Background refresh with expiry detection and unrecoverable error handling
- **Model import** — Import models from API-compatible passthrough providers
- **OpenAI-compatible validation** — Fallback validation via chat completions for providers without `/models` endpoint
- **TLS fingerprint spoofing** — Browser-like TLS fingerprinting via `wreq-js` to bypass bot detection
-
-### 🔄 Format Translation
-
- **Multi-format translation** — Seamless OpenAI ↔ Claude ↔ Gemini ↔ OpenAI Responses API conversion
- **Translator Playground** — 4 interactive modes:
-  - **Playground** — Test format translations between any provider formats
-  - **Chat Tester** — Send real requests through the proxy with visual response rendering
-  - **Test Bench** — Automated batch testing across multiple providers
-  - **Live Monitor** — Real-time stream of active proxy requests and translations
-
-### 🎯 Combos & Fallback Chains
-
- **Custom combos** — Create model combinations with multi-provider fallback chains
- **6 combo balancing strategies** — Fill First, Round Robin, Random, Least Used, P2C, Cost Optimized
- **Combo circuit breaker** — Auto-disable failing providers within a combo chain
-
-### 🛡️ Resilience & Security
-
- **Circuit breakers** — Auto-recovery with configurable thresholds and cooldown periods
- **Exponential backoff** — Progressive retry delays for failed requests
- **Anti-thundering herd** — Mutex-based protection against concurrent retry storms
- **Rate limit detection** — Per-provider RPM, min gap, and max concurrent request tracking
- **Editable rate limits** — Configurable defaults via Settings → Resilience with persistence
- **Prompt injection guard** — Input sanitization for malicious prompt patterns
- **PII redaction** — Automatic detection and masking of personally identifiable information
- **AES-256-GCM encryption** — Credential encryption at rest
- **IP access control** — Whitelist/blacklist IP filtering
- **SOCKS5 proxy support** — Outbound proxy for upstream provider calls
-
-### 📊 Observability & Analytics
-
- **Analytics dashboard** — Recharts-based SVG charts: stat cards, model usage bar chart, provider breakdown table with success rates and latency
- **Real-time health monitoring** — Provider health, rate limits, latency telemetry
- **Request logs** — Dedicated page with SQLite-persisted proxy request/response logs
- **Limits & Quotas** — Separate dashboard for quota monitoring with reset countdowns
- **Cost analytics** — Token cost tracking and budget management per provider
- **Request telemetry** — Correlation IDs, structured logging, request timing
-
-### 💾 Database & Backup
-
- **Dual database** — LowDB (JSON) for config + SQLite for domain state and proxy logs
- **Export database** — `GET /api/db-backups/export` — Download SQLite database file
- **Export all** — `GET /api/db-backups/exportAll` — Full backup as `.tar.gz` archive (DB + settings + combos + providers + masked API keys)
- **Import database** — `POST /api/db-backups/import` — Upload and restore with validation, integrity check, and pre-import backup
- **Automatic backups** — Configurable backup schedule with retention
- **Storage health** — Dashboard widget with database size, path, and backup status
-
-### 🖥️ Dashboard & UI
-
- **Full dashboard** — Provider management, analytics, health monitoring, settings, CLI tools
- **9 dashboard sections** — Providers, Combos, Analytics, Health, Translator, Settings, CLI Tools, Usage, Endpoint
- **Settings restructure** — 6 tabs: Security, Routing, Resilience, AI, System/Storage, Advanced
- **Shared UI component library** — Reusable components (Avatar, Badge, Button, Card, DataTable, Modal, etc.)
- **Dark/Light/System theme** — Persistent theme selection with system preference detection
- **Agent showcase grid** — Visual grid of 10 AI coding agents in README header
- **Provider logos** — Logo assets for all supported agents and providers
- **Red shield badges** — Styled badge icons across all documentation
-
-### ☁️ Deployment & Infrastructure
-
- **Docker support** — Multi-stage Dockerfile with `base` and `cli` profiles
- **Docker Hub** — `diegosouzapw/omniroute` with `latest` and versioned tags
- **Docker CI/CD** — GitHub Actions auto-build and push on release
- **npm CLI package** — `npx omniroute` with auto-launch
- **npm CI/CD** — GitHub Actions auto-publish to npm on release
- **Akamai VM deployment** — Production deployment on Nanode 1GB with nginx reverse proxy
- **Cloud sync** — Sync configuration across devices via Cloudflare Worker
- **Edge compatibility** — Native `crypto.randomUUID()` for Cloudflare Workers
-
-### 🧪 Testing & Quality
-
- **100% TypeScript** — Full migration of `src/` (200+ files) and `open-sse/` (94 files) — zero `@ts-ignore`, zero TypeScript errors
- **CI/CD pipeline** — GitHub Actions for lint, build, test, npm publish, Docker publish
- **Unit tests** — 20+ test suites covering domain logic, security, caching, routing
- **E2E tests** — Playwright specs for API, navigation, and responsive behavior
- **LLM evaluations** — Golden set testing framework with 4 match strategies (`exact`, `contains`, `regex`, `custom`)
- **Security tests** — CLI runtime, Docker hardening, cloud sync, and OpenAI compatibility
-
-### 📖 Documentation
-
- **8 language READMEs** — English, Portuguese (pt-BR), Spanish, Russian, Chinese (zh-CN), German, French, Italian
- **VM Deployment Guide** — Complete guide (VM + Docker + nginx + Cloudflare + security)
- **Features Gallery** — 9 dashboard screenshots with descriptions
- **API Reference** — Full endpoint documentation including backup/export/import
- **User Guide** — Step-by-step setup, configuration, and usage instructions
- **Architecture docs** — System design, component decomposition, ADRs
- **OpenAPI specification** — Machine-readable API documentation
- **Troubleshooting guide** — Common issues and solutions
- **Security policy** — `SECURITY.md` with vulnerability reporting via GitHub Security Advisories
- **Roadmap** — 150+ planned features across 6 categories
-
-### 🔌 API Endpoints
-
- `/v1/chat/completions` — OpenAI-compatible chat endpoint with format translation
- `/v1/embeddings` — Embedding generation
- `/v1/images/generations` — Image generation
- `/v1/models` — Model listing with provider filtering
- `/v1/rerank` — Re-ranking endpoint
- `/v1/audio/*` — Audio transcription and translation
- `/v1/moderations` — Content moderation
- `/api/db-backups/export` — Database export
- `/api/db-backups/exportAll` — Full archive export
- `/api/db-backups/import` — Database import with validation
- 30+ dashboard API routes for providers, combos, settings, analytics, health, CLI tools
+- 🌐 **Full multilingual README support** — Complete translations of README.md into 7 languages: Portuguese (pt-BR), Spanish (es), Russian (ru), Chinese Simplified (zh-CN), German (de), French (fr), Italian (it)
+- 🤖 **Agent showcase grid** — Modernized header with visual grid showcasing 10 AI coding agents (OpenClaw, NanoBot, PicoClaw, ZeroClaw, IronClaw, OpenCode, Codex CLI, Claude Code, Gemini CLI, Kilo Code)
+- 🖼️ **Provider logos** — Added logo assets for OpenClaw, NanoBot, PicoClaw, ZeroClaw, IronClaw, OpenCode
+- 🔌 **OpenAI-compatible provider validation fix** — Fallback validation via chat completions for providers that don't expose `/models` endpoint
+- 🛡️ **Red shield badges** — Replaced plain ❌ emoji with styled badge icons across all README files

 ---

-[1.0.0]: https://github.com/diegosouzapw/OmniRoute/releases/tag/v1.0.0
+## [0.8.8] — 2026-02-17
+
+### Added
+
+- 📊 **Analytics page redesign** — Rebuilt analytics dashboard with Recharts (SVG-based) charts replacing the previous implementation. New layout: stat cards → model usage bar chart → provider breakdown table with success rates and avg latency
+- 🎯 **6 global routing strategies** — Expanded from 3 (Fill-First, Round-Robin, P2C) to 6, adding Random, Least-Used, and Cost-Optimized. All strategies now have descriptions and icons in the Settings → Routing tab
+- 🔧 **Editable rate limits** — Rate limit defaults (RPM, Min Gap, Max Concurrent) are now editable in Settings → Resilience with save/cancel functionality. Values persist via the resilience API
+- 📋 **Policies in Resilience tab** — Moved PoliciesPanel (circuit breaker status + locked identifiers) from Security to Resilience tab for better logical grouping
+- 🧠 **Prompt Cache in AI tab** — Relocated CacheStatsCard from Advanced to AI tab alongside Thinking Budget and System Prompt
+
+### Changed
+
+- ♻️ **Settings page restructure** — Reorganized all settings tabs for better UX:
+  - **Security**: Simplified to Login/Password and IP Access Control only
+  - **Routing**: Expanded strategy grid with all 6 routing strategies
+  - **Resilience**: Reordered cards (Provider Profiles → Rate Limiting → Circuit Breakers → Policies & Locked Identifiers)
+  - **AI**: Now includes Thinking Budget, System Prompt, and Prompt Cache
+  - **Advanced**: Simplified to only Global Proxy configuration
+- 🔄 **Backend routing strategies** — Implemented `random` (Fisher-Yates shuffle), `least-used` (sorted by `lastUsedAt`), `cost-optimized` (sorted by priority ascending), and fixed `p2c` (power-of-two-choices with health scoring) in `auth.ts`
+- 🔌 **Resilience API updates** — GET endpoint now merges saved rate limit defaults with constants; PATCH endpoint accepts both `profiles` and `defaults`
+- 📊 **Usage page split** — Refactored Usage page into "Request Logs" (with updated icon) and a new dedicated "Limits & Quotas" page
+
+### Fixed
+
+- 🐛 **Provider add error** — Improved error handling for API responses when adding new provider connections, with clear validation feedback
+
+---
+
+## [0.8.5] — 2026-02-17
+
+> ### 🔷 MILESTONE: 100% TypeScript Migration
+>
+> **OmniRoute is now fully TypeScript.** The entire `src/` directory (API routes, components, services, lib, domain layer) and all 94 files in `open-sse/` have been migrated from JavaScript/JSX to TypeScript/TSX — with zero `@ts-ignore` annotations and zero TypeScript errors. This is a complete rewrite of the type layer across 200+ files.
+
+### Added
+
+- 🔒 **TLS fingerprint spoofing** — Implement browser-like TLS fingerprinting via `wreq-js` to bypass bot detection on providers that enforce TLS client fingerprint checks (`3dd0cc1`, PR #52)
+- 💾 **SQLite proxy log persistence** — Proxy request/response logs now persist to SQLite database, surviving server restarts. Previously, logs were lost on restart (`f1664fe`, PR #53)
+- 📋 **Unified test logging** — Shared `Logger` + Proxy logging infrastructure for all provider connection test flows. Consistent log formatting across batch and individual tests (`bce302e`, PR #55)
+
+### Refactored
+
+- 🔷 **Full TypeScript migration — `src/`** — Migrated the entire `src/` directory from JavaScript to TypeScript. All `.js`/`.jsx` files converted to `.ts`/`.tsx` with proper type annotations across API routes, lib modules, components, services, stores, domain layer, and shared utilities (`d0ca595`)
+  - **Wave 1**: Shared component interfaces + EventTarget fixes (`dfdd2a2`)
+  - **Wave 2**: Utils & services typed fields, Zustand stores, logger, sync scheduler (`89dd107`, `b2907cd`)
+  - **Wave 3a**: Lib layer, DB, compliance, domain layer typed (`9e13fe2`)
+  - **Wave 3b**: Usage, CLI runtime, SSE auth/logger typed (`a291abd`)
+  - **Wave 3c**: OAuth services + server utils typed (`d62cf8d`)
+  - **Wave 4a**: 7 API routes — providers, cli-tools, oauth (`7cdb923`)
+  - **Wave 4b**: 7 more API routes — providers, test, usage, nodes (`5592c2e`)
+  - **Wave 4c**: 8 files — components, SSE handlers, services (`d8ce9dc`)
+  - **Dashboard hardening**: Resolve all TypeScript errors across dashboard pages (`7a463a3`, PR #61)
+- 🔷 **Full TypeScript migration — `open-sse/`** — Migrated all 94 `.js` files in the SSE routing engine to TypeScript (PR #62)
+  - **Phase 1**: Rename all 94 `.js` → `.ts` files (`256e443`)
+  - **Phase 6**: Reduce `@ts-ignore` from 231 → 186 with targeted fixes (`6a54b84`)
+  - **Phase 7**: Eliminate ALL `@ts-ignore` annotations (186 → 0) and ALL TypeScript errors (237 → 0) — zero `@ts-ignore`, zero errors (`7b37a3c`)
+  - Typing strategies: `Record<string, any>` for dynamic objects, optional function params, `as any` casts for custom Error/Array properties, `declare var EdgeRuntime` for edge compatibility, proper `fs`/`path` imports
+
+### Fixed
+
+- 🐛 **Qwen token refresh** — Detect `invalid_request` as unrecoverable error and switch broken test endpoints to `checkExpiry` method instead of failing silently (`1e0ffbc`, PR #60)
+- 🐛 **VPS batch test compatibility** — Eliminate HTTP self-calls in batch provider connection tests for VPS environments where localhost is unreachable (`a3bbbb5`, PR #54)
+- 🐛 **E2E test assertions** — Correct API endpoints and response format assertions in end-to-end tests (`92b5e66`)
+- 🐛 **CI coverage thresholds** — Lower coverage thresholds, use production server for E2E, block ESLint major upgrades from breaking CI (`3ca4b6b`, PR #51)
+
+### Changed
+
+- 📖 **Documentation update** — Updated all documentation to reflect JS → TS migration, corrected file extensions and import paths (`7ff8aa2`)
+- ⬆️ **CI/CD** — Bump `actions/checkout` v4 → v6, `actions/setup-node` v4 → v6, `peter-evans/dockerhub-description` v4 → v5
+
+### Dependencies
+
+- ⬆️ `undici` 7.21.0 → 7.22.0 (production)
+- ⬆️ `actions/checkout` 4 → 6
+- ⬆️ `actions/setup-node` 4 → 6
+- ⬆️ `peter-evans/dockerhub-description` 4 → 5
+- 🚫 `eslint` 10.0.0 blocked — major version incompatible with `eslint-config-next`
+
+---
+
+## [0.8.0] — 2026-02-16
+
+### Added
+
+- 🌐 **Official website** — [omniroute.online](https://omniroute.online) live with static site on Akamai VM + Cloudflare proxy
+- 🛡️ **Comprehensive SECURITY.md** — Full codebase audit documenting 10+ security features (AES-256-GCM, prompt injection guard, PII redaction, circuit breaker, etc.)
+- 📖 **Documentation tracking** — `USER_GUIDE.md`, `API_REFERENCE.md`, `TROUBLESHOOTING.md` now tracked in git
+- 🏷️ **Website badge** — Official website badge and links in README, npm, and Docker Hub
+- 🔗 **36+ providers** — Updated provider count across documentation
+
+### Changed
+
+- 📦 **npm homepage** — Points to `omniroute.online` instead of GitHub
+- 🐳 **Docker OCI labels** — Added `org.opencontainers.image.url` for Docker Hub
+- 🔒 **Security policy** — Updated supported versions, replaced email with GitHub Security Advisories
+
+---
+
+## [0.7.0] — 2026-02-16
+
+### Added
+
+- 🐳 **Docker Hub public image** — `diegosouzapw/omniroute` available on [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute) with `latest` and versioned tags
+- 🔄 **Docker CI/CD** — GitHub Actions workflow (`docker-publish.yml`) auto-builds and pushes Docker image on every release
+- ☁️ **Akamai VM deployment** — Nanode 1GB instance created for remote hosting
+- 🎯 **Provider model filtering** — Filter model suggestions by selected provider in Translator and Chat Tester
+- 🔌 **CLI status badges** — Extract `CliStatusBadge` component; status visible on collapsed tool cards
+- ☁️ **Cloud connection UX** — GET status endpoint, toast feedback, and sidebar indicator for cloud sync
+- 🔐 **OAuth provider secrets** — Default cloud URL and OAuth provider secrets set via environment variables
+- ⚡ **Edge compatibility** — Replace `uuid` package with native `crypto.randomUUID()` for Cloudflare Workers compatibility
+
+---
+
+## [0.6.0] — 2026-02-16
+
+### Added
+
+- 💰 **Costs & Budget page** — Dedicated dashboard page for cost tracking and budget management
+- 📊 **Provider metrics display** — Show per-provider usage metrics and statistics
+- 📥 **Model import for passthrough providers** — Import models from API-compatible providers (Deepgram, AssemblyAI, NanoBanana)
+- 🎨 **App icon redesign** — New network node graph icon with updated color scheme
+
+---
+
+## [0.5.0] — 2026-02-15
+
+### Added
+
+- 🧪 **LLM Evaluations (Evals)** — Golden set testing framework with 4 match strategies (`exact`, `contains`, `regex`, `custom`)
+- 🎲 **Advanced combo strategies** — `random`, `least-used`, and `cost-optimized` balancing strategies for combos
+- 📊 **API key usage in Evals** — Evals tab uses API key auth for real LLM calls through the proxy
+- 🏷️ **Model availability badge** — Visual indicator for model availability per provider
+- 🎨 **Landing page retheme** — Updated landing page design with new aesthetic
+- 🧩 **Shared UI component library** — Refactored dashboard with reusable component library
+
+### Fixed
+
+- 🐛 Fix `TypeError` in `chat/completions` `ensureInitialized` call
+
+---
+
+## [0.4.0] — 2026-02-15
+
+### Added
+
+- 🧠 **LLM Gateway Intelligence** (Phase 9) — Smart routing, semantic caching, request idempotency, progress tracking
+- 📄 **Missing flows & pages** (Phase 8) — Error pages, UX components, telemetry dashboards
+- 🔧 **API & code quality** (Phase 7) — API restructuring, JSDoc documentation, code quality improvements
+- 📚 **Documentation restructuring** (Phase 10) — Component decomposition, docs cleanup
+- ✅ **26 action items** from critical analysis resolved
+
+### Changed
+
+- ♻️ **Architecture refactor** (Phase 5-6) — Domain persistence, policy engine, OAuth extraction, proxy decoupling
+
+### Fixed
+
+- 🐛 Fix CI build and lint failures
+- 🐛 Fix ghost import in `chatHelpers.js` SSE handling
+
+---
+
+## [0.3.0] — 2026-02-15
+
+### Added
+
+- ⚡ **Resilience system** — Exponential backoff, circuit breaker, anti-thundering herd mutex, Resilience UI settings page
+- 🖥️ **100% frontend API coverage** — 7 implementation batches covering all backend routes
+- 📊 **9 new API routes** — Budget, telemetry, compliance, tags, storage health, and more
+- 🧪 **Eval framework & compliance** — ADRs, accessibility, CLI specs, Playwright test specs (46 tasks)
+- 🏗️ **Pipeline integration** — 7 backend modules wired into request processing pipeline
+- 🔐 **Security hardening** — Phases 01–06 (input validation, CSRF, rate limiting, auth hardening)
+- 🤖 **Advanced features** — Phases 07–09 (domain extraction, error codes, request ID, fetch timeout)
+- 🔄 **Unrecoverable token handling** — Detect and mark connections as expired on fatal refresh errors
+
+### Changed
+
+- ♻️ Decompose `usageDb`, `handleSingleModelChat`, and UI components for maintainability
+- ⬇️ Downgrade ESLint v10 → v9 for `eslint-config-next` compatibility
+
+---
+
+## [0.2.0] — 2026-02-14
+
+### Added
+
+- 🛣️ **Advanced routing services** — Priority-based routing, global strategy configuration
+- 💰 **Cost analytics dashboard** — Token cost tracking and analytics visualization
+- 💎 **Pricing overhaul** — Comprehensive pricing data for all supported providers and models
+- 📦 **npm badge & CLI options** — npm version badge in README, CLI options table, automated release docs
+
+---
+
+## [0.1.0] — 2026-02-14
+
+### Added
+
+- 🎉 **Initial OmniRoute release** — Rebranded from 9router with full feature set
+- 🔄 **28 AI providers** — OpenAI, Claude, Gemini, Copilot, DeepSeek, Groq, xAI, Mistral, Qwen, iFlow, and more
+- 🎯 **Smart fallback** — 3-tier auto-routing (Subscription → Cheap → Free)
+- 🔀 **Format translation** — Seamless OpenAI ↔ Claude ↔ Gemini format conversion
+- 👥 **Multi-account support** — Multiple accounts per provider with round-robin
+- 🔐 **OAuth 2.0 (PKCE)** — Automatic token management and refresh
+- 📊 **Usage tracking** — Real-time quota monitoring with reset countdown
+- 🎨 **Custom combos** — Create model combinations with fallback chains
+- ☁️ **Cloud sync** — Sync configuration across devices via Cloudflare Worker
+- 📖 **OpenAPI specification** — Full API documentation
+- 🛡️ **SOCKS5 proxy support** — Outbound proxy for upstream provider calls
+- 🔌 **New endpoints** — `/v1/rerank`, `/v1/audio/*`, `/v1/moderations`
+- 📦 **npm CLI package** — `npm install -g omniroute` with auto-launch
+- 🐳 **Docker support** — Multi-stage Dockerfile with `base` and `cli` profiles
+- 🔒 **Security policy** — `SECURITY.md` with vulnerability reporting guidelines
+- 🧪 **CI/CD pipeline** — GitHub Actions for lint, build, test, and npm publish
+
+---
+
+[0.9.0]: https://github.com/diegosouzapw/OmniRoute/compare/v0.8.8...v0.9.0
+[0.8.8]: https://github.com/diegosouzapw/OmniRoute/compare/v0.8.5...v0.8.8
+[0.8.5]: https://github.com/diegosouzapw/OmniRoute/compare/v0.8.0...v0.8.5
+[0.8.0]: https://github.com/diegosouzapw/OmniRoute/compare/v0.7.0...v0.8.0
+[0.7.0]: https://github.com/diegosouzapw/OmniRoute/compare/v0.6.0...v0.7.0
+[0.6.0]: https://github.com/diegosouzapw/OmniRoute/compare/v0.5.0...v0.6.0
+[0.5.0]: https://github.com/diegosouzapw/OmniRoute/compare/v0.4.0...v0.5.0
+[0.4.0]: https://github.com/diegosouzapw/OmniRoute/compare/v0.3.0...v0.4.0
+[0.3.0]: https://github.com/diegosouzapw/OmniRoute/compare/v0.2.0...v0.3.0
+[0.2.0]: https://github.com/diegosouzapw/OmniRoute/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/diegosouzapw/OmniRoute/releases/tag/v0.1.0
@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="./docs/screenshots/MainOmniRoute.png" alt="OmniRoute Dashboard" width="800"/>
+  <img src="./images/omniroute.png" alt="OmniRoute Dashboard" width="800"/>
  
  # 🚀 OmniRoute — Das kostenlose AI-Gateway

@@ -242,7 +242,7 @@ docker compose --profile cli up -d
 | Image                    | Tag      | Größe  | Beschreibung             |
 | ------------------------ | -------- | ------ | ------------------------ |
 | `diegosouzapw/omniroute` | `latest` | ~250MB | Letztes stabiles Release |
-| `diegosouzapw/omniroute` | `1.0.0`  | ~250MB | Aktuelle Version         |
+| `diegosouzapw/omniroute` | `0.9.0`  | ~250MB | Aktuelle Version         |

 ---

@@ -892,7 +892,7 @@ Das vorgeladene „OmniRoute Golden Set" enthält 10 Testfälle:
 **Verbindungstest zeigt „Invalid" für OpenAI-kompatible Anbieter**

 - Viele Anbieter stellen den `/models` Endpoint nicht bereit
- OmniRoute v1.0.0+ enthält Fallback-Validierung via Chat Completions
+- OmniRoute v0.9.0+ enthält Fallback-Validierung via Chat Completions
 - Stelle sicher, dass die Base URL den `/v1` Suffix enthält

 </details>
@@ -902,7 +902,7 @@ Das vorgeladene „OmniRoute Golden Set" enthält 10 Testfälle:
 ## 🛠️ Technologie-Stack

 - **Runtime**: Node.js 20+
- **Sprache**: TypeScript 5.9 — **100% TypeScript** in `src/` und `open-sse/` (v1.0.0)
+- **Sprache**: TypeScript 5.9 — **100% TypeScript** in `src/` und `open-sse/` (v0.9.0)
 - **Framework**: Next.js 16 + React 19 + Tailwind CSS 4
 - **Datenbank**: LowDB (JSON) + SQLite (Domain-Status + Proxy-Logs)
 - **Streaming**: Server-Sent Events (SSE)
@@ -957,7 +957,7 @@ Siehe [CONTRIBUTING.md](CONTRIBUTING.md) für detaillierte Richtlinien.

 ```bash
 # Release erstellen — npm-Veröffentlichung erfolgt automatisch
-gh release create v1.0.0 --title "v1.0.0" --generate-notes
+gh release create v0.9.0 --title "v0.9.0" --generate-notes
 ```

 ---
@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="./docs/screenshots/MainOmniRoute.png" alt="OmniRoute Dashboard" width="800"/>
+  <img src="./images/omniroute.png" alt="OmniRoute Dashboard" width="800"/>
  
  # 🚀 OmniRoute — El Gateway de IA Gratuito

@@ -242,7 +242,7 @@ docker compose --profile cli up -d
 | Imagen                   | Tag      | Tamaño | Descripción            |
 | ------------------------ | -------- | ------ | ---------------------- |
 | `diegosouzapw/omniroute` | `latest` | ~250MB | Última versión estable |
-| `diegosouzapw/omniroute` | `1.0.0`  | ~250MB | Versión actual         |
+| `diegosouzapw/omniroute` | `0.9.0`  | ~250MB | Versión actual         |

 ---

@@ -892,7 +892,7 @@ El "OmniRoute Golden Set" precargado contiene 10 casos de prueba que cubren:
 **Prueba de conexión muestra "Invalid" para proveedores compatibles con OpenAI**

 - Muchos proveedores no exponen el endpoint `/models`
- OmniRoute v1.0.0+ incluye validación vía chat completions como fallback
+- OmniRoute v0.9.0+ incluye validación vía chat completions como fallback
 - Asegúrate de que la URL base incluya el sufijo `/v1`

 </details>
@@ -902,7 +902,7 @@ El "OmniRoute Golden Set" precargado contiene 10 casos de prueba que cubren:
 ## 🛠️ Stack Tecnológico

 - **Runtime**: Node.js 20+
- **Lenguaje**: TypeScript 5.9 — **100% TypeScript** en `src/` y `open-sse/` (v1.0.0)
+- **Lenguaje**: TypeScript 5.9 — **100% TypeScript** en `src/` y `open-sse/` (v0.9.0)
 - **Framework**: Next.js 16 + React 19 + Tailwind CSS 4
 - **Base de Datos**: LowDB (JSON) + SQLite (estado del dominio + logs de proxy)
 - **Streaming**: Server-Sent Events (SSE)
@@ -957,7 +957,7 @@ Consulta [CONTRIBUTING.md](CONTRIBUTING.md) para directrices detalladas.

 ```bash
 # Crea un release — la publicación en npm ocurre automáticamente
-gh release create v1.0.0 --title "v1.0.0" --generate-notes
+gh release create v0.9.0 --title "v0.9.0" --generate-notes
 ```

 ---
@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="./docs/screenshots/MainOmniRoute.png" alt="OmniRoute Dashboard" width="800"/>
+  <img src="./images/omniroute.png" alt="OmniRoute Dashboard" width="800"/>
  
  # 🚀 OmniRoute — La Passerelle IA Gratuite

@@ -242,7 +242,7 @@ docker compose --profile cli up -d
 | Image                    | Tag      | Taille | Description             |
 | ------------------------ | -------- | ------ | ----------------------- |
 | `diegosouzapw/omniroute` | `latest` | ~250MB | Dernière version stable |
-| `diegosouzapw/omniroute` | `1.0.0`  | ~250MB | Version actuelle        |
+| `diegosouzapw/omniroute` | `0.9.0`  | ~250MB | Version actuelle        |

 ---

@@ -892,7 +892,7 @@ Le « OmniRoute Golden Set » préchargé contient 10 cas de test :
 **Le test de connexion affiche « Invalid » pour les fournisseurs compatibles OpenAI**

 - Beaucoup de fournisseurs n'exposent pas le point de terminaison `/models`
- OmniRoute v1.0.0+ inclut une validation de secours via chat completions
+- OmniRoute v0.9.0+ inclut une validation de secours via chat completions
 - Assurez-vous que l'URL de base inclut le suffixe `/v1`

 </details>
@@ -902,7 +902,7 @@ Le « OmniRoute Golden Set » préchargé contient 10 cas de test :
 ## 🛠️ Stack technologique

 - **Runtime** : Node.js 20+
- **Langage** : TypeScript 5.9 — **100% TypeScript** dans `src/` et `open-sse/` (v1.0.0)
+- **Langage** : TypeScript 5.9 — **100% TypeScript** dans `src/` et `open-sse/` (v0.9.0)
 - **Framework** : Next.js 16 + React 19 + Tailwind CSS 4
 - **Base de données** : LowDB (JSON) + SQLite (état du domaine + logs proxy)
 - **Streaming** : Server-Sent Events (SSE)
@@ -957,7 +957,7 @@ Consultez [CONTRIBUTING.md](CONTRIBUTING.md) pour les directives détaillées.

 ```bash
 # Créer un release — la publication npm est automatique
-gh release create v1.0.0 --title "v1.0.0" --generate-notes
+gh release create v0.9.0 --title "v0.9.0" --generate-notes
 ```

 ---
@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="./docs/screenshots/MainOmniRoute.png" alt="OmniRoute Dashboard" width="800"/>
+  <img src="./images/omniroute.png" alt="OmniRoute Dashboard" width="800"/>
  
  # 🚀 OmniRoute — Il Gateway IA Gratuito

@@ -242,7 +242,7 @@ docker compose --profile cli up -d
 | Immagine                 | Tag      | Dimensione | Descrizione             |
 | ------------------------ | -------- | ---------- | ----------------------- |
 | `diegosouzapw/omniroute` | `latest` | ~250MB     | Ultima versione stabile |
-| `diegosouzapw/omniroute` | `1.0.0`  | ~250MB     | Versione attuale        |
+| `diegosouzapw/omniroute` | `0.9.0`  | ~250MB     | Versione attuale        |

 ---

@@ -892,7 +892,7 @@ Il "OmniRoute Golden Set" precaricato contiene 10 casi di test:
 **Il test di connessione mostra "Invalid" per provider compatibili OpenAI**

 - Molti provider non espongono l'endpoint `/models`
- OmniRoute v1.0.0+ include validazione fallback tramite chat completions
+- OmniRoute v0.9.0+ include validazione fallback tramite chat completions
 - Assicurati che la URL base includa il suffisso `/v1`

 </details>
@@ -902,7 +902,7 @@ Il "OmniRoute Golden Set" precaricato contiene 10 casi di test:
 ## 🛠️ Stack Tecnologico

 - **Runtime**: Node.js 20+
- **Linguaggio**: TypeScript 5.9 — **100% TypeScript** in `src/` e `open-sse/` (v1.0.0)
+- **Linguaggio**: TypeScript 5.9 — **100% TypeScript** in `src/` e `open-sse/` (v0.9.0)
 - **Framework**: Next.js 16 + React 19 + Tailwind CSS 4
 - **Database**: LowDB (JSON) + SQLite (stato dominio + log proxy)
 - **Streaming**: Server-Sent Events (SSE)
@@ -957,7 +957,7 @@ Consulta [CONTRIBUTING.md](CONTRIBUTING.md) per le linee guida dettagliate.

 ```bash
 # Crea un rilascio — la pubblicazione npm avviene automaticamente
-gh release create v1.0.0 --title "v1.0.0" --generate-notes
+gh release create v0.9.0 --title "v0.9.0" --generate-notes
 ```

 ---
@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="./docs/screenshots/MainOmniRoute.png" alt="OmniRoute Dashboard" width="800"/>
+  <img src="./images/omniroute.png" alt="OmniRoute Dashboard" width="800"/>
  
  # 🚀 OmniRoute — The Free AI Gateway

@@ -242,7 +242,7 @@ docker compose --profile cli up -d
 | Image                    | Tag      | Size   | Description           |
 | ------------------------ | -------- | ------ | --------------------- |
 | `diegosouzapw/omniroute` | `latest` | ~250MB | Latest stable release |
-| `diegosouzapw/omniroute` | `1.0.0`  | ~250MB | Current version       |
+| `diegosouzapw/omniroute` | `0.9.0`  | ~250MB | Current version       |

 ---

@@ -396,7 +396,7 @@ Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
 | 🔑 **API Key Management**  | Generate, rotate, and scope API keys per provider                     |
 | 🧙 **Onboarding Wizard**   | 4-step guided setup for first-time users                              |
 | 🔧 **CLI Tools Dashboard** | One-click configure Claude, Codex, Cline, OpenClaw, Kilo, Antigravity |
-| 🔄 **DB Backups**          | Automatic backup, restore, export & import for all settings           |
+| 🔄 **DB Backups**          | Automatic backup and restore for all settings                         |

 <details>
 <summary><b>📖 Feature Details</b></summary>
@@ -459,16 +459,9 @@ Seamless translation between formats:

 ### 🔧 Translator Playground

-OmniRoute includes a powerful built-in Translator Playground with **4 modes** for debugging, testing, and monitoring API translations:
-
-| Mode                | Description                                                                                                                                                                                                                     |
-| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **💻 Playground**   | Direct format translation — paste any API request body and instantly see how OmniRoute translates it between provider formats (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). Includes example templates and format auto-detection. |
-| **💬 Chat Tester**  | Send real chat requests through OmniRoute and see the full round-trip: your input, the translated request, the provider response, and the translated response back. Invaluable for validating combo routing.                    |
-| **🧪 Test Bench**   | Batch testing mode — define multiple test cases with different inputs and expected outputs, run them all at once, and compare results across providers and models.                                                              |
-| **📱 Live Monitor** | Real-time request monitoring — watch incoming requests as they flow through OmniRoute, see format translations happening live, and identify issues instantly.                                                                   |
-
-**Access:** Dashboard → Translator (sidebar)
+- Debug, test, and visualize API format translations
+- Send requests and see how OmniRoute translates between provider formats
+- Invaluable for troubleshooting integration issues

 ### 💾 Cloud Sync

@@ -899,7 +892,7 @@ The pre-loaded "OmniRoute Golden Set" contains 10 test cases covering:
 **Connection test shows "Invalid" for OpenAI-compatible providers**

 - Many providers don't expose a `/models` endpoint
- OmniRoute v1.0.0+ includes fallback validation via chat completions
+- OmniRoute v0.9.0+ includes fallback validation via chat completions
 - Ensure base URL includes `/v1` suffix

 </details>
@@ -909,7 +902,7 @@ The pre-loaded "OmniRoute Golden Set" contains 10 test cases covering:
 ## 🛠️ Tech Stack

 - **Runtime**: Node.js 20+
- **Language**: TypeScript 5.9 — **100% TypeScript** across `src/` and `open-sse/` (v1.0.0)
+- **Language**: TypeScript 5.9 — **100% TypeScript** across `src/` and `open-sse/` (v0.9.0)
 - **Framework**: Next.js 16 + React 19 + Tailwind CSS 4
 - **Database**: LowDB (JSON) + SQLite (domain state + proxy logs)
 - **Streaming**: Server-Sent Events (SSE)
@@ -925,61 +918,15 @@ The pre-loaded "OmniRoute Golden Set" contains 10 test cases covering:

 ## 📖 Documentation

-| Document                                     | Description                                    |
-| -------------------------------------------- | ---------------------------------------------- |
-| [User Guide](docs/USER_GUIDE.md)             | Providers, combos, CLI integration, deployment |
-| [API Reference](docs/API_REFERENCE.md)       | All endpoints with examples                    |
-| [Troubleshooting](docs/TROUBLESHOOTING.md)   | Common problems and solutions                  |
-| [Architecture](docs/ARCHITECTURE.md)         | System architecture and internals              |
-| [Contributing](CONTRIBUTING.md)              | Development setup and guidelines               |
-| [OpenAPI Spec](docs/openapi.yaml)            | OpenAPI 3.0 specification                      |
-| [Security Policy](SECURITY.md)               | Vulnerability reporting and security practices |
-| [VM Deployment](docs/VM_DEPLOYMENT_GUIDE.md) | Complete guide: VM + nginx + Cloudflare setup  |
-| [Features Gallery](docs/FEATURES.md)         | Visual dashboard tour with screenshots         |
-
-### 📸 Dashboard Preview
-
-<details>
-<summary><b>Click to see dashboard screenshots</b></summary>
-
-| Page           | Screenshot                                        |
-| -------------- | ------------------------------------------------- |
-| **Providers**  | ![Providers](docs/screenshots/01-providers.png)   |
-| **Combos**     | ![Combos](docs/screenshots/02-combos.png)         |
-| **Analytics**  | ![Analytics](docs/screenshots/03-analytics.png)   |
-| **Health**     | ![Health](docs/screenshots/04-health.png)         |
-| **Translator** | ![Translator](docs/screenshots/05-translator.png) |
-| **Settings**   | ![Settings](docs/screenshots/06-settings.png)     |
-| **CLI Tools**  | ![CLI Tools](docs/screenshots/07-cli-tools.png)   |
-| **Usage Logs** | ![Usage](docs/screenshots/08-usage.png)           |
-| **Endpoint**   | ![Endpoint](docs/screenshots/09-endpoint.png)     |
-
-</details>
-
---
-
-## 🗺️ Roadmap
-
-OmniRoute has **210+ features planned** across multiple development phases. Here are the key areas:
-
-| Category                      | Planned Features | Highlights                                                                             |
-| ----------------------------- | ---------------- | -------------------------------------------------------------------------------------- |
-| 🧠 **Routing & Intelligence** | 25+              | Lowest-latency routing, tag-based routing, quota preflight, P2C account selection      |
-| 🔒 **Security & Compliance**  | 20+              | SSRF hardening, credential cloaking, rate-limit per endpoint, management key scoping   |
-| 📊 **Observability**          | 15+              | OpenTelemetry integration, real-time quota monitoring, cost tracking per model         |
-| 🔄 **Provider Integrations**  | 20+              | Dynamic model registry, provider cooldowns, multi-account Codex, Copilot quota parsing |
-| ⚡ **Performance**            | 15+              | Dual cache layer, prompt cache, response cache, streaming keepalive, batch API         |
-| 🌐 **Ecosystem**              | 10+              | WebSocket API, config hot-reload, distributed config store, commercial mode            |
-
-### 🔜 Coming Soon
-
- 🔗 **OpenCode Integration** — Native provider support for the OpenCode AI coding IDE
- 🔗 **TRAE Integration** — Full support for the TRAE AI development framework
- 📦 **Batch API** — Asynchronous batch processing for bulk requests
- 🎯 **Tag-Based Routing** — Route requests based on custom tags and metadata
- 💰 **Lowest-Cost Strategy** — Automatically select the cheapest available provider
-
-> 📝 Full feature specifications available in [`docs/new-features/`](docs/new-features/) (217 detailed specs)
+| Document                                   | Description                                    |
+| ------------------------------------------ | ---------------------------------------------- |
+| [User Guide](docs/USER_GUIDE.md)           | Providers, combos, CLI integration, deployment |
+| [API Reference](docs/API_REFERENCE.md)     | All endpoints with examples                    |
+| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common problems and solutions                  |
+| [Architecture](docs/ARCHITECTURE.md)       | System architecture and internals              |
+| [Contributing](CONTRIBUTING.md)            | Development setup and guidelines               |
+| [OpenAPI Spec](docs/openapi.yaml)          | OpenAPI 3.0 specification                      |
+| [Security Policy](SECURITY.md)             | Vulnerability reporting and security practices |

 ---

@@ -1010,7 +957,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.

 ```bash
 # Create a release — npm publish happens automatically
-gh release create v1.0.0 --title "v1.0.0" --generate-notes
+gh release create v0.9.0 --title "v0.9.0" --generate-notes
 ```

 ---
@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="./docs/screenshots/MainOmniRoute.png" alt="OmniRoute Dashboard" width="800"/>
+  <img src="./images/omniroute.png" alt="OmniRoute Dashboard" width="800"/>
  
  # 🚀 OmniRoute — O Gateway de IA Gratuito

@@ -242,7 +242,7 @@ docker compose --profile cli up -d
 | Imagem                   | Tag      | Tamanho | Descrição             |
 | ------------------------ | -------- | ------- | --------------------- |
 | `diegosouzapw/omniroute` | `latest` | ~250MB  | Última versão estável |
-| `diegosouzapw/omniroute` | `1.0.0`  | ~250MB  | Versão atual          |
+| `diegosouzapw/omniroute` | `0.9.0`  | ~250MB  | Versão atual          |

 ---

@@ -389,14 +389,14 @@ Acesso via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...

 ### ☁️ Deploy e Sincronização

-| Funcionalidade                    | O que Faz                                                                         |
-| --------------------------------- | --------------------------------------------------------------------------------- |
-| 💾 **Cloud Sync**                 | Sincronize configurações entre dispositivos via Cloudflare Workers                |
-| 🌐 **Deploy em Qualquer Lugar**   | Localhost, VPS, Docker, Cloudflare Workers                                        |
-| 🔑 **Gestão de API Keys**         | Gere, rotacione e defina escopo de API keys por provedor                          |
-| 🧙 **Assistente de Configuração** | Setup guiado em 4 etapas para novos usuários                                      |
-| 🔧 **Dashboard CLI Tools**        | Configuração em um clique para Claude, Codex, Cline, OpenClaw, Kilo, Antigravity  |
-| 🔄 **Backups de DB**              | Backup, restauração, exportação e importação automática de todas as configurações |
+| Funcionalidade                    | O que Faz                                                                        |
+| --------------------------------- | -------------------------------------------------------------------------------- |
+| 💾 **Cloud Sync**                 | Sincronize configurações entre dispositivos via Cloudflare Workers               |
+| 🌐 **Deploy em Qualquer Lugar**   | Localhost, VPS, Docker, Cloudflare Workers                                       |
+| 🔑 **Gestão de API Keys**         | Gere, rotacione e defina escopo de API keys por provedor                         |
+| 🧙 **Assistente de Configuração** | Setup guiado em 4 etapas para novos usuários                                     |
+| 🔧 **Dashboard CLI Tools**        | Configuração em um clique para Claude, Codex, Cline, OpenClaw, Kilo, Antigravity |
+| 🔄 **Backups de DB**              | Backup e restauração automáticos de todas as configurações                       |

 <details>
 <summary><b>📖 Detalhes das Funcionalidades</b></summary>
@@ -459,16 +459,9 @@ Tradução transparente entre formatos:

 ### 🔧 Playground do Tradutor

-O OmniRoute inclui um poderoso Playground de Tradução integrado com **4 modos** para debug, teste e monitoramento de traduções de API:
-
-| Modo                | Descrição                                                                                                                                                                                                                             |
-| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **💻 Playground**   | Tradução direta entre formatos — cole qualquer corpo de requisição e veja instantaneamente como o OmniRoute traduz entre formatos (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). Inclui templates de exemplo e auto-detecção de formato. |
-| **💬 Chat Tester**  | Envie requisições reais pelo OmniRoute e veja a viagem completa: sua entrada, a requisição traduzida, a resposta do provedor, e a resposta traduzida de volta. Inestimável para validar roteamento de combos.                         |
-| **🧪 Test Bench**   | Modo de teste em lote — defina múltiplos casos de teste com diferentes entradas e saídas esperadas, execute todos de uma vez, e compare resultados entre provedores e modelos.                                                        |
-| **📱 Live Monitor** | Monitoramento de requisições em tempo real — acompanhe requisições entrando conforme fluem pelo OmniRoute, veja traduções de formato acontecendo ao vivo, e identifique problemas instantaneamente.                                   |
-
-**Acesso:** Dashboard → Translator (barra lateral)
+- Debug, teste e visualize traduções de formato de API
+- Envie requisições e veja como o OmniRoute traduz entre formatos de provedores
+- Inestimável para troubleshooting de problemas de integração

 ### 💾 Cloud Sync

@@ -899,7 +892,7 @@ O "OmniRoute Golden Set" pré-carregado contém 10 casos de teste cobrindo:
 **Teste de conexão mostra "Invalid" para provedores compatíveis com OpenAI**

 - Muitos provedores não expõem endpoint `/models`
- OmniRoute v1.0.0+ inclui validação via chat completions como fallback
+- OmniRoute v0.9.0+ inclui validação via chat completions como fallback
 - Certifique-se de que a base URL inclui sufixo `/v1`

 </details>
@@ -909,7 +902,7 @@ O "OmniRoute Golden Set" pré-carregado contém 10 casos de teste cobrindo:
 ## 🛠️ Stack Tecnológico

 - **Runtime**: Node.js 20+
- **Linguagem**: TypeScript 5.9 — **100% TypeScript** em `src/` e `open-sse/` (v1.0.0)
+- **Linguagem**: TypeScript 5.9 — **100% TypeScript** em `src/` e `open-sse/` (v0.9.0)
 - **Framework**: Next.js 16 + React 19 + Tailwind CSS 4
 - **Banco de Dados**: LowDB (JSON) + SQLite (estado do domínio + logs de proxy)
 - **Streaming**: Server-Sent Events (SSE)
@@ -934,52 +927,6 @@ O "OmniRoute Golden Set" pré-carregado contém 10 casos de teste cobrindo:
 | [Contribuindo](CONTRIBUTING.md)                 | Setup de desenvolvimento e diretrizes             |
 | [Spec OpenAPI](docs/openapi.yaml)               | Especificação OpenAPI 3.0                         |
 | [Política de Segurança](SECURITY.md)            | Reportar vulnerabilidades e práticas de segurança |
-| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md)     | Guia completo: VM + nginx + Cloudflare            |
-| [Galeria de Features](docs/FEATURES.md)         | Tour visual do dashboard com screenshots          |
-
-### 📸 Preview do Dashboard
-
-<details>
-<summary><b>Clique para ver screenshots do dashboard</b></summary>
-
-| Página            | Screenshot                                        |
-| ----------------- | ------------------------------------------------- |
-| **Provedores**    | ![Providers](docs/screenshots/01-providers.png)   |
-| **Combos**        | ![Combos](docs/screenshots/02-combos.png)         |
-| **Analytics**     | ![Analytics](docs/screenshots/03-analytics.png)   |
-| **Saúde**         | ![Health](docs/screenshots/04-health.png)         |
-| **Tradutor**      | ![Translator](docs/screenshots/05-translator.png) |
-| **Configurações** | ![Settings](docs/screenshots/06-settings.png)     |
-| **CLI Tools**     | ![CLI Tools](docs/screenshots/07-cli-tools.png)   |
-| **Logs de Uso**   | ![Usage](docs/screenshots/08-usage.png)           |
-| **Endpoint**      | ![Endpoint](docs/screenshots/09-endpoint.png)     |
-
-</details>
-
---
-
-## 🗺️ Roadmap
-
-O OmniRoute tem **210+ funcionalidades planejadas** em múltiplas fases de desenvolvimento. Áreas principais:
-
-| Categoria                        | Features Planejadas | Destaques                                                                   |
-| -------------------------------- | ------------------- | --------------------------------------------------------------------------- |
-| 🧠 **Roteamento e Inteligência** | 25+                 | Roteamento por menor latência, roteamento por tags, pré-verificação de cota |
-| 🔒 **Segurança e Compliance**    | 20+                 | Hardening SSRF, cloaking de credenciais, rate-limit por endpoint            |
-| 📊 **Observabilidade**           | 15+                 | Integração OpenTelemetry, monitoramento de cota em tempo real               |
-| 🔄 **Integrações**               | 20+                 | Registro dinâmico de modelos, cooldowns de provedor                         |
-| ⚡ **Performance**               | 15+                 | Cache dupla camada, prompt cache, response cache, batch API                 |
-| 🌐 **Ecossistema**               | 10+                 | WebSocket API, config hot-reload, modo comercial                            |
-
-### 🔜 Em Breve
-
- 🔗 **Integração com OpenCode** — Suporte nativo como provider para a IDE OpenCode
- 🔗 **Integração com TRAE** — Suporte completo ao framework de desenvolvimento TRAE
- 📦 **Batch API** — Processamento assíncrono em lote para requisições em massa
- 🎯 **Roteamento por Tags** — Roteamento de requisições baseado em tags personalizadas
- 💰 **Estratégia de Menor Custo** — Seleção automática do provedor mais barato
-
-> 📝 Especificações completas de features disponíveis em [`docs/new-features/`](docs/new-features/) (217 specs detalhadas)

 ---

@@ -1010,7 +957,7 @@ Veja [CONTRIBUTING.md](CONTRIBUTING.md) para diretrizes detalhadas.

 ```bash
 # Crie um release — publicação no npm acontece automaticamente
-gh release create v1.0.0 --title "v1.0.0" --generate-notes
+gh release create v0.9.0 --title "v0.9.0" --generate-notes
 ```

 ---
@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="./docs/screenshots/MainOmniRoute.png" alt="OmniRoute Dashboard" width="800"/>
+  <img src="./images/omniroute.png" alt="OmniRoute Dashboard" width="800"/>
  
  # 🚀 OmniRoute — Бесплатный AI Gateway

@@ -242,7 +242,7 @@ docker compose --profile cli up -d
 | Образ                    | Тег      | Размер | Описание                   |
 | ------------------------ | -------- | ------ | -------------------------- |
 | `diegosouzapw/omniroute` | `latest` | ~250MB | Последний стабильный релиз |
-| `diegosouzapw/omniroute` | `1.0.0`  | ~250MB | Текущая версия             |
+| `diegosouzapw/omniroute` | `0.9.0`  | ~250MB | Текущая версия             |

 ---

@@ -892,7 +892,7 @@ OmniRoute включает встроенный фреймворк оценки
 **Тест подключения показывает «Invalid» для OpenAI-совместимых провайдеров**

 - Многие провайдеры не предоставляют endpoint `/models`
- OmniRoute v1.0.0+ включает fallback-валидацию через chat completions
+- OmniRoute v0.9.0+ включает fallback-валидацию через chat completions
 - Убедитесь что base URL содержит суффикс `/v1`

 </details>
@@ -902,7 +902,7 @@ OmniRoute включает встроенный фреймворк оценки
 ## 🛠️ Технологический стек

 - **Runtime**: Node.js 20+
- **Язык**: TypeScript 5.9 — **100% TypeScript** в `src/` и `open-sse/` (v1.0.0)
+- **Язык**: TypeScript 5.9 — **100% TypeScript** в `src/` и `open-sse/` (v0.9.0)
 - **Framework**: Next.js 16 + React 19 + Tailwind CSS 4
 - **База данных**: LowDB (JSON) + SQLite (состояние домена + proxy-логи)
 - **Стриминг**: Server-Sent Events (SSE)
@@ -957,7 +957,7 @@ OmniRoute включает встроенный фреймворк оценки

 ```bash
 # Создайте релиз — публикация в npm происходит автоматически
-gh release create v1.0.0 --title "v1.0.0" --generate-notes
+gh release create v0.9.0 --title "v0.9.0" --generate-notes
 ```

 ---
@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="./docs/screenshots/MainOmniRoute.png" alt="OmniRoute Dashboard" width="800"/>
+  <img src="./images/omniroute.png" alt="OmniRoute Dashboard" width="800"/>
  
  # 🚀 OmniRoute — 免费 AI 网关

@@ -242,7 +242,7 @@ docker compose --profile cli up -d
 | 镜像                     | 标签     | 大小   | 描述       |
 | ------------------------ | -------- | ------ | ---------- |
 | `diegosouzapw/omniroute` | `latest` | ~250MB | 最新稳定版 |
-| `diegosouzapw/omniroute` | `1.0.0`  | ~250MB | 当前版本   |
+| `diegosouzapw/omniroute` | `0.9.0`  | ~250MB | 当前版本   |

 ---

@@ -892,7 +892,7 @@ OmniRoute 包含内置评估框架，用于针对黄金集测试 LLM 响应质
 **兼容 OpenAI 的提供商连接测试显示 "Invalid"**

 - 许多提供商不暴露 `/models` 端点
- OmniRoute v1.0.0+ 包含通过 chat completions 的回退验证
+- OmniRoute v0.9.0+ 包含通过 chat completions 的回退验证
 - 确保 base URL 包含 `/v1` 后缀

 </details>
@@ -902,7 +902,7 @@ OmniRoute 包含内置评估框架，用于针对黄金集测试 LLM 响应质
 ## 🛠️ 技术栈

 - **运行时**: Node.js 20+
- **语言**: TypeScript 5.9 — `src/` 和 `open-sse/` 中 **100% TypeScript**（v1.0.0）
+- **语言**: TypeScript 5.9 — `src/` 和 `open-sse/` 中 **100% TypeScript**（v0.9.0）
 - **框架**: Next.js 16 + React 19 + Tailwind CSS 4
 - **数据库**: LowDB (JSON) + SQLite（领域状态 + 代理日志）
 - **流式传输**: Server-Sent Events (SSE)
@@ -957,7 +957,7 @@ OmniRoute 包含内置评估框架，用于针对黄金集测试 LLM 响应质

 ```bash
 # 创建发布 — npm 发布自动完成
-gh release create v1.0.0 --title "v1.0.0" --generate-notes
+gh release create v0.9.0 --title "v0.9.0" --generate-notes
 ```

 ---
@@ -227,17 +227,6 @@ Response example:
 | `/api/monitoring/health` | GET        | Health check            |
 | `/api/cache`             | GET/DELETE | Cache stats / clear     |

-### Backup & Export/Import
-
-| Endpoint                    | Method | Description                             |
-| --------------------------- | ------ | --------------------------------------- |
-| `/api/db-backups`           | GET    | List available backups                  |
-| `/api/db-backups`           | PUT    | Create a manual backup                  |
-| `/api/db-backups`           | POST   | Restore from a specific backup          |
-| `/api/db-backups/export`    | GET    | Download database as .sqlite file       |
-| `/api/db-backups/import`    | POST   | Upload .sqlite file to replace database |
-| `/api/db-backups/exportAll` | GET    | Download full backup as .tar.gz archive |
-
 ### Cloud Sync

 | Endpoint               | Method  | Description           |
@@ -1,75 +0,0 @@
-# OmniRoute — Dashboard Features Gallery
-
-Visual guide to every section of the OmniRoute dashboard.
-
---
-
-## 🔌 Providers
-
-Manage AI provider connections: OAuth providers (Claude Code, Codex, Gemini CLI), API key providers (Groq, DeepSeek, OpenRouter), and free providers (iFlow, Qwen, Kiro).
-
-![Providers Dashboard](screenshots/01-providers.png)
-
---
-
-## 🎨 Combos
-
-Create model routing combos with 6 strategies: fill-first, round-robin, power-of-two-choices, random, least-used, and cost-optimized. Each combo chains multiple models with automatic fallback.
-
-![Combos Dashboard](screenshots/02-combos.png)
-
---
-
-## 📊 Analytics
-
-Comprehensive usage analytics with token consumption, cost estimates, activity heatmaps, weekly distribution charts, and per-provider breakdowns.
-
-![Analytics Dashboard](screenshots/03-analytics.png)
-
---
-
-## 🏥 System Health
-
-Real-time monitoring: uptime, memory, version, latency percentiles (p50/p95/p99), cache statistics, and provider circuit breaker states.
-
-![Health Dashboard](screenshots/04-health.png)
-
---
-
-## 🔧 Translator Playground
-
-Four modes for debugging API translations: **Playground** (format converter), **Chat Tester** (live requests), **Test Bench** (batch tests), and **Live Monitor** (real-time stream).
-
-![Translator Playground](screenshots/05-translator.png)
-
---
-
-## ⚙️ Settings
-
-General settings, system storage, backup management (export/import database), appearance (dark/light mode), security, routing, resilience, and advanced configuration.
-
-![Settings Dashboard](screenshots/06-settings.png)
-
---
-
-## 🔧 CLI Tools
-
-One-click configuration for AI coding tools: Claude Code, Codex CLI, Gemini CLI, OpenClaw, Kilo Code, and Antigravity.
-
-![CLI Tools Dashboard](screenshots/07-cli-tools.png)
-
---
-
-## 📝 Request Logs
-
-Real-time request logging with filtering by provider, model, account, and API key. Shows status codes, token usage, latency, and response details.
-
-![Usage Logs](screenshots/08-usage.png)
-
---
-
-## 🌐 API Endpoint
-
-Your unified API endpoint with capability breakdown: Chat Completions, Embeddings, Image Generation, Reranking, Audio Transcription, and registered API keys.
-
-![Endpoint Dashboard](screenshots/09-endpoint.png)
@@ -572,38 +572,6 @@ OmniRoute implements provider-level resilience with four components:

 ---

-### Database Export / Import
-
-Manage database backups in **Dashboard → Settings → System & Storage**.
-
-| Action                   | Description                                                                                                                    |
-| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
-| **Export Database**      | Downloads the current SQLite database as a `.sqlite` file                                                                      |
-| **Export All (.tar.gz)** | Downloads a full backup archive including: database, settings, combos, provider connections (no credentials), API key metadata |
-| **Import Database**      | Upload a `.sqlite` file to replace the current database. A pre-import backup is automatically created                          |
-
-```bash
-# API: Export database
-curl -o backup.sqlite http://localhost:20128/api/db-backups/export
-
-# API: Export all (full archive)
-curl -o backup.tar.gz http://localhost:20128/api/db-backups/exportAll
-
-# API: Import database
-curl -X POST http://localhost:20128/api/db-backups/import \
-  -F "file=@backup.sqlite"
-```
-
-**Import Validation:** The imported file is validated for integrity (SQLite pragma check), required tables (`provider_connections`, `provider_nodes`, `combos`, `api_keys`), and size (max 100MB).
-
-**Use Cases:**
-
- Migrate OmniRoute between machines
- Create external backups for disaster recovery
- Share configurations between team members (export all → share archive)
-
---
-
 ### Settings Dashboard

 The settings page is organized into 5 tabs for easy navigation:
@@ -1,399 +0,0 @@
-# OmniRoute — Guia de Deploy em VM com Cloudflare
-
-Guia completo para instalar e configurar o OmniRoute em uma VM (VPS) com domínio gerenciado via Cloudflare.
-
---
-
-## Pré-Requisitos
-
-| Item        | Mínimo                   | Recomendado      |
-| ----------- | ------------------------ | ---------------- |
-| **CPU**     | 1 vCPU                   | 2 vCPU           |
-| **RAM**     | 1 GB                     | 2 GB             |
-| **Disco**   | 10 GB SSD                | 25 GB SSD        |
-| **SO**      | Ubuntu 22.04 LTS         | Ubuntu 24.04 LTS |
-| **Domínio** | Registrado no Cloudflare | —                |
-| **Docker**  | Docker Engine 24+        | Docker 27+       |
-
-**Providers testados**: Akamai (Linode), DigitalOcean, Vultr, Hetzner, AWS Lightsail.
-
---
-
-## 1. Configurar a VM
-
-### 1.1 Criar a instância
-
-No seu provider de VPS preferido:
-
- Escolha Ubuntu 24.04 LTS
- Selecione o plano mínimo (1 vCPU / 1 GB RAM)
- Defina uma senha forte para root ou configure SSH key
- Anote o **IP público** (ex: `203.0.113.10`)
-
-### 1.2 Conectar via SSH
-
-```bash
-ssh root@203.0.113.10
-```
-
-### 1.3 Atualizar o sistema
-
-```bash
-apt update && apt upgrade -y
-```
-
-### 1.4 Instalar Docker
-
-```bash
-# Instalar dependências
-apt install -y ca-certificates curl gnupg
-
-# Adicionar repositório oficial do Docker
-install -m 0755 -d /etc/apt/keyrings
-curl -fsSL https://download.docker.com/linux/ubuntu/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg
-chmod a+r /etc/apt/keyrings/docker.gpg
-echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null
-apt update
-apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
-```
-
-### 1.5 Instalar nginx
-
-```bash
-apt install -y nginx
-```
-
-### 1.6 Configurar Firewall (UFW)
-
-```bash
-ufw default deny incoming
-ufw default allow outgoing
-ufw allow 22/tcp    # SSH
-ufw allow 80/tcp    # HTTP (redirect)
-ufw allow 443/tcp   # HTTPS
-ufw enable
-```
-
-> **Dica**: Para segurança máxima, restrinja as portas 80 e 443 apenas para IPs da Cloudflare. Veja a seção [Segurança Avançada](#segurança-avançada).
-
---
-
-## 2. Instalar o OmniRoute
-
-### 2.1 Criar diretório de configuração
-
-```bash
-mkdir -p /opt/omniroute
-```
-
-### 2.2 Criar arquivo de variáveis de ambiente
-
-```bash
-cat > /opt/omniroute/.env << 'EOF'
-# === Segurança ===
-JWT_SECRET=ALTERE-PARA-CHAVE-SECRETA-UNICA-64-CHARS
-INITIAL_PASSWORD=SuaSenhaSegura123!
-API_KEY_SECRET=ALTERE-PARA-OUTRA-CHAVE-SECRETA
-STORAGE_ENCRYPTION_KEY=ALTERE-PARA-TERCEIRA-CHAVE-SECRETA
-STORAGE_ENCRYPTION_KEY_VERSION=v1
-MACHINE_ID_SALT=ALTERE-PARA-SALT-UNICO
-
-# === App ===
-PORT=20128
-NODE_ENV=production
-HOSTNAME=0.0.0.0
-DATA_DIR=/app/data
-STORAGE_DRIVER=sqlite
-ENABLE_REQUEST_LOGS=true
-AUTH_COOKIE_SECURE=false
-REQUIRE_API_KEY=false
-
-# === Domain (altere para seu domínio) ===
-BASE_URL=https://llms.seudominio.com
-NEXT_PUBLIC_BASE_URL=https://llms.seudominio.com
-
-# === Cloud Sync (opcional) ===
-# CLOUD_URL=https://cloud.omniroute.online
-# NEXT_PUBLIC_CLOUD_URL=https://cloud.omniroute.online
-EOF
-```
-
-> ⚠️ **IMPORTANTE**: Gere chaves secretas únicas! Use `openssl rand -hex 32` para cada chave.
-
-### 2.3 Iniciar o container
-
-```bash
-docker pull diegosouzapw/omniroute:latest
-
-docker run -d \
-  --name omniroute \
-  --restart unless-stopped \
-  --env-file /opt/omniroute/.env \
-  -p 20128:20128 \
-  -v omniroute-data:/app/data \
-  diegosouzapw/omniroute:latest
-```
-
-### 2.4 Verificar se está rodando
-
-```bash
-docker ps | grep omniroute
-docker logs omniroute --tail 20
-```
-
-Deve exibir: `[DB] SQLite database ready` e `listening on port 20128`.
-
---
-
-## 3. Configurar nginx (Reverse Proxy)
-
-### 3.1 Gerar certificado SSL (Cloudflare Origin)
-
-No painel da Cloudflare:
-
-1. Vá em **SSL/TLS → Origin Server**
-2. Clique **Create Certificate**
-3. Deixe os padrões (15 anos, \*.seudominio.com)
-4. Copie o **Origin Certificate** e a **Private Key**
-
-```bash
-mkdir -p /etc/nginx/ssl
-
-# Colar o certificado
-nano /etc/nginx/ssl/origin.crt
-
-# Colar a chave privada
-nano /etc/nginx/ssl/origin.key
-
-chmod 600 /etc/nginx/ssl/origin.key
-```
-
-### 3.2 Configuração do nginx
-
-```bash
-cat > /etc/nginx/sites-available/omniroute << 'NGINX'
-# Default server — bloqueia acesso direto por IP
-server {
-    listen 80 default_server;
-    listen [::]:80 default_server;
-    listen 443 ssl default_server;
-    listen [::]:443 ssl default_server;
-    ssl_certificate     /etc/nginx/ssl/origin.crt;
-    ssl_certificate_key /etc/nginx/ssl/origin.key;
-    server_name _;
-    return 444;
-}
-
-# OmniRoute — HTTPS
-server {
-    listen 443 ssl;
-    listen [::]:443 ssl;
-    server_name llms.seudominio.com;  # Altere para seu domínio
-
-    ssl_certificate     /etc/nginx/ssl/origin.crt;
-    ssl_certificate_key /etc/nginx/ssl/origin.key;
-    ssl_protocols TLSv1.2 TLSv1.3;
-
-    client_max_body_size 100M;
-
-    location / {
-        proxy_pass http://127.0.0.1:20128;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-
-        # WebSocket support
-        proxy_http_version 1.1;
-        proxy_set_header Upgrade $http_upgrade;
-        proxy_set_header Connection "upgrade";
-
-        # SSE (Server-Sent Events) — streaming AI responses
-        proxy_buffering off;
-        proxy_cache off;
-        proxy_read_timeout 300s;
-        proxy_send_timeout 300s;
-    }
-}
-
-# HTTP → HTTPS redirect
-server {
-    listen 80;
-    listen [::]:80;
-    server_name llms.seudominio.com;
-    return 301 https://$server_name$request_uri;
-}
-NGINX
-```
-
-### 3.3 Ativar e testar
-
-```bash
-# Remover config padrão
-rm -f /etc/nginx/sites-enabled/default
-
-# Ativar OmniRoute
-ln -sf /etc/nginx/sites-available/omniroute /etc/nginx/sites-enabled/omniroute
-
-# Testar e recarregar
-nginx -t && systemctl reload nginx
-```
-
---
-
-## 4. Configurar Cloudflare DNS
-
-### 4.1 Adicionar registro DNS
-
-No painel da Cloudflare → DNS:
-
-| Type | Name   | Content                   | Proxy      |
-| ---- | ------ | ------------------------- | ---------- |
-| A    | `llms` | `203.0.113.10` (IP da VM) | ✅ Proxied |
-
-### 4.2 Configurar SSL
-
-Em **SSL/TLS → Overview**:
-
- Modo: **Full (Strict)**
-
-Em **SSL/TLS → Edge Certificates**:
-
- Always Use HTTPS: ✅ On
- Minimum TLS Version: TLS 1.2
- Automatic HTTPS Rewrites: ✅ On
-
-### 4.3 Testar
-
-```bash
-curl -sI https://llms.seudominio.com/health
-# Deve retornar HTTP/2 200
-```
-
---
-
-## 5. Operações e Manutenção
-
-### Atualizar para nova versão
-
-```bash
-docker pull diegosouzapw/omniroute:latest
-docker stop omniroute && docker rm omniroute
-docker run -d --name omniroute --restart unless-stopped \
-  --env-file /opt/omniroute/.env \
-  -p 20128:20128 \
-  -v omniroute-data:/app/data \
-  diegosouzapw/omniroute:latest
-```
-
-### Ver logs
-
-```bash
-docker logs -f omniroute          # Stream em tempo real
-docker logs omniroute --tail 50   # Últimas 50 linhas
-```
-
-### Backup manual do banco
-
-```bash
-# Copiar dados do volume para o host
-docker cp omniroute:/app/data ./backup-$(date +%F)
-
-# Ou comprimir todo o volume
-docker run --rm -v omniroute-data:/data -v $(pwd):/backup \
-  alpine tar czf /backup/omniroute-data-$(date +%F).tar.gz /data
-```
-
-### Restaurar de backup
-
-```bash
-docker stop omniroute
-docker run --rm -v omniroute-data:/data -v $(pwd):/backup \
-  alpine sh -c "rm -rf /data/* && tar xzf /backup/omniroute-data-YYYY-MM-DD.tar.gz -C /"
-docker start omniroute
-```
-
---
-
-## 6. Segurança Avançada
-
-### Restringir nginx para Cloudflare IPs
-
-```bash
-cat > /etc/nginx/cloudflare-ips.conf << 'CF'
-# Cloudflare IPv4 ranges — atualizar periodicamente
-# https://www.cloudflare.com/ips-v4/
-set_real_ip_from 173.245.48.0/20;
-set_real_ip_from 103.21.244.0/22;
-set_real_ip_from 103.22.200.0/22;
-set_real_ip_from 103.31.4.0/22;
-set_real_ip_from 141.101.64.0/18;
-set_real_ip_from 108.162.192.0/18;
-set_real_ip_from 190.93.240.0/20;
-set_real_ip_from 188.114.96.0/20;
-set_real_ip_from 197.234.240.0/22;
-set_real_ip_from 198.41.128.0/17;
-set_real_ip_from 162.158.0.0/15;
-set_real_ip_from 104.16.0.0/13;
-set_real_ip_from 104.24.0.0/14;
-set_real_ip_from 172.64.0.0/13;
-set_real_ip_from 131.0.72.0/22;
-real_ip_header CF-Connecting-IP;
-CF
-```
-
-Adicionar no `nginx.conf` dentro do bloco `http {}`:
-
-```nginx
-include /etc/nginx/cloudflare-ips.conf;
-```
-
-### Install fail2ban
-
-```bash
-apt install -y fail2ban
-systemctl enable fail2ban
-systemctl start fail2ban
-
-# Verificar status
-fail2ban-client status sshd
-```
-
-### Bloquear acesso direto na porta do Docker
-
-```bash
-# Impedir acesso externo direto à porta 20128
-iptables -I DOCKER-USER -p tcp --dport 20128 -j DROP
-iptables -I DOCKER-USER -i lo -p tcp --dport 20128 -j ACCEPT
-
-# Persistir as regras
-apt install -y iptables-persistent
-netfilter-persistent save
-```
-
---
-
-## 7. Deploy do Cloud Worker (Opcional)
-
-Para acesso remoto via Cloudflare Workers (sem expor a VM diretamente):
-
-```bash
-# No repositório local
-cd omnirouteCloud
-npm install
-npx wrangler login
-npx wrangler deploy
-```
-
-Ver documentação completa em [omnirouteCloud/README.md](../omnirouteCloud/README.md).
-
---
-
-## Resumo de Portas
-
-| Porta | Serviço     | Acesso                        |
-| ----- | ----------- | ----------------------------- |
-| 22    | SSH         | Público (com fail2ban)        |
-| 80    | nginx HTTP  | Redirect → HTTPS              |
-| 443   | nginx HTTPS | Via Cloudflare Proxy          |
-| 20128 | OmniRoute   | Somente localhost (via nginx) |
@@ -1,12 +1,12 @@
 {
  "name": "omniroute",
-  "version": "1.0.1",
+  "version": "0.8.5",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "omniroute",
-      "version": "1.0.1",
+      "version": "0.8.5",
      "license": "MIT",
      "workspaces": [
        "open-sse"
@@ -1,6 +1,6 @@
 {
  "name": "omniroute",
-  "version": "1.0.1",
+  "version": "0.9.0",
  "description": "Smart AI Router with auto fallback — route to FREE & cheap models, zero downtime. Works with Cursor, Cline, Claude Desktop, Codex, and any OpenAI-compatible tool.",
  "type": "module",
  "bin": {
@@ -53,7 +53,7 @@
    "test:fixes": "node --test tests/unit/fixes-p1.test.mjs",
    "test:security": "node --test tests/unit/security-fase01.test.mjs",
    "test:e2e": "npx playwright test",
-    "test:coverage": "npx c8 --exclude=open-sse --check-coverage --lines 30 --functions 30 --branches 30 node --import tsx/esm --test tests/unit/*.test.mjs",
+    "test:coverage": "npx c8 --check-coverage --lines 50 --functions 40 --branches 40 node --test tests/unit/*.test.mjs",
    "test:all": "npm run test:unit && npm run test:e2e",
    "check": "npm run lint && npm run test",
    "prepublishOnly": "npm run build:cli",
@@ -1,6 +1,6 @@
 "use client";

-import { useState, useEffect, useRef } from "react";
+import { useState, useEffect } from "react";
 import { Card, Button, Badge } from "@/shared/components";

 export default function SystemStorageTab() {
@@ -12,12 +12,6 @@ export default function SystemStorageTab() {
  const [confirmRestoreId, setConfirmRestoreId] = useState(null);
  const [manualBackupLoading, setManualBackupLoading] = useState(false);
  const [manualBackupStatus, setManualBackupStatus] = useState({ type: "", message: "" });
-  const [exportLoading, setExportLoading] = useState(false);
-  const [importLoading, setImportLoading] = useState(false);
-  const [importStatus, setImportStatus] = useState({ type: "", message: "" });
-  const [confirmImport, setConfirmImport] = useState(false);
-  const [pendingImportFile, setPendingImportFile] = useState<File | null>(null);
-  const fileInputRef = useRef<HTMLInputElement>(null);
  const [storageHealth, setStorageHealth] = useState({
    driver: "sqlite",
    dbPath: "~/.omniroute/storage.sqlite",
@@ -109,91 +103,6 @@ export default function SystemStorageTab() {
    loadStorageHealth();
  }, []);

-  const handleExport = async () => {
-    setExportLoading(true);
-    try {
-      const res = await fetch("/api/db-backups/export");
-      if (!res.ok) {
-        const data = await res.json();
-        throw new Error(data.error || "Export failed");
-      }
-      const blob = await res.blob();
-      const url = URL.createObjectURL(blob);
-      const disposition = res.headers.get("Content-Disposition") || "";
-      const filenameMatch = disposition.match(/filename="(.+)"/);
-      const filename = filenameMatch
-        ? filenameMatch[1]
-        : `omniroute-backup-${new Date().toISOString().replace(/[:.]/g, "-")}.sqlite`;
-      const a = document.createElement("a");
-      a.href = url;
-      a.download = filename;
-      document.body.appendChild(a);
-      a.click();
-      document.body.removeChild(a);
-      URL.revokeObjectURL(url);
-    } catch (err) {
-      console.error("Export failed:", err);
-      setImportStatus({ type: "error", message: `Export failed: ${(err as Error).message}` });
-    } finally {
-      setExportLoading(false);
-    }
-  };
-
-  const handleImportClick = () => {
-    fileInputRef.current?.click();
-  };
-
-  const handleFileSelected = (e: React.ChangeEvent<HTMLInputElement>) => {
-    const file = e.target.files?.[0];
-    if (!file) return;
-    if (!file.name.endsWith(".sqlite")) {
-      setImportStatus({
-        type: "error",
-        message: "Invalid file type. Only .sqlite files are accepted.",
-      });
-      return;
-    }
-    setPendingImportFile(file);
-    setConfirmImport(true);
-    if (fileInputRef.current) fileInputRef.current.value = "";
-  };
-
-  const handleImportConfirm = async () => {
-    if (!pendingImportFile) return;
-    setImportLoading(true);
-    setImportStatus({ type: "", message: "" });
-    setConfirmImport(false);
-    try {
-      const formData = new FormData();
-      formData.append("file", pendingImportFile);
-      const res = await fetch("/api/db-backups/import", {
-        method: "POST",
-        body: formData,
-      });
-      const data = await res.json();
-      if (res.ok) {
-        setImportStatus({
-          type: "success",
-          message: `Database imported! ${data.connectionCount} connections, ${data.nodeCount} nodes, ${data.comboCount} combos, ${data.apiKeyCount} API keys.`,
-        });
-        await loadStorageHealth();
-        if (backupsExpanded) await loadBackups();
-      } else {
-        setImportStatus({ type: "error", message: data.error || "Import failed" });
-      }
-    } catch {
-      setImportStatus({ type: "error", message: "An error occurred during import" });
-    } finally {
-      setImportLoading(false);
-      setPendingImportFile(null);
-    }
-  };
-
-  const handleImportCancel = () => {
-    setConfirmImport(false);
-    setPendingImportFile(null);
-  };
-
  const formatBytes = (bytes) => {
    if (!bytes || bytes === 0) return "0 B";
    if (bytes < 1024) return `${bytes} B`;
@@ -246,118 +155,7 @@ export default function SystemStorageTab() {
        </div>
      </div>

-      {/* Export / Import */}
-      <div className="flex items-center gap-2 mb-4">
-        <Button variant="outline" size="sm" onClick={handleExport} loading={exportLoading}>
-          <span className="material-symbols-outlined text-[14px] mr-1" aria-hidden="true">
-            download
-          </span>
-          Export Database
-        </Button>
-        <Button
-          variant="outline"
-          size="sm"
-          onClick={async () => {
-            setExportLoading(true);
-            try {
-              const res = await fetch("/api/db-backups/exportAll");
-              if (!res.ok) throw new Error("Export failed");
-              const blob = await res.blob();
-              const cd = res.headers.get("Content-Disposition") || "";
-              const filenameMatch = cd.match(/filename="?([^"]+)"?/);
-              const filename = filenameMatch?.[1] || `omniroute-full-backup.tar.gz`;
-              const url = URL.createObjectURL(blob);
-              const a = document.createElement("a");
-              a.href = url;
-              a.download = filename;
-              document.body.appendChild(a);
-              a.click();
-              document.body.removeChild(a);
-              URL.revokeObjectURL(url);
-            } catch (err) {
-              setImportStatus({
-                type: "error",
-                message: `Full export failed: ${(err as Error).message}`,
-              });
-            } finally {
-              setExportLoading(false);
-            }
-          }}
-          loading={exportLoading}
-        >
-          <span className="material-symbols-outlined text-[14px] mr-1" aria-hidden="true">
-            folder_zip
-          </span>
-          Export All (.tar.gz)
-        </Button>
-        <Button variant="outline" size="sm" onClick={handleImportClick} loading={importLoading}>
-          <span className="material-symbols-outlined text-[14px] mr-1" aria-hidden="true">
-            upload
-          </span>
-          Import Database
-        </Button>
-        <input
-          ref={fileInputRef}
-          type="file"
-          accept=".sqlite"
-          className="hidden"
-          onChange={handleFileSelected}
-        />
-      </div>
-
-      {/* Import confirmation dialog */}
-      {confirmImport && pendingImportFile && (
-        <div className="p-4 rounded-lg mb-4 bg-amber-500/10 border border-amber-500/30">
-          <div className="flex items-start gap-3">
-            <span
-              className="material-symbols-outlined text-[20px] text-amber-500 mt-0.5"
-              aria-hidden="true"
-            >
-              warning
-            </span>
-            <div className="flex-1">
-              <p className="text-sm font-medium text-amber-500 mb-1">Confirm Database Import</p>
-              <p className="text-xs text-text-muted mb-2">
-                This will replace <strong>all current data</strong> with the content from{" "}
-                <span className="font-mono">{pendingImportFile.name}</span>. A backup will be
-                created automatically before the import.
-              </p>
-              <div className="flex items-center gap-2">
-                <Button
-                  variant="primary"
-                  size="sm"
-                  onClick={handleImportConfirm}
-                  className="!bg-amber-500 hover:!bg-amber-600"
-                >
-                  Yes, Import
-                </Button>
-                <Button variant="outline" size="sm" onClick={handleImportCancel}>
-                  Cancel
-                </Button>
-              </div>
-            </div>
-          </div>
-        </div>
-      )}
-
-      {/* Import status */}
-      {importStatus.message && (
-        <div
-          className={`p-3 rounded-lg mb-4 text-sm ${
-            importStatus.type === "success"
-              ? "bg-green-500/10 text-green-500 border border-green-500/20"
-              : "bg-red-500/10 text-red-500 border border-red-500/20"
-          }`}
-          role="alert"
-        >
-          <div className="flex items-center gap-2">
-            <span className="material-symbols-outlined text-[16px]" aria-hidden="true">
-              {importStatus.type === "success" ? "check_circle" : "error"}
-            </span>
-            {importStatus.message}
-          </div>
-        </div>
-      )}
+      {/* Last backup + Backup Now */}
      <div className="flex items-center justify-between p-3 rounded-lg bg-bg border border-border mb-4">
        <div className="flex items-center gap-2">
          <span className="material-symbols-outlined text-[16px] text-amber-500" aria-hidden="true">
@@ -14,17 +14,6 @@ const MODES = [
  { value: "live-monitor", label: "Live Monitor", icon: "monitoring" },
 ];

-const MODE_DESCRIPTIONS: Record<string, string> = {
-  playground:
-    "Paste any API request body and see how OmniRoute translates it between provider formats (OpenAI ↔ Claude ↔ Gemini ↔ Responses API)",
-  "chat-tester":
-    "Send real chat requests through OmniRoute and see the full round-trip: your input, the translated request, the provider response, and the translated output",
-  "test-bench":
-    "Define multiple test cases with different inputs and expected outputs, run them all at once, and compare results across providers and models",
-  "live-monitor":
-    "Watch incoming requests in real-time as they flow through OmniRoute — see format translations happening live and identify issues instantly",
-};
-
 export default function TranslatorPageClient() {
  const [mode, setMode] = useState("playground");

@@ -38,8 +27,7 @@ export default function TranslatorPageClient() {
            Translator Playground
          </h1>
          <p className="text-sm text-text-muted mt-1">
-            {MODE_DESCRIPTIONS[mode] ||
-              "Debug, test, and visualize how OmniRoute translates API requests between providers"}
+            Debug, test, and visualize how OmniRoute translates API requests between providers
          </p>
        </div>
        <SegmentedControl options={MODES} value={mode} onChange={setMode} size="md" />
@@ -1,50 +0,0 @@
-import { NextResponse } from "next/server";
-import path from "node:path";
-import fs from "node:fs";
-import os from "node:os";
-import { getDbInstance, SQLITE_FILE } from "@/lib/db/core";
-
-/**
- * GET /api/db-backups/export — Download the current database as a .sqlite file.
- *
- * Uses SQLite's native backup API to create a consistent snapshot,
- * then streams it as a downloadable attachment.
- */
-export async function GET() {
-  try {
-    if (!SQLITE_FILE || !fs.existsSync(SQLITE_FILE)) {
-      return NextResponse.json({ error: "Database file not found" }, { status: 404 });
-    }
-
-    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
-    const exportFilename = `omniroute-backup-${timestamp}.sqlite`;
-    const tmpDir = os.tmpdir();
-    const tmpPath = path.join(tmpDir, exportFilename);
-
-    // Use native SQLite backup API for a consistent snapshot
-    const db = getDbInstance();
-    await db.backup(tmpPath);
-
-    const fileBuffer = fs.readFileSync(tmpPath);
-
-    // Cleanup temp file
-    try {
-      fs.unlinkSync(tmpPath);
-    } catch {
-      /* best effort */
-    }
-
-    return new Response(fileBuffer, {
-      status: 200,
-      headers: {
-        "Content-Type": "application/octet-stream",
-        "Content-Disposition": `attachment; filename="${exportFilename}"`,
-        "Content-Length": String(fileBuffer.length),
-        "Cache-Control": "no-cache, no-store",
-      },
-    });
-  } catch (error) {
-    console.error("[API] Error exporting database:", error);
-    return NextResponse.json({ error: error.message }, { status: 500 });
-  }
-}
@@ -1,142 +0,0 @@
-import { NextResponse } from "next/server";
-import { getDbInstance, SQLITE_FILE } from "@/lib/db/core";
-import fs from "node:fs";
-import path from "node:path";
-import os from "node:os";
-
-/**
- * GET /api/db-backups/exportAll
- * Exports the entire database + settings as a ZIP archive
- */
-export async function GET() {
-  try {
-    if (!SQLITE_FILE) {
-      return NextResponse.json(
-        { error: "Export is only available in local (non-cloud) mode" },
-        { status: 400 }
-      );
-    }
-
-    const db = getDbInstance();
-    const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
-    const tempDir = path.join(os.tmpdir(), `omniroute-export-${timestamp}`);
-    const zipPath = path.join(os.tmpdir(), `omniroute-full-backup-${timestamp}.zip`);
-
-    try {
-      // Create temp directory
-      fs.mkdirSync(tempDir, { recursive: true });
-
-      // 1. Export database using native backup API
-      const dbBackupPath = path.join(tempDir, "storage.sqlite");
-      db.backup(dbBackupPath);
-
-      // 2. Export settings as JSON
-      const settings: Record<string, string> = {};
-      try {
-        const rows = db.prepare("SELECT key, value FROM key_value").all() as {
-          key: string;
-          value: string;
-        }[];
-        for (const row of rows) {
-          settings[row.key] = row.value;
-        }
-      } catch {
-        // key_value table might not exist
-      }
-      fs.writeFileSync(path.join(tempDir, "settings.json"), JSON.stringify(settings, null, 2));
-
-      // 3. Export combos summary
-      const combos: unknown[] = [];
-      try {
-        const rows = db.prepare("SELECT * FROM combos").all();
-        combos.push(...rows);
-      } catch {
-        // combos table might not exist
-      }
-      fs.writeFileSync(path.join(tempDir, "combos.json"), JSON.stringify(combos, null, 2));
-
-      // 4. Export provider connections (without sensitive credentials)
-      const providers: unknown[] = [];
-      try {
-        const rows = db
-          .prepare(
-            "SELECT id, provider_id, display_name, auth_type, is_enabled, account_email, created_at FROM provider_connections"
-          )
-          .all();
-        providers.push(...rows);
-      } catch {
-        // provider_connections table might not exist
-      }
-      fs.writeFileSync(path.join(tempDir, "providers.json"), JSON.stringify(providers, null, 2));
-
-      // 5. Export API keys summary (masked)
-      const apiKeys: unknown[] = [];
-      try {
-        const rows = db
-          .prepare("SELECT id, name, prefix, created_at, is_active FROM api_keys")
-          .all();
-        apiKeys.push(...rows);
-      } catch {
-        // api_keys table might not exist
-      }
-      fs.writeFileSync(path.join(tempDir, "api-keys.json"), JSON.stringify(apiKeys, null, 2));
-
-      // 6. Export metadata
-      const metadata = {
-        exportedAt: new Date().toISOString(),
-        version: process.env.npm_package_version || "unknown",
-        format: "omniroute-full-backup-v1",
-        contents: [
-          "storage.sqlite - Full database",
-          "settings.json - Key-value settings",
-          "combos.json - Combo configurations",
-          "providers.json - Provider connections (no credentials)",
-          "api-keys.json - API key metadata (masked)",
-        ],
-      };
-      fs.writeFileSync(path.join(tempDir, "metadata.json"), JSON.stringify(metadata, null, 2));
-
-      // Create ZIP using tar (available on all Linux/macOS, and the archiver npm package is not installed)
-      // We'll use Node.js built-in zlib to create a simple tar.gz instead
-      const { execSync } = require("node:child_process");
-      const tarPath = zipPath.replace(".zip", ".tar.gz");
-      execSync(`tar -czf "${tarPath}" -C "${path.dirname(tempDir)}" "${path.basename(tempDir)}"`, {
-        timeout: 30000,
-      });
-
-      // Read the archive
-      const archiveBuffer = fs.readFileSync(tarPath);
-
-      // Cleanup
-      fs.rmSync(tempDir, { recursive: true, force: true });
-      fs.unlinkSync(tarPath);
-
-      return new NextResponse(archiveBuffer, {
-        status: 200,
-        headers: {
-          "Content-Type": "application/gzip",
-          "Content-Disposition": `attachment; filename="omniroute-full-backup-${timestamp}.tar.gz"`,
-          "Content-Length": archiveBuffer.length.toString(),
-        },
-      });
-    } catch (innerError) {
-      // Cleanup on error
-      try {
-        if (fs.existsSync(tempDir)) fs.rmSync(tempDir, { recursive: true, force: true });
-        if (fs.existsSync(zipPath)) fs.unlinkSync(zipPath);
-      } catch {
-        /* ignore cleanup errors */
-      }
-      throw innerError;
-    }
-  } catch (error: unknown) {
-    console.error("[ExportAll] Error:", error);
-    return NextResponse.json(
-      {
-        error: "Failed to create full export",
-        details: error instanceof Error ? error.message : String(error),
-      },
-      { status: 500 }
-    );
-  }
-}
@@ -1,155 +0,0 @@
-import { NextResponse } from "next/server";
-import Database from "better-sqlite3";
-import path from "node:path";
-import fs from "node:fs";
-import os from "node:os";
-import { getDbInstance, resetDbInstance, SQLITE_FILE } from "@/lib/db/core";
-import { backupDbFile } from "@/lib/db/backup";
-
-const MAX_UPLOAD_SIZE = 100 * 1024 * 1024; // 100 MB
-
-// Required tables that must exist in a valid OmniRoute database
-const REQUIRED_TABLES = ["provider_connections", "provider_nodes", "combos", "api_keys"];
-
-/**
- * POST /api/db-backups/import — Upload a .sqlite file to replace the current database.
- *
- * Accepts multipart/form-data with a single "file" field containing the .sqlite backup.
- * Validates integrity, schema, and required tables before replacing the active database.
- */
-export async function POST(request: Request) {
-  let tmpPath: string | null = null;
-
-  try {
-    const formData = await request.formData();
-    const file = formData.get("file") as File | null;
-
-    if (!file) {
-      return NextResponse.json(
-        { error: "No file provided. Upload a .sqlite file." },
-        { status: 400 }
-      );
-    }
-
-    // Validate filename extension
-    if (!file.name.endsWith(".sqlite")) {
-      return NextResponse.json(
-        { error: "Invalid file type. Only .sqlite files are accepted." },
-        { status: 400 }
-      );
-    }
-
-    // Validate file size
-    if (file.size > MAX_UPLOAD_SIZE) {
-      return NextResponse.json(
-        { error: `File too large. Maximum allowed size is ${MAX_UPLOAD_SIZE / (1024 * 1024)} MB.` },
-        { status: 400 }
-      );
-    }
-
-    if (file.size < 4096) {
-      return NextResponse.json(
-        { error: "File too small to be a valid SQLite database." },
-        { status: 400 }
-      );
-    }
-
-    // Write uploaded file to temp location
-    const arrayBuffer = await file.arrayBuffer();
-    const buffer = Buffer.from(arrayBuffer);
-    tmpPath = path.join(os.tmpdir(), `omniroute-import-${Date.now()}.sqlite`);
-    fs.writeFileSync(tmpPath, buffer);
-
-    // Validate SQLite integrity
-    let testDb: InstanceType<typeof Database> | null = null;
-    try {
-      testDb = new Database(tmpPath, { readonly: true });
-      const result = testDb.pragma("integrity_check") as any[];
-      if (result[0]?.integrity_check !== "ok") {
-        return NextResponse.json(
-          { error: "Database integrity check failed. The file may be corrupted." },
-          { status: 400 }
-        );
-      }
-
-      // Validate required tables exist
-      const tables = testDb
-        .prepare("SELECT name FROM sqlite_master WHERE type='table'")
-        .all()
-        .map((row: any) => row.name);
-
-      const missingTables = REQUIRED_TABLES.filter((t) => !tables.includes(t));
-      if (missingTables.length > 0) {
-        return NextResponse.json(
-          {
-            error: `Invalid OmniRoute database. Missing tables: ${missingTables.join(", ")}`,
-          },
-          { status: 400 }
-        );
-      }
-
-      testDb.close();
-      testDb = null;
-    } catch (e) {
-      if (testDb) testDb.close();
-      return NextResponse.json({ error: `Invalid database file: ${e.message}` }, { status: 400 });
-    }
-
-    // Create pre-import backup
-    backupDbFile("pre-import");
-
-    // Close and reset current DB connection
-    resetDbInstance();
-
-    // Remove main file and WAL sidecars
-    const sqliteFilesToReplace = [
-      SQLITE_FILE,
-      `${SQLITE_FILE}-wal`,
-      `${SQLITE_FILE}-shm`,
-      `${SQLITE_FILE}-journal`,
-    ];
-    for (const filePath of sqliteFilesToReplace) {
-      if (!filePath) continue;
-      if (fs.existsSync(filePath)) {
-        fs.unlinkSync(filePath);
-      }
-    }
-
-    // Copy imported file over current DB
-    fs.copyFileSync(tmpPath, SQLITE_FILE!);
-
-    // Reopen and verify
-    const db = getDbInstance();
-    const connCount =
-      (db.prepare("SELECT COUNT(*) as cnt FROM provider_connections").get() as any)?.cnt || 0;
-    const nodeCount =
-      (db.prepare("SELECT COUNT(*) as cnt FROM provider_nodes").get() as any)?.cnt || 0;
-    const comboCount = (db.prepare("SELECT COUNT(*) as cnt FROM combos").get() as any)?.cnt || 0;
-    const keyCount = (db.prepare("SELECT COUNT(*) as cnt FROM api_keys").get() as any)?.cnt || 0;
-
-    console.log(
-      `[DB] Imported database from upload: ${connCount} connections, ${nodeCount} nodes, ${comboCount} combos, ${keyCount} API keys`
-    );
-
-    return NextResponse.json({
-      imported: true,
-      filename: file.name,
-      connectionCount: connCount,
-      nodeCount,
-      comboCount,
-      apiKeyCount: keyCount,
-    });
-  } catch (error) {
-    console.error("[API] Error importing database:", error);
-    return NextResponse.json({ error: error.message }, { status: 500 });
-  } finally {
-    // Cleanup temp file
-    if (tmpPath && fs.existsSync(tmpPath)) {
-      try {
-        fs.unlinkSync(tmpPath);
-      } catch {
-        /* best effort */
-      }
-    }
-  }
-}
@@ -10,14 +10,7 @@ import { useCopyToClipboard } from "@/shared/hooks/useCopyToClipboard";
 * - Localhost: Auto callback via popup message
 * - Remote: Manual paste callback URL
 */
-export default function OAuthModal({
-  isOpen,
-  provider,
-  providerInfo,
-  onSuccess,
-  onClose,
-  idcConfig,
-}: any) {
+export default function OAuthModal({ isOpen, provider, providerInfo, onSuccess, onClose, idcConfig }: any) {
  const [step, setStep] = useState("waiting"); // waiting | input | success | error
  const [authData, setAuthData] = useState(null);
  const [callbackUrl, setCallbackUrl] = useState("");
@@ -158,68 +151,57 @@ export default function OAuthModal({
        return;
      }

-      // Codex: on localhost use callback server on port 1455,
-      // on remote use standard auth code flow (callback server is unreachable)
+      // Codex: use callback server on port 1455 + polling (auto-complete)
      if (provider === "codex") {
-        if (isLocalhost) {
-          // Localhost: use callback server on port 1455 + polling
-          try {
-            const serverRes = await fetch(`/api/oauth/codex/start-callback-server`);
-            const serverData = await serverRes.json();
-            if (!serverRes.ok) throw new Error(serverData.error);
+        try {
+          // Start callback server on port 1455
+          const serverRes = await fetch(`/api/oauth/codex/start-callback-server`);
+          const serverData = await serverRes.json();
+          if (!serverRes.ok) throw new Error(serverData.error);

-            setAuthData({ ...serverData, redirectUri: serverData.redirectUri });
-            setStep("waiting");
-            window.open(serverData.authUrl, "oauth_auth");
+          setAuthData({ ...serverData, redirectUri: serverData.redirectUri });
+          setStep("waiting");
+          window.open(serverData.authUrl, "oauth_auth");

-            setPolling(true);
-            const maxAttempts = 150;
-            for (let i = 0; i < maxAttempts; i++) {
-              await new Promise((r) => setTimeout(r, 2000));
+          // Poll for callback (like device code flow)
+          setPolling(true);
+          const maxAttempts = 150; // 5 min at 2s interval
+          for (let i = 0; i < maxAttempts; i++) {
+            await new Promise((r) => setTimeout(r, 2000));

-              const pollRes = await fetch(`/api/oauth/codex/poll-callback`, {
-                method: "POST",
-                headers: { "Content-Type": "application/json" },
-                body: JSON.stringify({}),
-              });
-              const pollData = await pollRes.json();
+            const pollRes = await fetch(`/api/oauth/codex/poll-callback`, {
+              method: "POST",
+              headers: { "Content-Type": "application/json" },
+              body: JSON.stringify({}),
+            });
+            const pollData = await pollRes.json();

-              if (pollData.success) {
-                setStep("success");
-                setPolling(false);
-                onSuccess?.();
-                return;
-              }
-
-              if (pollData.error && !pollData.pending) {
-                throw new Error(pollData.errorDescription || pollData.error);
-              }
+            if (pollData.success) {
+              setStep("success");
+              setPolling(false);
+              onSuccess?.();
+              return;
            }

-            setPolling(false);
-            throw new Error("Authorization timeout");
-          } catch (codexErr) {
-            setPolling(false);
-            setStep("input");
-            setError(codexErr.message + " — You can paste the callback URL manually below.");
+            if (pollData.error && !pollData.pending) {
+              throw new Error(pollData.errorDescription || pollData.error);
+            }
          }
-          return;
+
+          setPolling(false);
+          throw new Error("Authorization timeout");
+        } catch (codexErr) {
+          setPolling(false);
+          // Fallback to manual input mode
+          setStep("input");
+          setError(codexErr.message + " — You can paste the callback URL manually below.");
        }
-        // Remote: fall through to standard auth code flow below
+        return;
      }

-      // Authorization code flow
-      // Always use localhost redirect_uri — this is what providers have registered.
-      // On remote, the browser redirects to localhost (error page), user copies URL and pastes back.
-      // Codex (OpenAI) requires exactly http://localhost:1455/auth/callback — the registered URI.
-      // Other providers (Antigravity/Gemini via Google OAuth) accept any localhost port.
-      let redirectUri: string;
-      if (provider === "codex" || provider === "openai") {
-        redirectUri = "http://localhost:1455/auth/callback";
-      } else {
-        const port = window.location.port || (window.location.protocol === "https:" ? "443" : "80");
-        redirectUri = `http://localhost:${port}/callback`;
-      }
+      // Authorization code flow (non-Codex providers)
+      const port = window.location.port || (window.location.protocol === "https:" ? "443" : "80");
+      const redirectUri = `http://localhost:${port}/callback`;

      const res = await fetch(
        `/api/oauth/${provider}/authorize?redirect_uri=${encodeURIComponent(redirectUri)}`
@@ -450,15 +432,6 @@ export default function OAuthModal({
        {step === "input" && !isDeviceCode && (
          <>
            <div className="space-y-4">
-              {!isLocalhost && (
-                <div className="rounded-lg border border-blue-500/30 bg-blue-500/10 p-3 text-xs text-blue-200">
-                  <span className="material-symbols-outlined text-sm align-middle mr-1">info</span>
-                  <strong>Remote access:</strong> Since you&apos;re accessing OmniRoute remotely,
-                  after authorizing you&apos;ll see an error page (localhost not found). That&apos;s
-                  expected — just copy the full URL from your browser&apos;s address bar and paste
-                  it below.
-                </div>
-              )}
              <div>
                <p className="text-sm font-medium mb-2">Step 1: Open this URL in your browser</p>
                <div className="flex gap-2">