Merge pull request #76 from diegosouzapw/chore/bump-v1.0.1

chore: bump version to 1.0.1

CHANGELOG.md

@@ -7,242 +7,135 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
-## [0.9.0] — 2026-02-17
+## [1.0.0] — 2026-02-18
 
-### Added
-
-- 🌐 **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
-
----
-
-## [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
+> ### 🎉 First Major Release — OmniRoute 1.0
 >
-> **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.
+> 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
 
-- 🔒 **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)
+- **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
 
-### Refactored
+### 🔌 Providers & Models
 
-- 🔷 **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
+- **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
 
-### Fixed
+### 🔄 Format Translation
 
-- 🐛 **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)
+- **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
 
-### Changed
+### 🎯 Combos & Fallback Chains
 
-- 📖 **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
+- **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
 
-### Dependencies
+### 🛡️ Resilience & Security
 
-- ⬆️ `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`
+- **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
 
 ---
 
-## [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.0.0]: https://github.com/diegosouzapw/OmniRoute/releases/tag/v1.0.0

README.de.md

@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="./images/omniroute.png" alt="OmniRoute Dashboard" width="800"/>
+  <img src="./docs/screenshots/MainOmniRoute.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` | `0.9.0`  | ~250MB | Aktuelle Version         |
+| `diegosouzapw/omniroute` | `1.0.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 v0.9.0+ enthält Fallback-Validierung via Chat Completions
+- OmniRoute v1.0.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/` (v0.9.0)
+- **Sprache**: TypeScript 5.9 — **100% TypeScript** in `src/` und `open-sse/` (v1.0.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 v0.9.0 --title "v0.9.0" --generate-notes
+gh release create v1.0.0 --title "v1.0.0" --generate-notes
 ```
 
 ---

README.es.md

@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="./images/omniroute.png" alt="OmniRoute Dashboard" width="800"/>
+  <img src="./docs/screenshots/MainOmniRoute.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` | `0.9.0`  | ~250MB | Versión actual         |
+| `diegosouzapw/omniroute` | `1.0.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 v0.9.0+ incluye validación vía chat completions como fallback
+- OmniRoute v1.0.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/` (v0.9.0)
+- **Lenguaje**: TypeScript 5.9 — **100% TypeScript** en `src/` y `open-sse/` (v1.0.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 v0.9.0 --title "v0.9.0" --generate-notes
+gh release create v1.0.0 --title "v1.0.0" --generate-notes
 ```
 
 ---

README.fr.md

@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="./images/omniroute.png" alt="OmniRoute Dashboard" width="800"/>
+  <img src="./docs/screenshots/MainOmniRoute.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` | `0.9.0`  | ~250MB | Version actuelle        |
+| `diegosouzapw/omniroute` | `1.0.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 v0.9.0+ inclut une validation de secours via chat completions
+- OmniRoute v1.0.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/` (v0.9.0)
+- **Langage** : TypeScript 5.9 — **100% TypeScript** dans `src/` et `open-sse/` (v1.0.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 v0.9.0 --title "v0.9.0" --generate-notes
+gh release create v1.0.0 --title "v1.0.0" --generate-notes
 ```
 
 ---

README.it.md

@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="./images/omniroute.png" alt="OmniRoute Dashboard" width="800"/>
+  <img src="./docs/screenshots/MainOmniRoute.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` | `0.9.0`  | ~250MB     | Versione attuale        |
+| `diegosouzapw/omniroute` | `1.0.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 v0.9.0+ include validazione fallback tramite chat completions
+- OmniRoute v1.0.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/` (v0.9.0)
+- **Linguaggio**: TypeScript 5.9 — **100% TypeScript** in `src/` e `open-sse/` (v1.0.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 v0.9.0 --title "v0.9.0" --generate-notes
+gh release create v1.0.0 --title "v1.0.0" --generate-notes
 ```
 
 ---

README.md

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

README.pt-BR.md

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

README.ru.md

@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="./images/omniroute.png" alt="OmniRoute Dashboard" width="800"/>
+  <img src="./docs/screenshots/MainOmniRoute.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` | `0.9.0`  | ~250MB | Текущая версия             |
+| `diegosouzapw/omniroute` | `1.0.0`  | ~250MB | Текущая версия             |
 
 ---
 
@@ -892,7 +892,7 @@ OmniRoute включает встроенный фреймворк оценки
 **Тест подключения показывает «Invalid» для OpenAI-совместимых провайдеров**
 
 - Многие провайдеры не предоставляют endpoint `/models`
-- OmniRoute v0.9.0+ включает fallback-валидацию через chat completions
+- OmniRoute v1.0.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/` (v0.9.0)
+- **Язык**: TypeScript 5.9 — **100% TypeScript** в `src/` и `open-sse/` (v1.0.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 v0.9.0 --title "v0.9.0" --generate-notes
+gh release create v1.0.0 --title "v1.0.0" --generate-notes
 ```
 
 ---

README.zh-CN.md

@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="./images/omniroute.png" alt="OmniRoute Dashboard" width="800"/>
+  <img src="./docs/screenshots/MainOmniRoute.png" alt="OmniRoute Dashboard" width="800"/>
   
   # 🚀 OmniRoute — 免费 AI 网关
 
@@ -242,7 +242,7 @@ docker compose --profile cli up -d
 | 镜像                     | 标签     | 大小   | 描述       |
 | ------------------------ | -------- | ------ | ---------- |
 | `diegosouzapw/omniroute` | `latest` | ~250MB | 最新稳定版 |
-| `diegosouzapw/omniroute` | `0.9.0`  | ~250MB | 当前版本   |
+| `diegosouzapw/omniroute` | `1.0.0`  | ~250MB | 当前版本   |
 
 ---
 
@@ -892,7 +892,7 @@ OmniRoute 包含内置评估框架，用于针对黄金集测试 LLM 响应质
 **兼容 OpenAI 的提供商连接测试显示 "Invalid"**
 
 - 许多提供商不暴露 `/models` 端点
-- OmniRoute v0.9.0+ 包含通过 chat completions 的回退验证
+- OmniRoute v1.0.0+ 包含通过 chat completions 的回退验证
 - 确保 base URL 包含 `/v1` 后缀
 
 </details>
@@ -902,7 +902,7 @@ OmniRoute 包含内置评估框架，用于针对黄金集测试 LLM 响应质
 ## 🛠️ 技术栈
 
 - **运行时**: Node.js 20+
-- **语言**: TypeScript 5.9 — `src/` 和 `open-sse/` 中 **100% TypeScript**（v0.9.0）
+- **语言**: TypeScript 5.9 — `src/` 和 `open-sse/` 中 **100% TypeScript**（v1.0.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 v0.9.0 --title "v0.9.0" --generate-notes
+gh release create v1.0.0 --title "v1.0.0" --generate-notes
 ```
 
 ---

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "omniroute",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "omniroute",
-      "version": "1.0.0",
+      "version": "1.0.1",
       "license": "MIT",
       "workspaces": [
         "open-sse"

package.json

@@ -1,6 +1,6 @@
 {
   "name": "omniroute",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "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": {

src/shared/components/OAuthModal.tsx

@@ -211,8 +211,15 @@ export default function OAuthModal({
       // 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.
-      const port = window.location.port || (window.location.protocol === "https:" ? "443" : "80");
-      const redirectUri = `http://localhost:${port}/callback`;
+      // 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`;
+      }
 
       const res = await fetch(
         `/api/oauth/${provider}/authorize?redirect_uri=${encodeURIComponent(redirectUri)}`