omniroute 0.1.0 → 0.2.0

package/README.md

@@ -15,6 +15,7 @@
   
   > *This project is inspired by and originally forked from [9router](https://github.com/decolua/9router) by [decolua](https://github.com/decolua). Thank you for the incredible foundation!*
   
+  [![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute)
   [![License](https://img.shields.io/github/license/diegosouzapw/OmniRoute)](https://github.com/diegosouzapw/OmniRoute/blob/main/LICENSE)
   
   [🚀 Quick Start](#-quick-start) • [💡 Features](#-key-features) • [📖 Setup](#-setup-guide)
@@ -80,6 +81,16 @@ omniroute
 
 🎉 Dashboard opens at `http://localhost:20128`
 
+**CLI Options:**
+
+| Command                 | Description                       |
+| ----------------------- | --------------------------------- |
+| `omniroute`             | Start server (default port 20128) |
+| `omniroute --port 3000` | Use custom port                   |
+| `omniroute --no-open`   | Don't auto-open browser           |
+| `omniroute --help`      | Show help                         |
+| `omniroute --version`   | Show version                      |
+
 **2. Connect a FREE provider (no signup needed):**
 
 Dashboard → Providers → Connect **Claude Code** or **Antigravity** → OAuth login → Done!
@@ -97,8 +108,6 @@ Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings:
 
 **Alternative: run from source (this repository):**
 
-This repository package is private (`omniroute-app`), so source/Docker execution is the expected local development path.
-
 ```bash
 cp .env.example .env
 npm install
@@ -137,6 +146,12 @@ Default URLs:
 | 💾 **Cloud Sync**                | Sync config across devices                 | Same setup everywhere               |
 | 📊 **Usage Analytics**           | Track tokens, cost, trends over time       | Optimize spending                   |
 | 🌐 **Deploy Anywhere**           | Localhost, VPS, Docker, Cloudflare Workers | Flexible deployment options         |
+| 🛡️ **IP Allowlist/Blocklist**    | Restrict API access by IP address          | Security for exposed deployments    |
+| 🧠 **Thinking Budget**           | Control reasoning token budget per model   | Optimize cost vs quality            |
+| 💬 **System Prompt Injection**   | Global system prompt for all requests      | Consistent behavior across models   |
+| 📊 **Session Tracking**          | Track active sessions with fingerprinting  | Monitor connected clients           |
+| ⚡ **Rate Limiting**             | Per-account request rate management        | Prevent abuse and quota waste       |
+| 💰 **Model Pricing**             | Per-model cost tracking and calculation    | Precise usage cost analytics        |
 
 <details>
 <summary><b>📖 Feature Details</b></summary>
@@ -1080,7 +1095,8 @@ Types: `chat`, `embedding`, `image`. Custom models are flagged with `custom: tru
 - **Auth**: OAuth 2.0 (PKCE) + JWT + API Keys
 - **Testing**: Playwright (E2E) + Node.js test runner (unit)
 - **Monorepo**: npm workspaces (`@omniroute/open-sse`)
-- **CI/CD**: Dependabot (weekly npm + GH Actions)
+- **CI/CD**: GitHub Actions (auto npm publish on release) + Dependabot
+- **Package**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
 - **Compliance**: `/terms` and `/privacy` pages
 
 ---
@@ -1207,6 +1223,11 @@ Expected behavior from recent validation:
 - Routing config: `/api/models/alias`, `/api/combos*`, `/api/keys*`, `/api/pricing`
 - Usage/logs: `/api/usage/history`, `/api/usage/logs`, `/api/usage/request-logs`, `/api/usage/[connectionId]`
 - Cloud sync: `/api/sync/cloud`, `/api/sync/initialize`, `/api/cloud/*`
+- IP filter: `/api/settings/ip-filter` (GET/PUT) — Allowlist/blocklist management
+- Thinking budget: `/api/settings/thinking-budget` (GET/PUT) — Reasoning token budget config
+- System prompt: `/api/settings/system-prompt` (GET/PUT) — Global system prompt injection
+- Sessions: `/api/sessions` (GET) — Active session tracking
+- Rate limits: `/api/rate-limits` (GET) — Per-account rate limit status
 - CLI helpers: `/api/cli-tools/claude-settings`, `/api/cli-tools/codex-settings`, `/api/cli-tools/droid-settings`, `/api/cli-tools/openclaw-settings`
   - Generic runtime status: `/api/cli-tools/runtime/[toolId]` (covers `claude`, `codex`, `droid`, `openclaw`, `cursor`, `cline`, `roo`, `continue`)
   - CLI `GET` responses expose runtime fields: `installed`, `runnable`, `command`, `commandPath`, `runtimeMode`, `reason`
@@ -1263,6 +1284,17 @@ Thanks to all contributors who helped make OmniRoute better!
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
 
+### Releasing a New Version
+
+When a new GitHub Release is created (e.g. `v0.2.0`), the package is **automatically published to npm** via GitHub Actions:
+
+```bash
+# Create a release — npm publish happens automatically
+gh release create v0.2.0 --title "v0.2.0" --generate-notes
+```
+
+The workflow syncs the version from the release tag, builds the standalone app, and publishes to npm.
+
 ---
 
 ## 🙏 Acknowledgments

package/app/.next/BUILD_ID

@@ -1 +1 @@
-l-F9C6gggjrUWKnAln0Wn
+XnNWFvV2IXZ4xuX0F1Skg

package/app/.next/app-path-routes-manifest.json

@@ -2,13 +2,13 @@
   "/_not-found/page": "/_not-found",
   "/_global-error/page": "/_global-error",
   "/api/auth/login/route": "/api/auth/login",
-  "/api/auth/logout/route": "/api/auth/logout",
   "/api/cli-tools/antigravity-mitm/alias/route": "/api/cli-tools/antigravity-mitm/alias",
+  "/api/auth/logout/route": "/api/auth/logout",
   "/api/cli-tools/backups/route": "/api/cli-tools/backups",
   "/api/cli-tools/codex-profiles/route": "/api/cli-tools/codex-profiles",
   "/api/cli-tools/guide-settings/[toolId]/route": "/api/cli-tools/guide-settings/[toolId]",
-  "/api/cloud/auth/route": "/api/cloud/auth",
   "/api/cloud/credentials/update/route": "/api/cloud/credentials/update",
+  "/api/cloud/auth/route": "/api/cloud/auth",
   "/api/cloud/model/resolve/route": "/api/cloud/model/resolve",
   "/api/cloud/models/alias/route": "/api/cloud/models/alias",
   "/api/combos/[id]/route": "/api/combos/[id]",
@@ -19,20 +19,21 @@
   "/api/init/route": "/api/init",
   "/api/keys/[id]/route": "/api/keys/[id]",
   "/api/keys/route": "/api/keys",
-  "/api/models/alias/route": "/api/models/alias",
   "/api/models/catalog/route": "/api/models/catalog",
+  "/api/models/alias/route": "/api/models/alias",
   "/api/models/route": "/api/models",
-  "/api/oauth/cursor/auto-import/route": "/api/oauth/cursor/auto-import",
   "/api/oauth/[provider]/[action]/route": "/api/oauth/[provider]/[action]",
   "/api/oauth/cursor/import/route": "/api/oauth/cursor/import",
   "/api/oauth/kiro/auto-import/route": "/api/oauth/kiro/auto-import",
+  "/api/oauth/cursor/auto-import/route": "/api/oauth/cursor/auto-import",
   "/api/oauth/kiro/import/route": "/api/oauth/kiro/import",
+  "/api/oauth/kiro/social-authorize/route": "/api/oauth/kiro/social-authorize",
+  "/api/pricing/defaults/route": "/api/pricing/defaults",
   "/api/oauth/kiro/social-exchange/route": "/api/oauth/kiro/social-exchange",
+  "/api/pricing/models/route": "/api/pricing/models",
   "/api/pricing/route": "/api/pricing",
-  "/api/pricing/defaults/route": "/api/pricing/defaults",
-  "/api/oauth/kiro/social-authorize/route": "/api/oauth/kiro/social-authorize",
-  "/api/provider-models/route": "/api/provider-models",
   "/api/provider-nodes/[id]/route": "/api/provider-nodes/[id]",
+  "/api/provider-models/route": "/api/provider-models",
   "/api/provider-nodes/validate/route": "/api/provider-nodes/validate",
   "/api/providers/[id]/models/route": "/api/providers/[id]/models",
   "/api/providers/[id]/route": "/api/providers/[id]",
@@ -41,15 +42,20 @@
   "/api/providers/test-batch/route": "/api/providers/test-batch",
   "/api/providers/validate/route": "/api/providers/validate",
   "/api/rate-limit/route": "/api/rate-limit",
+  "/api/rate-limits/route": "/api/rate-limits",
   "/api/restart/route": "/api/restart",
+  "/api/sessions/route": "/api/sessions",
   "/api/settings/combo-defaults/route": "/api/settings/combo-defaults",
+  "/api/settings/ip-filter/route": "/api/settings/ip-filter",
   "/api/settings/require-login/route": "/api/settings/require-login",
   "/api/settings/route": "/api/settings",
+  "/api/settings/system-prompt/route": "/api/settings/system-prompt",
   "/api/shutdown/route": "/api/shutdown",
+  "/api/settings/thinking-budget/route": "/api/settings/thinking-budget",
   "/api/storage/health/route": "/api/storage/health",
   "/api/sync/cloud/route": "/api/sync/cloud",
-  "/api/sync/initialize/route": "/api/sync/initialize",
   "/api/tags/route": "/api/tags",
+  "/api/sync/initialize/route": "/api/sync/initialize",
   "/api/translator/detect/route": "/api/translator/detect",
   "/api/translator/history/route": "/api/translator/history",
   "/api/translator/load/route": "/api/translator/load",
@@ -57,24 +63,24 @@
   "/api/translator/send/route": "/api/translator/send",
   "/api/translator/translate/route": "/api/translator/translate",
   "/api/usage/[connectionId]/route": "/api/usage/[connectionId]",
-  "/api/usage/call-logs/[id]/route": "/api/usage/call-logs/[id]",
   "/api/usage/analytics/route": "/api/usage/analytics",
+  "/api/usage/call-logs/[id]/route": "/api/usage/call-logs/[id]",
+  "/api/usage/call-logs/route": "/api/usage/call-logs",
   "/api/usage/history/route": "/api/usage/history",
   "/api/usage/logs/route": "/api/usage/logs",
-  "/api/usage/call-logs/route": "/api/usage/call-logs",
   "/api/usage/request-logs/route": "/api/usage/request-logs",
   "/api/v1/api/chat/route": "/api/v1/api/chat",
   "/api/v1/audio/speech/route": "/api/v1/audio/speech",
   "/api/v1/audio/transcriptions/route": "/api/v1/audio/transcriptions",
   "/api/v1/chat/completions/route": "/api/v1/chat/completions",
-  "/api/v1/embeddings/route": "/api/v1/embeddings",
   "/api/v1/images/generations/route": "/api/v1/images/generations",
-  "/api/v1/messages/count_tokens/route": "/api/v1/messages/count_tokens",
-  "/api/v1/messages/route": "/api/v1/messages",
+  "/api/v1/embeddings/route": "/api/v1/embeddings",
   "/api/v1/models/route": "/api/v1/models",
+  "/api/v1/messages/route": "/api/v1/messages",
+  "/api/v1/messages/count_tokens/route": "/api/v1/messages/count_tokens",
   "/api/v1/moderations/route": "/api/v1/moderations",
-  "/api/v1/providers/[provider]/chat/completions/route": "/api/v1/providers/[provider]/chat/completions",
   "/api/v1/providers/[provider]/embeddings/route": "/api/v1/providers/[provider]/embeddings",
+  "/api/v1/providers/[provider]/chat/completions/route": "/api/v1/providers/[provider]/chat/completions",
   "/api/v1/providers/[provider]/images/generations/route": "/api/v1/providers/[provider]/images/generations",
   "/api/v1/rerank/route": "/api/v1/rerank",
   "/api/v1/responses/route": "/api/v1/responses",
@@ -92,27 +98,27 @@
   "/api/provider-nodes/route": "/api/provider-nodes",
   "/api/cli-tools/codex-settings/route": "/api/cli-tools/codex-settings",
   "/api/providers/[id]/test/route": "/api/providers/[id]/test",
+  "/api/settings/proxy/test/route": "/api/settings/proxy/test",
   "/api/settings/proxy/route": "/api/settings/proxy",
   "/api/usage/proxy-logs/route": "/api/usage/proxy-logs",
-  "/api/settings/proxy/test/route": "/api/settings/proxy/test",
   "/callback/page": "/callback",
-  "/dashboard/settings/pricing/page": "/dashboard/settings/pricing",
-  "/docs/page": "/docs",
   "/landing/page": "/landing",
+  "/docs/page": "/docs",
   "/login/page": "/login",
   "/page": "/",
-  "/privacy/page": "/privacy",
   "/terms/page": "/terms",
-  "/(dashboard)/dashboard/endpoint/page": "/dashboard/endpoint",
+  "/privacy/page": "/privacy",
   "/(dashboard)/dashboard/cli-tools/page": "/dashboard/cli-tools",
+  "/(dashboard)/dashboard/endpoint/page": "/dashboard/endpoint",
   "/(dashboard)/dashboard/profile/page": "/dashboard/profile",
   "/(dashboard)/dashboard/providers/new/page": "/dashboard/providers/new",
   "/(dashboard)/dashboard/settings/page": "/dashboard/settings",
+  "/(dashboard)/dashboard/settings/pricing/page": "/dashboard/settings/pricing",
   "/(dashboard)/dashboard/page": "/dashboard",
   "/(dashboard)/dashboard/onboarding/page": "/dashboard/onboarding",
   "/(dashboard)/dashboard/translator/page": "/dashboard/translator",
   "/(dashboard)/dashboard/usage/page": "/dashboard/usage",
-  "/(dashboard)/dashboard/combos/page": "/dashboard/combos",
   "/(dashboard)/dashboard/providers/page": "/dashboard/providers",
+  "/(dashboard)/dashboard/combos/page": "/dashboard/combos",
   "/(dashboard)/dashboard/providers/[id]/page": "/dashboard/providers/[id]"
 }

package/app/.next/build-manifest.json

@@ -4,11 +4,11 @@
   ],
   "devFiles": [],
   "lowPriorityFiles": [
-    "static/l-F9C6gggjrUWKnAln0Wn/_buildManifest.js",
-    "static/l-F9C6gggjrUWKnAln0Wn/_ssgManifest.js"
+    "static/XnNWFvV2IXZ4xuX0F1Skg/_buildManifest.js",
+    "static/XnNWFvV2IXZ4xuX0F1Skg/_ssgManifest.js"
   ],
   "rootMainFiles": [
-    "static/chunks/webpack-f742cb5c6c3130ec.js",
+    "static/chunks/webpack-a2b6b20e2db553f5.js",
     "static/chunks/4bd1b696-e5d7c65570c947b7.js",
     "static/chunks/3794-337d1ca25ad99a89.js",
     "static/chunks/main-app-fbc16f70c595b197.js"

package/app/.next/prerender-manifest.json

@@ -242,7 +242,7 @@
         "x-next-revalidate-tag-token"
       ]
     },
-    "/dashboard/translator": {
+    "/dashboard/settings/pricing": {
       "experimentalBypassFor": [
         {
           "type": "header",
@@ -255,8 +255,8 @@
         }
       ],
       "initialRevalidateSeconds": false,
-      "srcRoute": "/dashboard/translator",
-      "dataRoute": "/dashboard/translator.rsc",
+      "srcRoute": "/dashboard/settings/pricing",
+      "dataRoute": "/dashboard/settings/pricing.rsc",
       "allowHeader": [
         "host",
         "x-matched-path",
@@ -266,7 +266,7 @@
         "x-next-revalidate-tag-token"
       ]
     },
-    "/dashboard/usage": {
+    "/dashboard/translator": {
       "experimentalBypassFor": [
         {
           "type": "header",
@@ -279,8 +279,8 @@
         }
       ],
       "initialRevalidateSeconds": false,
-      "srcRoute": "/dashboard/usage",
-      "dataRoute": "/dashboard/usage.rsc",
+      "srcRoute": "/dashboard/translator",
+      "dataRoute": "/dashboard/translator.rsc",
       "allowHeader": [
         "host",
         "x-matched-path",
@@ -290,7 +290,7 @@
         "x-next-revalidate-tag-token"
       ]
     },
-    "/callback": {
+    "/dashboard/usage": {
       "experimentalBypassFor": [
         {
           "type": "header",
@@ -303,8 +303,8 @@
         }
       ],
       "initialRevalidateSeconds": false,
-      "srcRoute": "/callback",
-      "dataRoute": "/callback.rsc",
+      "srcRoute": "/dashboard/usage",
+      "dataRoute": "/dashboard/usage.rsc",
       "allowHeader": [
         "host",
         "x-matched-path",
@@ -314,7 +314,7 @@
         "x-next-revalidate-tag-token"
       ]
     },
-    "/dashboard/settings/pricing": {
+    "/callback": {
       "experimentalBypassFor": [
         {
           "type": "header",
@@ -327,8 +327,8 @@
         }
       ],
       "initialRevalidateSeconds": false,
-      "srcRoute": "/dashboard/settings/pricing",
-      "dataRoute": "/dashboard/settings/pricing.rsc",
+      "srcRoute": "/callback",
+      "dataRoute": "/callback.rsc",
       "allowHeader": [
         "host",
         "x-matched-path",
@@ -515,8 +515,8 @@
   "dynamicRoutes": {},
   "notFoundRoutes": [],
   "preview": {
-    "previewModeId": "ee9a5eb0c01611c8e1eb30d92c628b0b",
-    "previewModeSigningKey": "da92649610f76c78becc50de2d7863427b9a78d2cac24e9e66af4ac2b552585c",
-    "previewModeEncryptionKey": "db940fd1ccc6e711815783c3fec1376e0028c41022f7a75591bbc1d7e9a7b381"
+    "previewModeId": "1681a77edaf9442de60eaba4d64df4d1",
+    "previewModeSigningKey": "18f9196b6a9ad6bd26b9e7667c33148e7a9486090913c85eb553025991650ce8",
+    "previewModeEncryptionKey": "1ef7247a85fcffd445808e7475c2be72ff0b90d53145c5e73bf16a7542947b85"
   }
 }

package/app/.next/required-server-files.json

@@ -295,12 +295,12 @@
     "htmlLimitedBots": "[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight",
     "bundlePagesRouterDependencies": false,
     "configFileName": "next.config.mjs",
-    "transpilePackages": [
-      "@omniroute/open-sse"
-    ],
     "turbopack": {
       "root": "/home/runner/work/OmniRoute/OmniRoute"
     },
+    "transpilePackages": [
+      "@omniroute/open-sse"
+    ],
     "distDirRoot": ".next",
     "_originalRewrites": {
       "beforeFiles": [],

package/app/.next/routes-manifest.json

@@ -409,6 +409,12 @@
       "routeKeys": {},
       "namedRegex": "^/api/pricing/defaults(?:/)?$"
     },
+    {
+      "page": "/api/pricing/models",
+      "regex": "^/api/pricing/models(?:/)?$",
+      "routeKeys": {},
+      "namedRegex": "^/api/pricing/models(?:/)?$"
+    },
     {
       "page": "/api/provider-models",
       "regex": "^/api/provider\\-models(?:/)?$",
@@ -457,12 +463,24 @@
       "routeKeys": {},
       "namedRegex": "^/api/rate\\-limit(?:/)?$"
     },
+    {
+      "page": "/api/rate-limits",
+      "regex": "^/api/rate\\-limits(?:/)?$",
+      "routeKeys": {},
+      "namedRegex": "^/api/rate\\-limits(?:/)?$"
+    },
     {
       "page": "/api/restart",
       "regex": "^/api/restart(?:/)?$",
       "routeKeys": {},
       "namedRegex": "^/api/restart(?:/)?$"
     },
+    {
+      "page": "/api/sessions",
+      "regex": "^/api/sessions(?:/)?$",
+      "routeKeys": {},
+      "namedRegex": "^/api/sessions(?:/)?$"
+    },
     {
       "page": "/api/settings",
       "regex": "^/api/settings(?:/)?$",
@@ -475,6 +493,12 @@
       "routeKeys": {},
       "namedRegex": "^/api/settings/combo\\-defaults(?:/)?$"
     },
+    {
+      "page": "/api/settings/ip-filter",
+      "regex": "^/api/settings/ip\\-filter(?:/)?$",
+      "routeKeys": {},
+      "namedRegex": "^/api/settings/ip\\-filter(?:/)?$"
+    },
     {
       "page": "/api/settings/proxy",
       "regex": "^/api/settings/proxy(?:/)?$",
@@ -493,6 +517,18 @@
       "routeKeys": {},
       "namedRegex": "^/api/settings/require\\-login(?:/)?$"
     },
+    {
+      "page": "/api/settings/system-prompt",
+      "regex": "^/api/settings/system\\-prompt(?:/)?$",
+      "routeKeys": {},
+      "namedRegex": "^/api/settings/system\\-prompt(?:/)?$"
+    },
+    {
+      "page": "/api/settings/thinking-budget",
+      "regex": "^/api/settings/thinking\\-budget(?:/)?$",
+      "routeKeys": {},
+      "namedRegex": "^/api/settings/thinking\\-budget(?:/)?$"
+    },
     {
       "page": "/api/shutdown",
       "regex": "^/api/shutdown(?:/)?$",